Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,164Letters: 84Defects: 3,898counted 3 min ago
teppi

Server definition

Hash
sha256:117bebb3186547b1ac5f2ac662d7610197f630d1a86353b3f7d303d18931fc46
What it is
What a remote MCP server returned when asked what it offers: 9 tools

The blob, as servednamed by its sha256

{ "instructions": "Screwtape.ai decides whether an AI agent is allowed to spend money, and keeps the proof. Call check_duplicate_invoice (Bearer key or x402 payment) before an agent pays an invoice or payment instruction: it returns duplicate.status (unique, duplicate, possible_duplicate, replay), runs the checks you pass (for example a sum check that line items add up to the total) and judges the invoice against your evidence, such as the purchase order. Pay only when next_step.action is pass; on escalate, do not pay. Every verdict carries a signed receipt as proof of why the money moved or did not. Use budget_ledger to reserve cumulative spend ($0.002); action_receipt signs an action record ($0.003). Use payment_check ($0.005) before paying a seller, to check the 402 payee and price. All six paid tools share 3 free calls per UTC day without a key plus 10/day with a free key. Anonymous: private daily IP namespace, 3/minute, global 2000/day. Free GET /v1/receipt/verify checks action receipts and /.well-known/screwtape-receipt-key publishes their key. Use judge on one draft answer before you return it (send evidence; it does not search the web). Use consensus when 2 to 16 answers to the same task agree and you are about to trust the majority. Use get_api_key only if no key is configured and you can compute SHA-256 in code. judge, check_duplicate_invoice and consensus cost one call each: a free key gives 10 per UTC day, or pay $0.005 USDC on Base or Solana with x402. After anonymous access is exhausted, an unpaid tools/call returns HTTP 200 with isError true and the x402 PaymentRequirements in structuredContent and result._meta['x402/payment-required']. Retry with params._meta['x402/payment']. Settlement is echoed in result._meta['x402/payment-response']. Judged content is not stored unless retain is true or the key owner turned on opt-in data sharing (off by default; redacted, kept 90 days). A successful judge or consensus result includes an Ed25519 receipt when signing is configured. Public keys are at https://screwtape.ai/.well-known/screwtape-receipt-keys.json. POST /v1/receipts/verify checks a receipt. publish_receipt publishes one receipt you own. It needs the Bearer key and does not accept x402.", "tools": [ { "description": "Action Receipts: Ed25519-signed, hash-chained attestation of an agent-reported action and status; not evidence the action happened or a legal compliance certification. Per caller and agent chain; concurrent appends serialize with compare-and-set. Raw action/reference are hashed, not stored. event_id per agent is the authoritative idempotency key; a custom HTTP key cannot override it. Same event_id/body returns the same receipt; changed body conflicts. Optional children (1-64 receipt UUIDs) closes a run: the signed children_root digests ordered child receipt_hash values so any added, dropped or swapped step fails verification. GET /v1/receipt/verify?id=<receipt_id> is free and returns the receipt to anyone who knows its unguessable ID; children_root_valid is set when children are present. A receipt proves the record is unchanged since issued, not that a payment was correct or an outside action happened. Or pass receipt=<JSON> to verify a portable receipt. Keep IDs private if your agent IDs/status are sensitive. Records persist until the API key is deleted; keyless records have no automatic expiry. $0.003 per call; shared 3 free calls per UTC day without a key (daily private IP namespace), plus 10/day with a free key. Anonymous scopes rotate daily; use a key for a persistent ledger/chain. Send the same Bearer key plus a payment header to keep the same ledger/chain after the allowance runs out.", "inputSchema": { "additionalProperties": false, "properties": { "action": { "maxLength": 8192, "minLength": 1, "type": "string" }, "action_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "agent_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "children": { "description": "Ordered child receipt ids. Signs children_root over their receipt_hash values so any added, dropped or swapped step fails verification.", "items": { "pattern": "^[0-9a-f-]{36}$", "type": "string" }, "maxItems": 64, "minItems": 1, "type": "array", "uniqueItems": true }, "event_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "reference": { "maxLength": 256, "type": "string" }, "status": { "enum": [ "requested", "succeeded", "failed", "paid_not_served" ] } }, "required": [ "agent_id", "event_id", "action", "status" ], "type": "object" }, "name": "action_receipt", "outputSchema": { "properties": { "keys_url": { "type": "string" }, "receipt": { "properties": { "action_sha256": { "type": "string" }, "agent_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "alg": { "const": "Ed25519" }, "chain": { "type": "string" }, "children": { "items": { "type": "string" }, "type": "array" }, "children_root": { "description": "SHA-256 of canonical JSON of ordered child receipt_hash values.", "type": "string" }, "event_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "issued_at": { "type": "string" }, "kid": { "type": "string" }, "previous_hash": { "type": [ "string", "null" ] }, "receipt_id": { "type": "string" }, "reference_sha256": { "type": "string" }, "schema": { "const": "screwtape-action-receipt-v1" }, "sequence": { "minimum": 1, "type": "integer" }, "signature": { "type": "string" }, "status": { "enum": [ "requested", "succeeded", "failed", "paid_not_served" ] } }, "required": [ "receipt_id", "agent_id", "sequence", "action_sha256", "previous_hash", "signature", "kid", "alg", "status", "issued_at", "chain", "event_id", "schema" ], "type": "object" }, "receipt_hash": { "type": "string" }, "replayed": { "type": "boolean" }, "request_id": { "type": "string" }, "verify_url": { "type": "string" } }, "required": [ "receipt", "receipt_hash", "verify_url", "keys_url" ], "type": "object" } }, { "description": "Budget Ledger: atomically reserves reported USD spend across a run and its sub-agents. Returns allow/warn/block, remaining budget, retry storms and spend velocity. Call judge first, then reserve immediately before spending; honor block. This is cooperative accounting, not payment enforcement. Root cap and parent are immutable. Children inherit the root cap (send the same cap). event_id is the authoritative idempotency key; a custom HTTP key cannot override it. New event_id per attempted action; same event_id and body replays without reserving twice. No refunds or cap resets. Warn reservations count as spend. Limits: USD, six decimals, cap at most 1000000. Three matching actions in 60 seconds allowed; fourth blocked. Velocity warning at ten attempts/minute or more than 25% of cap/minute; 80% usage warns. Use action to distinguish operations at a merchant. Stored: IDs, keyed fingerprints and amounts, not raw action/merchant. Records persist until the API key is deleted; keyless records have no automatic expiry. $0.002 per call; shared 3 free calls per UTC day without a key (daily private IP namespace), plus 10/day with a free key. Anonymous scopes rotate daily; use a key for a persistent ledger/chain. Send the same Bearer key plus a payment header to keep the same ledger/chain after the allowance runs out.", "inputSchema": { "additionalProperties": false, "properties": { "action": { "maxLength": 2048, "type": "string" }, "amount": { "maximum": 1000000, "minimum": 0, "multipleOf": 0.000001, "type": "number" }, "cap": { "exclusiveMinimum": 0, "maximum": 1000000, "minimum": 0, "multipleOf": 0.000001, "type": "number" }, "currency": { "const": "USD" }, "event_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "merchant": { "maxLength": 256, "minLength": 1, "type": "string" }, "parent_run_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "run_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" } }, "required": [ "run_id", "event_id", "amount", "cap", "merchant" ], "type": "object" }, "name": "budget_ledger", "outputSchema": { "properties": { "decision": { "enum": [ "allow", "warn", "block" ] }, "event_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "reasons": { "items": { "type": "string" }, "type": "array" }, "remaining_budget": { "type": "number" }, "replayed": { "type": "boolean" }, "request_id": { "type": "string" }, "reserved": { "type": "boolean" }, "retry_count": { "type": "integer" }, "root_run_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "run_id": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9._:-]+$", "type": "string" }, "spent": { "type": "number" }, "velocity_per_minute": { "type": "number" } }, "required": [ "decision", "remaining_budget", "reasons", "run_id", "root_run_id", "spent", "reserved" ], "type": "object" } }, { "description": "Spend gate for invoices: decides whether an agent may pay this invoice, with a signed receipt as proof. Same as judge with one duplicate check: it compares this invoice with the invoices this caller recorded earlier and also judges it. Call it before an agent pays or approves an invoice or payment instruction. Inputs: the judge inputs (task, agent_output as the invoice JSON, evidence, criteria, checks, mode, tags) plus duplicate {vendor_path, invoice_id_path, amount_path, currency_path?, date_path?, payee_account_path?, accept_payee_change?, window_days?, store?, retain_days?}. Returns the judge result plus duplicate.status (unique, duplicate, possible_duplicate, replay or not_checked). On duplicate or possible_duplicate, next_step.action is escalate: do not pay. Fingerprints are kept per caller; only keyed HMAC fingerprints are stored, and only when store is true. Cost: 1 call, the same as judge. First 3 calls per UTC day need no key (daily private IP namespace). Then use Authorization: Bearer <key>, or a per-call payment in params._meta with no key (records are kept per payer; an unverified payment returns the payment requirements again). A free key covers 10 calls per UTC day (get_api_key or https://screwtape.ai/signup/). After the shared 3/day anonymous allowance (3/minute, global 2000/day), tools/call without a key or payment is HTTP 200 with isError true and the payment requirements in structuredContent.", "inputSchema": { "additionalProperties": false, "properties": { "agent_id": { "description": "Optional tag for the agent making this call. 1 to 64 characters: letters, digits, and . _ : -. This is not the per-answer agent_id on a consensus answer.", "maxLength": 64, "pattern": "^[A-Za-z0-9._:-]{1,64}$", "type": "string" }, "agent_output": { "description": "The invoice or payment instruction the agent is about to pay, as a JSON string.", "type": "string" }, "checks": { "description": "Optional. The worker runs each check. A failed check forces verdict fail. Types include url_contains, json_schema, equals, regex, numeric, required_fields, types, format, sum and duplicate. duplicate (at most 1) compares an invoice with ones this caller recorded earlier and stores keyed fingerprints only when store is true. At most 3 url_contains checks. Local checks run first; if one fails, no model is called and next_step says what to fix.", "items": { "oneOf": [ { "additionalProperties": false, "properties": { "paths": { "items": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "type": { "const": "required_fields" } }, "required": [ "type", "paths" ], "type": "object" }, { "additionalProperties": false, "properties": { "fields": { "additionalProperties": { "enum": [ "string", "number", "integer", "boolean", "object", "array", "null" ] }, "maxProperties": 50, "minProperties": 1, "type": "object" }, "type": { "const": "types" } }, "required": [ "type", "fields" ], "type": "object" }, { "additionalProperties": false, "properties": { "field": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "format": { "enum": [ "email", "iso_date", "iso_datetime", "url", "uuid", "e164_phone", "currency_code", "integer_string" ] }, "type": { "const": "format" } }, "required": [ "type", "field", "format" ], "type": "object" }, { "additionalProperties": false, "properties": { "parts": { "items": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "tolerance": { "default": 0.0001, "maximum": 1000000, "minimum": 0, "type": "number" }, "total": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "type": { "const": "sum" } }, "required": [ "type", "parts", "total" ], "type": "object" }, { "additionalProperties": false, "description": "Duplicate invoice check (needs an API key, at most 1 per call). Compares this invoice with ones the same key recorded earlier. Stores keyed HMAC fingerprints only, and only when store is true.", "properties": { "accept_payee_change": { "description": "Set after a person confirmed a changed payee account. With store true, the new account becomes the vendor's recorded account.", "type": "boolean" }, "amount_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "currency_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "date_path": { "description": "Dot path to a YYYY-MM-DD invoice date. Enables the same vendor, amount and date rule. Without it, the same vendor, amount and currency within 30 days is possible_duplicate.", "maxLength": 128, "minLength": 1, "type": "string" }, "invoice_id_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "payee_account_path": { "description": "Dot path to the bank or payee account (IBAN, account number, PayPal email). Remembered per vendor as a keyed HMAC; a different account escalates with payee_account_changed.", "maxLength": 128, "minLength": 1, "type": "string" }, "retain_days": { "default": 180, "maximum": 400, "minimum": 1, "type": "integer" }, "store": { "default": false, "description": "Record this invoice's fingerprints so later calls can match it.", "type": "boolean" }, "type": { "const": "duplicate" }, "vendor_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "window_days": { "default": 3, "maximum": 30, "minimum": 0, "type": "integer" } }, "required": [ "type", "vendor_path", "invoice_id_path", "amount_path" ], "type": "object" }, { "description": "Other check types, unchanged from 1.0. See https://screwtape.ai/openapi.json.", "properties": { "type": { "enum": [ "url_contains", "json_schema", "equals", "regex", "numeric", "onchain" ] } }, "required": [ "type" ], "type": "object" } ] }, "maxItems": 8, "type": "array" }, "criteria": { "description": "Optional. Facts or terms the answer must contain, one per string.", "items": { "type": "string" }, "type": "array" }, "duplicate": { "additionalProperties": false, "description": "The duplicate check: dot paths into agent_output for vendor, invoice id and amount, plus optional currency_path, date_path, payee_account_path, accept_payee_change, window_days, store and retain_days. payee_account_path remembers the vendor's bank or payee account; a change escalates with payee_account_changed. store true records this invoice's keyed fingerprints so later calls can match it.", "properties": { "accept_payee_change": { "description": "Set after a person confirmed a changed payee account. With store true, the new account becomes the vendor's recorded account.", "type": "boolean" }, "amount_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "currency_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "date_path": { "description": "Dot path to a YYYY-MM-DD invoice date. Enables the same vendor, amount and date rule. Without it, the same vendor, amount and currency within 30 days is possible_duplicate.", "maxLength": 128, "minLength": 1, "type": "string" }, "invoice_id_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "payee_account_path": { "description": "Dot path to the bank or payee account (IBAN, account number, PayPal email). Remembered per vendor as a keyed HMAC; a different account escalates with payee_account_changed.", "maxLength": 128, "minLength": 1, "type": "string" }, "retain_days": { "default": 180, "maximum": 400, "minimum": 1, "type": "integer" }, "store": { "default": false, "description": "Record this invoice's fingerprints so later calls can match it.", "type": "boolean" }, "type": { "const": "duplicate" }, "vendor_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "window_days": { "default": 3, "maximum": 30, "minimum": 0, "type": "integer" } }, "required": [ "vendor_path", "invoice_id_path", "amount_path" ], "type": "object" }, "evidence": { "description": "Optional. Source passages the answer must be grounded in, one string per passage. Without evidence, grounding cannot be checked.", "items": { "type": "string" }, "type": "array" }, "mode": { "description": "Optional. blocking (the default) is today's behaviour. advisory computes the same verdict, checks, next_step and receipt, then adds mode, decision_owner human, recommended_action (approve, review or return) and a notice. The receipt signs mode advisory as schema_version 5. Same price.", "enum": [ "blocking", "advisory" ], "type": "string" }, "retain": { "description": "Optional. true stores this call for 24 hours; requires an API key. Default false stores nothing.", "type": "boolean" }, "share": { "description": "Optional. false keeps this call out of opt-in data sharing even when the key has sharing on. It cannot turn sharing on.", "type": "boolean" }, "task": { "description": "The original instruction or question the agent was answering.", "type": "string" }, "version": { "description": "Optional version tag for that agent. At most 64 characters.", "maxLength": 64, "type": "string" } }, "required": [ "task", "agent_output", "duplicate" ], "type": "object" }, "name": "check_duplicate_invoice", "outputSchema": { "properties": { "agent_id": { "description": "Echoed when the call sent an agent_id tag.", "type": "string" }, "checks": { "type": "array" }, "claims": { "type": "array" }, "decision_owner": { "description": "Advisory only. A person owns the decision.", "enum": [ "human" ], "type": "string" }, "degraded": { "type": "object" }, "duplicate": { "description": "Present only when the call sent a duplicate check. status is unique, duplicate, possible_duplicate, replay or not_checked. Carries no invoice data.", "type": "object" }, "engine": { "description": "groq, workers_ai, deterministic, or demo. Also signed into the receipt.", "type": "string" }, "fail_closed": { "description": "Present and true only when a finance check failed closed because the primary model was unavailable. Treat it as review.", "type": "boolean" }, "mode": { "description": "Present only when the call sent mode: advisory.", "enum": [ "advisory" ], "type": "string" }, "model": { "type": [ "string", "null" ] }, "next_step": { "additionalProperties": false, "properties": { "action": { "description": "pass: use the output. retry: fix it using hint and call again. escalate: stop and hand to a person.", "enum": [ "pass", "retry", "escalate" ], "type": "string" }, "error_type": { "enum": [ "none", "invalid_json", "not_an_object", "missing_required_field", "type_mismatch", "format_mismatch", "sum_mismatch", "check_failed", "external_check_failed", "duplicate_invoice", "possible_duplicate", "payee_account_changed", "document_too_large", "quality_issue", "contradicted_claims", "rejected", "low_confidence", "unverifiable", "false_consensus_risk", "primary_engine_unavailable" ], "type": "string" }, "hint": { "description": "Template text naming fields and types to fix. Never contains values from agent_output.", "maxLength": 300, "type": "string" } }, "required": [ "action", "error_type", "hint" ], "type": "object" }, "notice": { "description": "Advisory only. Fixed text: the call does not approve, hold or release any payment.", "type": "string" }, "reasons": { "items": { "type": "string" }, "type": "array" }, "receipt": { "additionalProperties": false, "properties": { "agent_id": { "description": "Present when the call sent an agent_id tag. Omitted otherwise. Older receipts omit it.", "type": "string" }, "alg": { "enum": [ "Ed25519" ], "type": "string" }, "checks": { "description": "Type, passed, and evidence_hash only. Fetched content is not stored.", "items": { "additionalProperties": false, "properties": { "evidence_hash": { "type": "string" }, "passed": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "type", "passed", "evidence_hash" ], "type": "object" }, "type": "array" }, "claims": { "additionalProperties": false, "properties": { "contradicted": { "type": "integer" }, "supported": { "type": "integer" }, "total": { "type": "integer" }, "unsupported": { "type": "integer" } }, "required": [ "total", "supported", "contradicted", "unsupported" ], "type": "object" }, "endpoint": { "enum": [ "/v1/judge", "/v1/consensus" ], "type": "string" }, "engine": { "description": "groq, workers_ai, deterministic, or demo. Present on schema 3 and 4.", "type": "string" }, "issued_at": { "description": "ISO-8601 UTC timestamp.", "type": "string" }, "kid": { "type": "string" }, "mode": { "description": "Present only on schema 5 and 8: the call was advisory, so a person, not the API, owned the decision. Blocking receipts omit it.", "enum": [ "advisory" ], "type": "string" }, "model": { "description": "Present only on schema 7 and 8: the model id the provider echoed back for this verdict. Signed, so a changed model id fails verification.", "type": "string" }, "payment": { "additionalProperties": false, "description": "How the call was paid. free-key and prepaid are the label only on schema 4; schema 3 may include the key display prefix, never the secret. demo is the /try/ allowance. Other paid calls may add tx, network and payer.", "properties": { "key_prefix": { "description": "Present on schema 3 free-key and prepaid payments. Omitted on schema 4. Never the secret.", "type": "string" }, "network": { "type": "string" }, "payer": { "type": "string" }, "tx": { "description": "Settled transaction id, or the accepted payment nonce when nothing was settled.", "type": "string" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }, "receipt_id": { "type": "string" }, "request_sha256": { "description": "Lowercase hex SHA-256 of the canonical JSON of the normalized request. Judge requests include task, agent_output, evidence, and criteria. Consensus requests include task and answers, plus evidence when it was sent. agent_id and version tags are signed separately and are not part of this hash.", "type": "string" }, "schema_version": { "description": "7 is schema 4 plus a signed model id, and 8 is schema 5 plus a signed model id: minted when a model gave the verdict. 5 is schema 4 plus a signed mode advisory, minted only for mode: advisory calls. 4 omits key_prefix from payment so a published receipt verifies without key info. 3 adds verification, engine, checks (type, passed, and evidence_hash only), and a claims count, and may include key_prefix. 2 can carry agent_id and version. Older receipts omit this field and still verify.", "enum": [ 2, 3, 4, 5, 7, 8 ], "type": "integer" }, "score": { "description": "Judge score from 0 to 1. For consensus this is agreement_score.", "type": "number" }, "signature": { "description": "Unpadded base64url Ed25519 signature over the canonical JSON of every field except signature.", "type": "string" }, "verdict": { "description": "Judge verdict (pass, fail, or retry). For consensus this is false_consensus_risk (low, medium, or high).", "type": "string" }, "verification": { "description": "verified when a check of the answer passed. judged when a model checked it and did not contradict it. heuristic when only string checks ran. failed when the agreed answer failed verification.", "enum": [ "verified", "judged", "heuristic", "failed" ], "type": "string" }, "version": { "description": "Present when the call sent a version tag. Omitted otherwise. Older receipts omit it.", "type": "string" } }, "required": [ "receipt_id", "issued_at", "endpoint", "request_sha256", "verdict", "score", "payment", "alg", "kid", "signature" ], "type": [ "object", "null" ] }, "receipt_reason": { "type": "string" }, "recommended_action": { "description": "Advisory only, deterministic and not signed. Judge: next_step pass is approve, escalate is review, retry is return (send back to the agent). Consensus: risk low is approve, medium or high is review.", "enum": [ "approve", "review", "return" ], "type": "string" }, "request_id": { "type": "string" }, "retention": { "type": "object" }, "score": { "description": "null when no model gave a verdict (degraded).", "type": [ "number", "null" ] }, "verdict": { "enum": [ "pass", "fail", "retry" ], "type": "string" }, "verification": { "enum": [ "verified", "judged", "heuristic", "failed" ], "type": "string" }, "version": { "description": "Echoed when the call sent a version tag.", "type": "string" } }, "required": [ "verdict", "score", "reasons", "request_id" ], "type": "object" } }, { "description": "False-consensus check for 2 to 16 answers to the same task, so a group of agents does not approve a spend just because they copied each other. It scores how the answers agree and flags agreement that looks copied or too thin to trust. Screwtape is not tied to the agent framework or the model that wrote the answers. Call it when several agents, samples or tools answered the same question and you are about to accept the majority. Do NOT call it with a single answer (use judge), with answers to different tasks, or as proof that an answer is correct: high agreement is not evidence. Inputs: task, answers (2 to 16 objects {agent_id?: string, output: string}), optional evidence (a string or an array of strings, used when scoring), retain, and optional call-level agent_id and version tags. The call-level agent_id is not the per-answer agent_id. Returns: consensus_answer, agreement_score, false_consensus_risk (low, medium or high), reasons, clusters, engine, request_id, retention, the tags when sent, and receipt when signing is configured. In that receipt, verdict is false_consensus_risk and score is agreement_score. If the risk is medium or high, verify consensus_answer with judge before using it. next_step.action is pass for low risk and escalate otherwise. Cost: 1 call. First 3 calls per UTC day need no key; then use Authorization: Bearer <key> or pay per call. A free key covers 10 calls per UTC day (get_api_key or https://screwtape.ai/signup/). After the shared 3/day anonymous allowance (3/minute, global 2000/day), tools/call without a key or payment is HTTP 200 with isError true and the payment requirements in structuredContent.", "inputSchema": { "additionalProperties": false, "properties": { "agent_id": { "description": "Optional tag for the agent making this call. 1 to 64 characters: letters, digits, and . _ : -. This is not the per-answer agent_id on a consensus answer.", "maxLength": 64, "pattern": "^[A-Za-z0-9._:-]{1,64}$", "type": "string" }, "answers": { "description": "2 to 16 answers. Each is {agent_id (optional, string), output (string)}. Use one entry per agent or sample.", "items": { "properties": { "agent_id": { "description": "Optional name of the agent or sample that produced this answer.", "type": "string" }, "output": { "description": "That agent's answer.", "type": "string" } }, "required": [ "output" ], "type": "object" }, "maxItems": 16, "minItems": 2, "type": "array" }, "evidence": { "description": "Optional passages the agreed answer should be grounded in. A string is one passage. An array holds up to 20 passages of 4000 characters. Used when scoring false-consensus risk.", "oneOf": [ { "maxLength": 4000, "type": "string" }, { "items": { "maxLength": 4000, "type": "string" }, "maxItems": 20, "type": "array" } ] }, "mode": { "description": "Optional. blocking (the default) is today's behaviour. advisory computes the same verdict, checks, next_step and receipt, then adds mode, decision_owner human, recommended_action (approve, review or return) and a notice. The receipt signs mode advisory as schema_version 5. Same price.", "enum": [ "blocking", "advisory" ], "type": "string" }, "retain": { "description": "Optional. true stores this call for 24 hours; requires an API key. Default false.", "type": "boolean" }, "share": { "description": "Optional. false keeps this call out of opt-in data sharing even when the key has sharing on. It cannot turn sharing on.", "type": "boolean" }, "task": { "description": "The question all answers respond to.", "type": "string" }, "version": { "description": "Optional version tag for that agent. At most 64 characters.", "maxLength": 64, "type": "string" } }, "required": [ "task", "answers" ], "type": "object" }, "name": "consensus", "outputSchema": { "properties": { "agent_id": { "description": "Echoed when the call sent an agent_id tag. Not the per-answer agent_id.", "type": "string" }, "agreement_score": { "description": "null when no model scored agreement (degraded).", "type": [ "number", "null" ] }, "clusters": { "type": "array" }, "consensus_answer": { "type": "string" }, "decision_owner": { "description": "Advisory only. A person owns the decision.", "enum": [ "human" ], "type": "string" }, "degraded": { "type": "object" }, "engine": { "description": "groq, workers_ai, deterministic, or demo.", "type": "string" }, "false_consensus_risk": { "enum": [ "low", "medium", "high" ], "type": "string" }, "mode": { "description": "Present only when the call sent mode: advisory.", "enum": [ "advisory" ], "type": "string" }, "model": { "type": [ "string", "null" ] }, "next_step": { "additionalProperties": false, "properties": { "action": { "description": "pass: use the output. retry: fix it using hint and call again. escalate: stop and hand to a person.", "enum": [ "pass", "retry", "escalate" ], "type": "string" }, "error_type": { "enum": [ "none", "invalid_json", "not_an_object", "missing_required_field", "type_mismatch", "format_mismatch", "sum_mismatch", "check_failed", "external_check_failed", "duplicate_invoice", "possible_duplicate", "payee_account_changed", "document_too_large", "quality_issue", "contradicted_claims", "rejected", "low_confidence", "unverifiable", "false_consensus_risk", "primary_engine_unavailable" ], "type": "string" }, "hint": { "description": "Template text naming fields and types to fix. Never contains values from agent_output.", "maxLength": 300, "type": "string" } }, "required": [ "action", "error_type", "hint" ], "type": "object" }, "notice": { "description": "Advisory only. Fixed text: the call does not approve, hold or release any payment.", "type": "string" }, "reasons": { "items": { "type": "string" }, "type": "array" }, "receipt": { "additionalProperties": false, "properties": { "agent_id": { "description": "Present when the call sent an agent_id tag. Omitted otherwise. Older receipts omit it.", "type": "string" }, "alg": { "enum": [ "Ed25519" ], "type": "string" }, "checks": { "description": "Type, passed, and evidence_hash only. Fetched content is not stored.", "items": { "additionalProperties": false, "properties": { "evidence_hash": { "type": "string" }, "passed": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "type", "passed", "evidence_hash" ], "type": "object" }, "type": "array" }, "claims": { "additionalProperties": false, "properties": { "contradicted": { "type": "integer" }, "supported": { "type": "integer" }, "total": { "type": "integer" }, "unsupported": { "type": "integer" } }, "required": [ "total", "supported", "contradicted", "unsupported" ], "type": "object" }, "endpoint": { "enum": [ "/v1/judge", "/v1/consensus" ], "type": "string" }, "engine": { "description": "groq, workers_ai, deterministic, or demo. Present on schema 3 and 4.", "type": "string" }, "issued_at": { "description": "ISO-8601 UTC timestamp.", "type": "string" }, "kid": { "type": "string" }, "mode": { "description": "Present only on schema 5 and 8: the call was advisory, so a person, not the API, owned the decision. Blocking receipts omit it.", "enum": [ "advisory" ], "type": "string" }, "model": { "description": "Present only on schema 7 and 8: the model id the provider echoed back for this verdict. Signed, so a changed model id fails verification.", "type": "string" }, "payment": { "additionalProperties": false, "description": "How the call was paid. free-key and prepaid are the label only on schema 4; schema 3 may include the key display prefix, never the secret. demo is the /try/ allowance. Other paid calls may add tx, network and payer.", "properties": { "key_prefix": { "description": "Present on schema 3 free-key and prepaid payments. Omitted on schema 4. Never the secret.", "type": "string" }, "network": { "type": "string" }, "payer": { "type": "string" }, "tx": { "description": "Settled transaction id, or the accepted payment nonce when nothing was settled.", "type": "string" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }, "receipt_id": { "type": "string" }, "request_sha256": { "description": "Lowercase hex SHA-256 of the canonical JSON of the normalized request. Judge requests include task, agent_output, evidence, and criteria. Consensus requests include task and answers, plus evidence when it was sent. agent_id and version tags are signed separately and are not part of this hash.", "type": "string" }, "schema_version": { "description": "7 is schema 4 plus a signed model id, and 8 is schema 5 plus a signed model id: minted when a model gave the verdict. 5 is schema 4 plus a signed mode advisory, minted only for mode: advisory calls. 4 omits key_prefix from payment so a published receipt verifies without key info. 3 adds verification, engine, checks (type, passed, and evidence_hash only), and a claims count, and may include key_prefix. 2 can carry agent_id and version. Older receipts omit this field and still verify.", "enum": [ 2, 3, 4, 5, 7, 8 ], "type": "integer" }, "score": { "description": "Judge score from 0 to 1. For consensus this is agreement_score.", "type": "number" }, "signature": { "description": "Unpadded base64url Ed25519 signature over the canonical JSON of every field except signature.", "type": "string" }, "verdict": { "description": "Judge verdict (pass, fail, or retry). For consensus this is false_consensus_risk (low, medium, or high).", "type": "string" }, "verification": { "description": "verified when a check of the answer passed. judged when a model checked it and did not contradict it. heuristic when only string checks ran. failed when the agreed answer failed verification.", "enum": [ "verified", "judged", "heuristic", "failed" ], "type": "string" }, "version": { "description": "Present when the call sent a version tag. Omitted otherwise. Older receipts omit it.", "type": "string" } }, "required": [ "receipt_id", "issued_at", "endpoint", "request_sha256", "verdict", "score", "payment", "alg", "kid", "signature" ], "type": [ "object", "null" ] }, "receipt_reason": { "type": "string" }, "recommended_action": { "description": "Advisory only, deterministic and not signed. Judge: next_step pass is approve, escalate is review, retry is return (send back to the agent). Consensus: risk low is approve, medium or high is review.", "enum": [ "approve", "review", "return" ], "type": "string" }, "request_id": { "type": "string" }, "retention": { "type": "object" }, "unsupported_agreement": { "type": "boolean" }, "verification": { "enum": [ "verified", "judged", "heuristic", "failed" ], "type": "string" }, "version": { "description": "Echoed when the call sent a version tag.", "type": "string" } }, "required": [ "agreement_score", "false_consensus_risk", "reasons", "request_id" ], "type": "object" } }, { "description": "Create a free Screwtape.ai API key (10 calls per UTC day) with no human approval. Call it only when no Screwtape key is configured and you can compute SHA-256 with a code tool, because the proof of work must be computed exactly, not guessed. Do NOT call it when a key already exists, to get more quota (it is limited to 5 keys per IP per hour and per UTC day), or without a valid pow_nonce. A missing nonce returns an error that describes the challenge. Inputs: pow_nonce (required string matching ^[A-Za-z0-9_-]{8,64}$; SHA-256 of the UTF-8 string screwtape-signup-v1:<current UTC YYYY-MM-DD>:<nonce> must start with 12 zero bits, which is 3 hex zeros), email (optional), name (optional, at most 80 characters). Returns: api_key (shown once; store it securely and send it as Authorization: Bearer), key metadata and request_id. Only the key's SHA-256 hash is stored. Cost: free. Needs no key and no payment.", "inputSchema": { "additionalProperties": false, "properties": { "data_sharing": { "description": "Optional, off by default. Only true turns on opt-in data sharing for the new key: redacted samples of its calls are kept 90 days. Turn it off anytime with PATCH /v1/keys/me/data-sharing. See https://screwtape.ai/privacy/#opt-in-data-sharing.", "type": "boolean" }, "email": { "description": "Optional. Omit it to store no email.", "type": "string" }, "name": { "description": "Optional agent or client name, at most 80 characters.", "maxLength": 80, "type": "string" }, "pow_nonce": { "description": "Required. SHA-256 of the UTF-8 string screwtape-signup-v1:YYYY-MM-DD:<nonce> must have 12 leading zero bits. Nonce matches ^[A-Za-z0-9_-]{8,64}$. YYYY-MM-DD is the UTC day.", "type": "string" } }, "required": [ "pow_nonce" ], "type": "object" }, "name": "get_api_key", "outputSchema": { "properties": { "api_key": { "type": "string" }, "key": { "type": "object" }, "request_id": { "type": "string" } }, "required": [ "api_key", "key", "request_id" ], "type": "object" } }, { "description": "A pass/fail/retry verdict on ONE agent output, from a service outside your agent, used as the go/no-go before an agent spends money or acts on that output. Call it before you pay on, return, store or act on a draft answer, especially when you have the evidence the answer should be based on. Do NOT call it to look up facts (it does no web search and only checks against the evidence you pass), to compare several agents' answers (use consensus), or for offline evaluation over a dataset. Inputs: task, agent_output, evidence, criteria, retain, and optional agent_id and version tags. Returns: verdict, score, reasons, engine, next_step, request_id, retention, the tags when sent, and receipt when signing is configured. On pass, use the output. On retry, revise using reasons and call again, at most 2 or 3 times. On fail, stop. Optional checks run first; on failure you get next_step.hint saying what to fix. Branch on next_step.action (pass, retry or escalate). Cost: 1 call. First 3 calls per UTC day need no key; then use Authorization: Bearer <key> or pay per call. A free key covers 10 calls per UTC day (get_api_key or https://screwtape.ai/signup/). After the shared 3/day anonymous allowance (3/minute, global 2000/day), tools/call without a key or payment is HTTP 200 with isError true and the payment requirements in structuredContent.", "inputSchema": { "additionalProperties": false, "properties": { "agent_id": { "description": "Optional tag for the agent making this call. 1 to 64 characters: letters, digits, and . _ : -. This is not the per-answer agent_id on a consensus answer.", "maxLength": 64, "pattern": "^[A-Za-z0-9._:-]{1,64}$", "type": "string" }, "agent_output": { "description": "The agent's draft answer to check. Pass JSON as a string.", "type": "string" }, "checks": { "description": "Optional. The worker runs each check. A failed check forces verdict fail. Types include url_contains, json_schema, equals, regex, numeric, required_fields, types, format, sum and duplicate. duplicate (at most 1) compares an invoice with ones this caller recorded earlier and stores keyed fingerprints only when store is true. At most 3 url_contains checks. Local checks run first; if one fails, no model is called and next_step says what to fix.", "items": { "oneOf": [ { "additionalProperties": false, "properties": { "paths": { "items": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "type": { "const": "required_fields" } }, "required": [ "type", "paths" ], "type": "object" }, { "additionalProperties": false, "properties": { "fields": { "additionalProperties": { "enum": [ "string", "number", "integer", "boolean", "object", "array", "null" ] }, "maxProperties": 50, "minProperties": 1, "type": "object" }, "type": { "const": "types" } }, "required": [ "type", "fields" ], "type": "object" }, { "additionalProperties": false, "properties": { "field": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "format": { "enum": [ "email", "iso_date", "iso_datetime", "url", "uuid", "e164_phone", "currency_code", "integer_string" ] }, "type": { "const": "format" } }, "required": [ "type", "field", "format" ], "type": "object" }, { "additionalProperties": false, "properties": { "parts": { "items": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "tolerance": { "default": 0.0001, "maximum": 1000000, "minimum": 0, "type": "number" }, "total": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "type": { "const": "sum" } }, "required": [ "type", "parts", "total" ], "type": "object" }, { "additionalProperties": false, "description": "Duplicate invoice check (needs an API key, at most 1 per call). Compares this invoice with ones the same key recorded earlier. Stores keyed HMAC fingerprints only, and only when store is true.", "properties": { "accept_payee_change": { "description": "Set after a person confirmed a changed payee account. With store true, the new account becomes the vendor's recorded account.", "type": "boolean" }, "amount_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "currency_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "date_path": { "description": "Dot path to a YYYY-MM-DD invoice date. Enables the same vendor, amount and date rule. Without it, the same vendor, amount and currency within 30 days is possible_duplicate.", "maxLength": 128, "minLength": 1, "type": "string" }, "invoice_id_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "payee_account_path": { "description": "Dot path to the bank or payee account (IBAN, account number, PayPal email). Remembered per vendor as a keyed HMAC; a different account escalates with payee_account_changed.", "maxLength": 128, "minLength": 1, "type": "string" }, "retain_days": { "default": 180, "maximum": 400, "minimum": 1, "type": "integer" }, "store": { "default": false, "description": "Record this invoice's fingerprints so later calls can match it.", "type": "boolean" }, "type": { "const": "duplicate" }, "vendor_path": { "description": "Dot path into the output JSON, at most 8 segments, e.g. invoice.total or items.0.id.", "maxLength": 128, "minLength": 1, "type": "string" }, "window_days": { "default": 3, "maximum": 30, "minimum": 0, "type": "integer" } }, "required": [ "type", "vendor_path", "invoice_id_path", "amount_path" ], "type": "object" }, { "description": "Other check types, unchanged from 1.0. See https://screwtape.ai/openapi.json.", "properties": { "type": { "enum": [ "url_contains", "json_schema", "equals", "regex", "numeric", "onchain" ] } }, "required": [ "type" ], "type": "object" } ] }, "maxItems": 8, "type": "array" }, "criteria": { "description": "Optional. Facts or terms the answer must contain, one per string.", "items": { "type": "string" }, "type": "array" }, "evidence": { "description": "Optional. Source passages the answer must be grounded in, one string per passage. Without evidence, grounding cannot be checked.", "items": { "type": "string" }, "type": "array" }, "mode": { "description": "Optional. blocking (the default) is today's behaviour. advisory computes the same verdict, checks, next_step and receipt, then adds mode, decision_owner human, recommended_action (approve, review or return) and a notice. The receipt signs mode advisory as schema_version 5. Same price.", "enum": [ "blocking", "advisory" ], "type": "string" }, "retain": { "description": "Optional. true stores this call for 24 hours; requires an API key. Default false stores nothing.", "type": "boolean" }, "share": { "description": "Optional. false keeps this call out of opt-in data sharing even when the key has sharing on. It cannot turn sharing on.", "type": "boolean" }, "task": { "description": "The original instruction or question the agent was answering.", "type": "string" }, "version": { "description": "Optional version tag for that agent. At most 64 characters.", "maxLength": 64, "type": "string" } }, "required": [ "task", "agent_output" ], "type": "object" }, "name": "judge", "outputSchema": { "properties": { "agent_id": { "description": "Echoed when the call sent an agent_id tag.", "type": "string" }, "checks": { "type": "array" }, "claims": { "type": "array" }, "decision_owner": { "description": "Advisory only. A person owns the decision.", "enum": [ "human" ], "type": "string" }, "degraded": { "type": "object" }, "duplicate": { "description": "Present only when the call sent a duplicate check. status is unique, duplicate, possible_duplicate, replay or not_checked. Carries no invoice data.", "type": "object" }, "engine": { "description": "groq, workers_ai, deterministic, or demo. Also signed into the receipt.", "type": "string" }, "fail_closed": { "description": "Present and true only when a finance check failed closed because the primary model was unavailable. Treat it as review.", "type": "boolean" }, "mode": { "description": "Present only when the call sent mode: advisory.", "enum": [ "advisory" ], "type": "string" }, "model": { "type": [ "string", "null" ] }, "next_step": { "additionalProperties": false, "properties": { "action": { "description": "pass: use the output. retry: fix it using hint and call again. escalate: stop and hand to a person.", "enum": [ "pass", "retry", "escalate" ], "type": "string" }, "error_type": { "enum": [ "none", "invalid_json", "not_an_object", "missing_required_field", "type_mismatch", "format_mismatch", "sum_mismatch", "check_failed", "external_check_failed", "duplicate_invoice", "possible_duplicate", "payee_account_changed", "document_too_large", "quality_issue", "contradicted_claims", "rejected", "low_confidence", "unverifiable", "false_consensus_risk", "primary_engine_unavailable" ], "type": "string" }, "hint": { "description": "Template text naming fields and types to fix. Never contains values from agent_output.", "maxLength": 300, "type": "string" } }, "required": [ "action", "error_type", "hint" ], "type": "object" }, "notice": { "description": "Advisory only. Fixed text: the call does not approve, hold or release any payment.", "type": "string" }, "reasons": { "items": { "type": "string" }, "type": "array" }, "receipt": { "additionalProperties": false, "properties": { "agent_id": { "description": "Present when the call sent an agent_id tag. Omitted otherwise. Older receipts omit it.", "type": "string" }, "alg": { "enum": [ "Ed25519" ], "type": "string" }, "checks": { "description": "Type, passed, and evidence_hash only. Fetched content is not stored.", "items": { "additionalProperties": false, "properties": { "evidence_hash": { "type": "string" }, "passed": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "type", "passed", "evidence_hash" ], "type": "object" }, "type": "array" }, "claims": { "additionalProperties": false, "properties": { "contradicted": { "type": "integer" }, "supported": { "type": "integer" }, "total": { "type": "integer" }, "unsupported": { "type": "integer" } }, "required": [ "total", "supported", "contradicted", "unsupported" ], "type": "object" }, "endpoint": { "enum": [ "/v1/judge", "/v1/consensus" ], "type": "string" }, "engine": { "description": "groq, workers_ai, deterministic, or demo. Present on schema 3 and 4.", "type": "string" }, "issued_at": { "description": "ISO-8601 UTC timestamp.", "type": "string" }, "kid": { "type": "string" }, "mode": { "description": "Present only on schema 5 and 8: the call was advisory, so a person, not the API, owned the decision. Blocking receipts omit it.", "enum": [ "advisory" ], "type": "string" }, "model": { "description": "Present only on schema 7 and 8: the model id the provider echoed back for this verdict. Signed, so a changed model id fails verification.", "type": "string" }, "payment": { "additionalProperties": false, "description": "How the call was paid. free-key and prepaid are the label only on schema 4; schema 3 may include the key display prefix, never the secret. demo is the /try/ allowance. Other paid calls may add tx, network and payer.", "properties": { "key_prefix": { "description": "Present on schema 3 free-key and prepaid payments. Omitted on schema 4. Never the secret.", "type": "string" }, "network": { "type": "string" }, "payer": { "type": "string" }, "tx": { "description": "Settled transaction id, or the accepted payment nonce when nothing was settled.", "type": "string" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }, "receipt_id": { "type": "string" }, "request_sha256": { "description": "Lowercase hex SHA-256 of the canonical JSON of the normalized request. Judge requests include task, agent_output, evidence, and criteria. Consensus requests include task and answers, plus evidence when it was sent. agent_id and version tags are signed separately and are not part of this hash.", "type": "string" }, "schema_version": { "description": "7 is schema 4 plus a signed model id, and 8 is schema 5 plus a signed model id: minted when a model gave the verdict. 5 is schema 4 plus a signed mode advisory, minted only for mode: advisory calls. 4 omits key_prefix from payment so a published receipt verifies without key info. 3 adds verification, engine, checks (type, passed, and evidence_hash only), and a claims count, and may include key_prefix. 2 can carry agent_id and version. Older receipts omit this field and still verify.", "enum": [ 2, 3, 4, 5, 7, 8 ], "type": "integer" }, "score": { "description": "Judge score from 0 to 1. For consensus this is agreement_score.", "type": "number" }, "signature": { "description": "Unpadded base64url Ed25519 signature over the canonical JSON of every field except signature.", "type": "string" }, "verdict": { "description": "Judge verdict (pass, fail, or retry). For consensus this is false_consensus_risk (low, medium, or high).", "type": "string" }, "verification": { "description": "verified when a check of the answer passed. judged when a model checked it and did not contradict it. heuristic when only string checks ran. failed when the agreed answer failed verification.", "enum": [ "verified", "judged", "heuristic", "failed" ], "type": "string" }, "version": { "description": "Present when the call sent a version tag. Omitted otherwise. Older receipts omit it.", "type": "string" } }, "required": [ "receipt_id", "issued_at", "endpoint", "request_sha256", "verdict", "score", "payment", "alg", "kid", "signature" ], "type": [ "object", "null" ] }, "receipt_reason": { "type": "string" }, "recommended_action": { "description": "Advisory only, deterministic and not signed. Judge: next_step pass is approve, escalate is review, retry is return (send back to the agent). Consensus: risk low is approve, medium or high is review.", "enum": [ "approve", "review", "return" ], "type": "string" }, "request_id": { "type": "string" }, "retention": { "type": "object" }, "score": { "description": "null when no model gave a verdict (degraded).", "type": [ "number", "null" ] }, "verdict": { "enum": [ "pass", "fail", "retry" ], "type": "string" }, "verification": { "enum": [ "verified", "judged", "heuristic", "failed" ], "type": "string" }, "version": { "description": "Echoed when the call sent a version tag.", "type": "string" } }, "required": [ "verdict", "score", "reasons", "request_id" ], "type": "object" } }, { "description": "Payment check: is this seller safe to pay, checked at the moment the agent pays. Compares the 402 price and payee with the seller's published listings when they can be fetched, screens the payee against a local denylist and the bundled OFAC SDN digital-currency address list, flags an over-price versus the intended amount, reuses the duplicate-payment check, and confirms the seller URL returns a valid 402. Returns allow, review or block with reasons and a signed receipt id. Fetches time out in about 2s and fail closed to review. $0.005 per call.", "inputSchema": { "properties": { "agent_id": { "description": "Optional agent or caller id, also used on the signed receipt.", "type": "string" }, "event_id": { "description": "Optional idempotency key for this check.", "type": "string" }, "intended_amount": { "description": "USD the agent intends to pay.", "type": "number" }, "payment_required": { "description": "The seller's 402 PAYMENT-REQUIRED payload or base64 header value." }, "seller_url": { "description": "The seller's paid HTTP URL.", "type": "string" } }, "type": "object" }, "name": "payment_check", "outputSchema": { "properties": { "amount_usd": { "type": "number" }, "checks": { "type": "object" }, "payee": { "type": "string" }, "reasons": { "items": { "type": "string" }, "type": "array" }, "receipt_id": { "type": "string" }, "request_id": { "type": "string" }, "verdict": { "description": "allow, review, or block.", "type": "string" }, "verify_url": { "type": "string" } }, "type": "object" } }, { "description": "Publish a signed receipt you own so a public page and a Screwtape Verified badge can link to that one verdict. Call it when you want to show that a specific output received a specific verdict. Do NOT call it to certify an agent in general: the page says this output received this verdict at this time, and it is not a general safety certification of the agent. Nothing is public until this call. Inputs: receipt_id (required), include_content (optional boolean, default false; true stores and shows the task and agent output only if that call was retained), label (optional, at most 80 characters), unpublish (optional boolean; true removes the public page). Returns public_url, badge_svg_url, embed_html, and embed_markdown. Requires the API key that owns the receipt. Cost: free.", "inputSchema": { "additionalProperties": false, "properties": { "include_content": { "description": "Default false. true copies the retained task and agent output onto the public page.", "type": "boolean" }, "label": { "description": "Optional label, at most 80 characters.", "maxLength": 80, "type": "string" }, "receipt_id": { "description": "Receipt id from a judge or consensus response this key owns.", "type": "string" }, "unpublish": { "description": "true removes the public page and the badge.", "type": "boolean" } }, "required": [ "receipt_id" ], "type": "object" }, "name": "publish_receipt", "outputSchema": { "properties": { "badge_svg_url": { "type": "string" }, "embed_html": { "type": "string" }, "embed_markdown": { "type": "string" }, "public_url": { "type": "string" }, "request_id": { "type": "string" }, "unpublished": { "type": "boolean" } }, "type": "object" } }, { "description": "See what a spend check returns before you have a key. Runs ONE sample check on a fixed demo invoice: a duplicate match against an invoice paid earlier, required fields, and a sum check that the line items add up to the total. Call it once to learn the response shape. Do NOT call it on your own invoices (it ignores them; use check_duplicate_invoice) or in a loop: it is limited to 5 calls per hour per IP and per MCP session. Inputs: scenario (optional: duplicate, the default, clean, or bad_total). Returns: demo, scenario, invoice, earlier_invoice, duplicate.status (unique or duplicate), checks, next_step.action (pass, retry or escalate), note, next_action and request_id. No receipt and nothing is stored. Cost: free. Needs no key.", "inputSchema": { "additionalProperties": false, "properties": { "scenario": { "description": "Which fixed demo invoice to check: duplicate (default; the same invoice sent again with a reformatted id), clean, or bad_total (the line items do not add up).", "enum": [ "duplicate", "clean", "bad_total" ], "type": "string" } }, "type": "object" }, "name": "try_check", "outputSchema": { "properties": { "checks": { "items": { "properties": { "detail": { "type": "string" }, "passed": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "type", "passed", "detail" ], "type": "object" }, "type": "array" }, "demo": { "const": true, "type": "boolean" }, "duplicate": { "properties": { "matched_invoice_id": { "type": "string" }, "rule": { "type": "string" }, "status": { "enum": [ "unique", "duplicate" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "earlier_invoice": { "type": "object" }, "invoice": { "type": "object" }, "next_action": { "type": "string" }, "next_step": { "properties": { "action": { "enum": [ "pass", "retry", "escalate" ], "type": "string" }, "hint": { "type": "string" } }, "required": [ "action", "hint" ], "type": "object" }, "note": { "type": "string" }, "request_id": { "type": "string" }, "scenario": { "enum": [ "duplicate", "clean", "bad_total" ], "type": "string" } }, "required": [ "demo", "scenario", "invoice", "earlier_invoice", "duplicate", "checks", "next_step", "note", "next_action", "request_id" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:117bebb3186547b1ac5f2ac662d7610197f630d1a86353b3f7d303d18931fc46 | sha256sum