{"schema_version":"1.0","name":"Prove Before Act","version":"1.5.0","specification_url":"https://provebeforeact.com/standard","description":"Prove Before Act is the accountability pattern for autonomous agents; xProof is the reference MCP implementation. Before a significant action, anchor a declared decision basis — intended action, context, and justification — then anchor the verified outcome after execution. Do not submit internal chain-of-thought. Send JSON-RPC MCP requests to POST /mcp; GET /mcp serves connection documentation. Free trial: 10 free certifications via register_trial MCP tool (no auth required), no wallet, no card.","homepage":"https://provebeforeact.com","endpoint":"https://provebeforeact.com/mcp","documentation_url":"https://provebeforeact.com/mcp","transport":"streamable-http","protocol_version":"2025-03-26","capabilities":{"tools":true,"resources":true},"tools":[{"name":"certify_file","description":"Create a blockchain certification for a file. Records the SHA-256 hash on MultiversX blockchain as immutable proof of existence and ownership. Cost: $0.01 per certification, paid in EGLD.","inputSchema":{"type":"object","required":["file_hash","filename"],"properties":{"file_hash":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-fA-F0-9]{64}$","description":"SHA-256 hash of the file (64 hex characters)"},"filename":{"type":"string","minLength":1,"maxLength":255,"description":"Original filename with extension (max 255 chars)"},"author_name":{"type":"string","maxLength":128,"description":"Name of the certifier (default: AI Agent, max 128 chars)"},"webhook_url":{"type":"string","format":"uri","pattern":"^https://","description":"Optional HTTPS URL for on-chain confirmation callback"}}}},{"name":"certify_with_confidence","description":"Create a staged blockchain certification with a confidence score. Use this when your decision builds progressively — certify at 60% (initial assessment), 80% (pre-commitment), and 100% (final decision). Each stage shares the same decision_id, creating an on-chain audit trail of the decision process. Governance: set reversibility_class='irreversible' for actions that cannot be undone — xproof will flag a policy violation if confidence_level < 0.95. Cost: $0.01 per certification.","inputSchema":{"type":"object","required":["file_hash","filename","decision_id","confidence_level","threshold_stage"],"properties":{"file_hash":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-fA-F0-9]{64}$","description":"SHA-256 hash of the decision or output file (64 hex characters)"},"filename":{"type":"string","minLength":1,"maxLength":255,"description":"Original filename with extension (e.g. decision.json, max 255 chars)"},"decision_id":{"type":"string","minLength":1,"description":"Shared UUID linking all confidence stages for the same decision. Generate once and reuse across all stages."},"confidence_level":{"type":"number","minimum":0,"maximum":1,"description":"Confidence score from 0.0 to 1.0. Typical values: 0.6 (initial), 0.8 (pre-commitment), 1.0 (final)."},"threshold_stage":{"type":"string","enum":["initial","partial","pre-commitment","final"],"description":"Named stage of the decision: initial (first assessment), partial (gathering info), pre-commitment (almost certain), final (committed)."},"author_name":{"type":"string","maxLength":128,"description":"Name of the certifying agent (default: AI Agent, max 128 chars)"},"why":{"type":"string","description":"Reason or instruction hash driving this decision"},"who":{"type":"string","description":"Agent identity (wallet address, name, or agent ID)"},"reversibility_class":{"type":"string","enum":["reversible","costly","irreversible"],"description":"Governance: how reversible is this action? 'reversible' = can be undone, 'costly' = reversible but expensive, 'irreversible' = cannot be undone. When 'irreversible', confidence_level must be >= 0.95 or xproof flags a policy violation."}}}},{"name":"verify_proof","description":"Verify an existing xproof certification. Returns proof details including file hash, timestamp, blockchain transaction, and verification status.","inputSchema":{"type":"object","required":["proof_id"],"properties":{"proof_id":{"type":"string","description":"UUID of the certification to verify"}}}},{"name":"get_proof","description":"Retrieve a proof in structured JSON or Markdown format. Use JSON for machine processing, Markdown for LLM consumption.","inputSchema":{"type":"object","required":["proof_id"],"properties":{"proof_id":{"type":"string","description":"UUID of the certification"},"format":{"type":"string","enum":["json","md"],"default":"json","description":"Output format"}}}},{"name":"discover_services","description":"Discover available Prove Before Act certification services, live pricing, and capabilities. No authentication required.","inputSchema":{"type":"object","properties":{}}},{"name":"audit_agent_session","description":"Certify an AI agent's work session on the MultiversX blockchain before a critical action (trade, deploy, data access). Returns a proof_id that an operator can use in its own compliance policy. This tool records certification; whether a missing or failed certification blocks execution is an operator-implemented policy decision. Governance: set reversibility_class='irreversible' for actions that cannot be undone — a policy violation is flagged if confidence_level < 0.95 on irreversible decisions. Schema: https://provebeforeact.com/.well-known/agent-audit-schema.json","inputSchema":{"type":"object","required":["agent_id","session_id","action_type","action_description","inputs_hash","risk_level","decision","timestamp"],"properties":{"agent_id":{"type":"string","minLength":1,"description":"Identifier of the agent making the decision"},"session_id":{"type":"string","minLength":1,"description":"Unique session identifier (UUID or timestamp-based)"},"action_type":{"type":"string","enum":["trade_execution","code_deploy","data_access","content_generation","api_call","other"],"description":"Category of the action being certified"},"action_description":{"type":"string","minLength":1,"description":"Human-readable description of the specific action"},"inputs_hash":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-fA-F0-9]+$","description":"SHA-256 of all inputs analyzed before making the decision"},"risk_level":{"type":"string","enum":["low","medium","high","critical"],"description":"Assessed risk level of the action"},"decision":{"type":"string","enum":["approved","rejected","deferred"],"description":"Agent's decision about whether to proceed"},"timestamp":{"type":"string","description":"ISO 8601 timestamp of when the decision was made"},"risk_summary":{"type":"string","description":"Optional brief risk analysis justifying the decision"},"context":{"type":"object","description":"Optional additional context (model version, environment, tool chain, etc.)","additionalProperties":true},"reversibility_class":{"type":"string","enum":["reversible","costly","irreversible"],"description":"Governance: how reversible is this action? 'reversible' = can be undone at low cost, 'costly' = reversible but expensive, 'irreversible' = cannot be undone. When 'irreversible', a confidence_level >= 0.95 is required to be policy-compliant."}}}},{"name":"check_attestations","description":"Check domain-specific attestations for an AI agent wallet on Prove Before Act. Returns active attestations issued by third-party certifying bodies (healthcare, finance, legal, security, research). Use the returned attestation data when assessing credentials before delegating a sensitive task.","inputSchema":{"type":"object","required":["wallet"],"properties":{"wallet":{"type":"string","minLength":3,"description":"MultiversX wallet address (erd1...) of the agent to check"}}}},{"name":"investigate_proof","description":"Reconstruct the full 4W audit trail for a contested agent action. Returns WHO (agent identity + SIGIL), WHAT (SHA-256 hash on-chain), WHEN (MultiversX block timestamp), WHY (declared decision basis anchored before acting, never internal chain-of-thought). Includes verification summary with intent_preceded_execution flag, chronological timeline of WHY/WHAT proofs, and session heartbeat anchor. Requires x402 payment (current per-call USDC price on Base via X-PAYMENT header) or API key authentication.","inputSchema":{"type":"object","required":["proof_id","wallet"],"properties":{"proof_id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"UUID of any proof in the action pair — WHY (declared decision basis), WHAT (action), or heartbeat session proof"},"wallet":{"type":"string","minLength":3,"description":"Agent wallet address (erd1...) that owns the proof"}}}},{"name":"register_trial","description":"START HERE if you have no API key. Get 10 free on-chain certifications instantly — no wallet, no credit card, no account required. Call this once with any agent_name, receive a pm_ key, then use certify_file or audit_agent_session immediately. Takes under 1 second.","inputSchema":{"type":"object","required":["agent_name"],"properties":{"agent_name":{"type":"string","description":"A short identifier for your agent (e.g. 'trading-bot', 'my-langchain-agent'). Must be unique across the platform.","minLength":1,"maxLength":100}}}},{"name":"submit_outcome","description":"Submit the actual outcome for a decision previously anchored with metadata.confidence_level. Computes the confidence gap (anchored − actual) and stores it for calibration tracking. Operator-only — you must own the proof. Each proof can only have one outcome.","inputSchema":{"type":"object","required":["proof_id","outcome_score"],"properties":{"proof_id":{"type":"string","minLength":1,"description":"UUID of the certification that was anchored with metadata.confidence_level"},"outcome_score":{"type":"number","minimum":0,"maximum":1,"description":"Actual outcome quality (0.0 = complete failure, 1.0 = fully successful)"},"visibility":{"type":"string","enum":["public","private"],"default":"public","description":"Whether this outcome is publicly visible (default: public)"}}}},{"name":"get_calibration","description":"Query an agent's calibration quality over time: mean confidence gap, variance, bias label (overconfident / underconfident / calibrated), and per-decision time series. Fully public — use this to evaluate another agent before trusting it. agentId accepts a MultiversX wallet address (erd1...) or internal user id.","inputSchema":{"type":"object","required":["agent_id"],"properties":{"agent_id":{"type":"string","minLength":1,"description":"Agent wallet address (erd1...) or internal user id"},"n":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Number of recent outcomes to include (default 50, max 200)"}}}},{"name":"check_coherence","description":"Anchor your agent's declared decision basis as an immutable WHY proof BEFORE executing an action — never internal chain-of-thought. Implements the Prove Before Act / Coherence Layer pattern. Pass intent (goal), context (facts considered), and decision (action about to execute). Receives: proof_id, coherence_anchor (SHA-256 of the payload), timestamp. Link the returned proof_id to your WHAT proof via certify_file metadata.why_proof_id to complete the full 4W audit trail. Cost: $0.01 per anchor (same as certify_file).","inputSchema":{"type":"object","required":["intent","context","decision"],"properties":{"intent":{"type":"string","minLength":1,"maxLength":2000,"description":"The agent's stated goal or objective for this action (e.g. 'Optimize portfolio allocation for Q3')"},"context":{"type":"string","minLength":1,"maxLength":4000,"description":"Relevant facts, constraints, and inputs considered before the decision (e.g. 'BTC RSI=38, allocation 2.1%, policy v3.1')"},"decision":{"type":"string","minLength":1,"maxLength":2000,"description":"The specific action the agent is about to execute (e.g. 'BUY 0.5 BTC at market')"},"who":{"type":"string","maxLength":200,"description":"Agent identifier — wallet address, agent name, or model id (default: derived from API key owner)"}}}},{"name":"require_coherence_anchor","description":"Optional policy helper: verify a valid, unexpired coherence anchor (WHY proof) exists for a given intent before allowing an action to execute. An operator can call this from its orchestrator before delegating a sub-action. Pass either the exact intent_hash (the coherence_anchor returned by check_coherence) or the same intent + context + decision payload (the anchor hash is recomputed deterministically). Returns { allowed, anchor_id, expires_at }. If allowed=false, the operator's orchestrator can choose to pause and call check_coherence first. Free — no credit consumed.","inputSchema":{"type":"object","anyOf":[{"required":["intent_hash"]},{"required":["intent","context","decision"]}],"properties":{"intent_hash":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-fA-F0-9]{64}$","description":"The coherence_anchor hash returned by check_coherence (64 hex chars). Fastest path — pass this if you have it."},"intent":{"type":"string","minLength":1,"maxLength":2000,"description":"The stated goal — must be byte-identical to the check_coherence call (used with context + decision to recompute the anchor hash)"},"context":{"type":"string","minLength":1,"maxLength":4000,"description":"The facts considered — must be byte-identical to the check_coherence call"},"decision":{"type":"string","minLength":1,"maxLength":2000,"description":"The action to execute — must be byte-identical to the check_coherence call"},"who":{"type":"string","maxLength":200,"description":"Agent identifier — must match the value used in check_coherence (default: derived from API key owner)"},"max_age_minutes":{"type":"integer","minimum":1,"maximum":1440,"description":"Anchor validity window in minutes (default 120 = 2h). Anchors older than this are considered expired/divergent."}}}}],"resources":[{"uri":"https://provebeforeact.com/api/acp/products","name":"Service catalog","mimeType":"application/json"},{"uri":"https://provebeforeact.com/api/acp/openapi.json","name":"OpenAPI 3.1.0 specification","mimeType":"application/json"},{"uri":"https://provebeforeact.com/api/acp/openapi-3.0.json","name":"OpenAPI 3.0.3 compatibility specification","mimeType":"application/json"},{"uri":"https://provebeforeact.com/.well-known/provebeforeact.md","name":"Full specification","mimeType":"text/markdown"},{"uri":"https://provebeforeact.com/llms.txt","name":"LLM summary","mimeType":"text/plain"},{"uri":"https://provebeforeact.com/genesis.proof.json","name":"Genesis proof","mimeType":"application/json"}],"authentication":{"type":"bearer","token_prefix":"pm_","free_trial":"GET 10 FREE PROOFS INSTANTLY — call MCP tool register_trial (no auth required), or POST /api/agent/register with {agent_name: 'my-agent'} via REST. No wallet, no payment, no credit card.","instructions":"Call register_trial MCP tool first to receive a pm_ key, then include it as: Authorization: Bearer pm_YOUR_KEY on all subsequent tool calls."},"api":{"openapi":"https://provebeforeact.com/api/acp/openapi.json","products":"https://provebeforeact.com/api/acp/products","health":"https://provebeforeact.com/api/acp/health"},"openapi_versions":[{"version":"3.1.0","url":"https://provebeforeact.com/api/acp/openapi.json"},{"version":"3.0.3","url":"https://provebeforeact.com/api/acp/openapi-3.0.json"}],"pricing":{"amount":"0.01","currency":"USD","payment_method":"EGLD"},"x402_payment":{"protocol":"x402 (HTTP 402 Payment Required)","description":"Alternative to API key auth. Pay per request with USDC on Base. No account needed.","network":"Base (eip155:8453)","currency":"USDC","price":"$0.01","endpoints":["https://provebeforeact.com/api/proof","https://provebeforeact.com/api/batch"],"facilitator":"https://openx402.ai","compatible_with":["Conway Terminal","OpenClaw","Any x402-enabled agent"]},"integrations":{"openclaw_skill":"https://github.com/jasonxkensei/prove-before-act-openclaw-skill","github_action":"https://github.com/marketplace/actions/xproof-certify","github_action_note":"Legacy GitHub Marketplace slug, maintained for existing CI pipelines. Use the canonical action repository jasonxkensei/prove-before-act-action for new integrations.","github_action_repo":"https://github.com/jasonxkensei/prove-before-act-action","langchain":"https://provebeforeact.com/learn/api.md","crewai":"https://provebeforeact.com/learn/api.md","standards":["MCP","ACP","x402","MX-8004","OpenAI Plugin","LangChain","CrewAI"]}}