{"uid":"cap_wY-m1BTbFS9TyJdL-y7XF","slug":"screwtape-ai-multi-agent-consensus-endpoint-698787cf","name":"Screwtape.ai — Multi-Agent Consensus Endpoint","description":"API for pass, fail, or retry verdicts on agent output, plus multi-agent consensus and false-consensus risk.","url":"https://screwtape.ai/v1/consensus?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"task":{"type":"string"},"retain":{"type":"boolean"},"answers":{"type":"array","items":{"type":"object","required":["output"],"properties":{"output":{"type":"string"},"agent_id":{"type":"string"}}},"maxItems":16,"minItems":2},"version":{"type":"string","maxLength":64,"description":"Optional version tag for that agent."},"agent_id":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,64}$","maxLength":64,"description":"Optional tag for the agent making this call. Not the per-answer agent_id."},"evidence":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":20}],"description":"Optional. A string or an array of up to 20 strings. Used when scoring the agreed answer."}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["agreement_score","false_consensus_risk","reasons","request_id"],"properties":{"reasons":{"type":"array","items":{"type":"string"}},"clusters":{"type":"array"},"retention":{"type":"object"},"request_id":{"type":"string"},"agreement_score":{"type":"number"},"consensus_answer":{"type":"string"},"false_consensus_risk":{"enum":["low","medium","high"],"type":"string"}}},"example":{"engine":"deterministic","reasons":["Answers are nearly verbatim. High agreement may be copied rather than independent.","Agreement is token overlap, not a model judgment. Clusters are overlap grouping only."],"clusters":[{"role":"clustering","size":3,"agent_ids":["alpha","beta","gamma"],"representative":"The crew size was 4."}],"retention":{"retained":false},"request_id":"example-request-id","verification":"heuristic","agreement_score":1,"consensus_answer":"The crew size was 4.","false_consensus_risk":"high","unsupported_agreement":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tBq2mgXLH0dCX9vtj7gUI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates agreement across multiple agent outputs, returns a consensus answer, agreement score, and false-consensus risk rating (low/medium/high).","exampleAgentPrompt":"I have 4 agent responses to the task 'What was the crew size?' — can you run them through Screwtape consensus to see if they genuinely agree or if it's just superficial overlap? Pass the answers as an array with agent IDs alpha, beta, gamma, and delta.","exampleUseCases":[{"title":"Detecting copied answers in agent pipeline","prompt":"I have 3 agents that all answered 'The revenue was $4.2M' for my financial analysis task — can you check if they independently reached that conclusion or if they're just parroting each other? Run a Screwtape consensus check and tell me the false-consensus risk."},{"title":"Surfacing consensus before acting on agentic output","prompt":"Before I act on this research result, I want to verify that my 5 research agents actually agree — run a consensus check on their outputs for the task 'Which drug compound showed the highest efficacy?' and give me the agreement score and consensus answer."},{"title":"Quality gate in automated agent workflow","prompt":"As a quality gate before publishing, check whether my 4 summarization agents agree on this article's key claim — here are their outputs, and here's the original article text as evidence. Flag anything with high false-consensus risk."}],"resultDescription":"Returns a JSON object containing: a numeric agreement_score (0–1), a false_consensus_risk enum (low/medium/high), a consensus_answer string representing the most agreed-upon output, an array of reasons explaining the verdict, an array of clusters grouping similar answers with representative samples and agent IDs, optional retention metadata, and a unique request_id for tracing.","failureModes":["Fewer than 2 answers provided — request rejected (minItems:2 constraint)","More than 16 answers provided — request rejected (maxItems:16 constraint)","Malformed agent_id pattern (must match ^[A-Za-z0-9._:-]{1,64}$) — validation error","High agreement_score paired with high false_consensus_risk indicates superficial/copied answers rather than independent reasoning","No consensus_answer returned when agents are too divergent","Network or payment failure returning 402 when x402 payment is not fulfilled"],"whenToPreferThis":"Use this endpoint when you need to evaluate whether multiple agent outputs reflect genuine independent agreement versus superficial token overlap or copied answers. It is specifically designed for multi-agent pipelines where false consensus is a risk — e.g. when agents share context and may echo each other. Prefer this over simple majority-vote logic when you need explainable cluster analysis, false-consensus risk scoring, and optional evidence-grounded evaluation in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:35:01.854Z","isFirstParty":false,"canonicalSlug":"screwtape-ai-multi-agent-consensus-endpoint-698787cf"}