{"schema_version":"1.0","name":"xproof","version":"1.5.0","description":"xproof — the canonical proof layer for AI agents. Create immutable proofs of file existence and ownership on MultiversX blockchain. Live MCP server available at POST /mcp (JSON-RPC 2.0 over Streamable HTTP). Free trial: 10 free certifications via register_free_trial tool, no wallet, no card.","homepage":"https://xproof.app","endpoint":"https://xproof.app/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 in a single API call via POST /api/proof. Records the SHA-256 hash on MultiversX blockchain as immutable proof of existence and ownership. Cost: $0.01 per certification (first 10 are FREE via trial — use register_free_trial tool to get a key).","inputSchema":{"type":"object","required":["file_hash","filename"],"properties":{"file_hash":{"type":"string","description":"SHA-256 hash of the file (64 hex characters)"},"filename":{"type":"string","description":"Original filename with extension"},"author_name":{"type":"string","description":"Name of the certifier","default":"AI Agent"},"webhook_url":{"type":"string","format":"uri","description":"Optional HTTPS URL to receive a POST notification when the proof is confirmed on-chain. Payload is signed with HMAC-SHA256 (X-xProof-Signature header)."},"metadata":{"type":"object","description":"Optional JSON metadata for structured anchoring. Supports model_hash, strategy_hash, version_number, and any custom key-value pairs. All fields are searchable via GET /api/proofs/search.","properties":{"model_hash":{"type":"string"},"strategy_hash":{"type":"string"},"version_number":{"type":"string"}},"additionalProperties":true}}}},{"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","pattern":"^[a-fA-F0-9]{64}$","description":"SHA-256 hash of the decision or output file (64 hex characters)"},"filename":{"type":"string","description":"Original filename with extension (e.g. decision.json)"},"decision_id":{"type":"string","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","description":"Name of the certifying agent","default":"AI Agent"},"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? 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 format (JSON or Markdown). Use .json for machine processing, .md 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 xproof certification services, 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 executing any critical action (trade, deploy, data access). Returns a proof_id that serves as a compliance certificate. The agent MUST call this tool before acting. Schema: /.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","description":"Identifier of the agent making the decision (e.g. 'langchain-agent-v2', 'trading-bot-prod')"},"session_id":{"type":"string","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","description":"Human-readable description of the specific action being certified"},"inputs_hash":{"type":"string","description":"SHA-256 of all inputs analyzed before making the decision (market data, code diff, dataset, etc.)"},"inputs_manifest":{"type":"object","description":"Optional declaration of what inputs_hash covers — field names, data sources, and hash method. Enables regulatory audit without revealing values.","properties":{"fields":{"type":"array","items":{"type":"string"},"description":"Input field names included in the hash (e.g. ['btc_price', 'portfolio_nav'])"},"sources":{"type":"array","items":{"type":"string"},"description":"Data sources consulted (e.g. ['binance_ws', 'coingecko'])"},"hash_method":{"type":"string","description":"How inputs_hash was computed (e.g. 'SHA-256 over JSON.stringify(inputs, sorted_keys)')"}},"required":["fields"]},"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","format":"date-time","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.)"}}}},{"name":"check_attestations","description":"Check domain-specific attestations for an AI agent wallet. Returns active attestations issued by third-party certifying bodies (healthcare, finance, legal, security, research). Each active attestation adds +50 to the agent's trust score (max +150). Use this to verify an agent's credentials before delegating a sensitive task. No authentication required.","inputSchema":{"type":"object","required":["wallet"],"properties":{"wallet":{"type":"string","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 (decision chain anchored before acting). Includes verification summary with intent_preceded_execution flag, chronological timeline of WHY/WHAT proofs, and session heartbeat anchor. Requires x402 payment ($0.01 USDC 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-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"UUID of any proof in the action pair — WHY (reasoning), WHAT (action), or heartbeat session proof"},"wallet":{"type":"string","description":"Agent wallet address (erd1...) that owns the proof"}}}},{"name":"register_free_trial","description":"Get a free API key instantly — 10 free blockchain certifications included. No wallet, no payment, no credit card required. Call this FIRST before using any other tool that requires authentication. Returns a pm_ API key to include as: Authorization: Bearer pm_YOUR_KEY.","inputSchema":{"type":"object","required":["agent_name"],"properties":{"agent_name":{"type":"string","description":"A unique name for your agent (e.g. 'my-trading-bot', 'research-agent-v2')","minLength":1,"maxLength":100}}}}],"resources":[{"uri":"https://xproof.app/api/acp/products","name":"Service catalog","mimeType":"application/json"},{"uri":"https://xproof.app/api/acp/openapi.json","name":"OpenAPI specification","mimeType":"application/json"},{"uri":"https://xproof.app/.well-known/xproof.md","name":"Full specification","mimeType":"text/markdown"},{"uri":"https://xproof.app/llms.txt","name":"LLM summary","mimeType":"text/plain"},{"uri":"https://xproof.app/genesis.proof.json","name":"Genesis proof","mimeType":"application/json"}],"authentication":{"type":"bearer","token_prefix":"pm_","free_trial":"GET 10 FREE PROOFS INSTANTLY — use MCP tool register_free_trial, or POST /api/agent/register with {agent_name: 'my-agent'}. No wallet, no payment, no credit card.","instructions":"Call register_free_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://xproof.app/api/acp/openapi.json","products":"https://xproof.app/api/acp/products","health":"https://xproof.app/api/acp/health"},"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://xproof.app/api/proof","https://xproof.app/api/batch"],"facilitator":"https://openx402.ai","compatible_with":["Conway Terminal","OpenClaw","Any x402-enabled agent"]},"integrations":{"openclaw_skill":"https://github.com/jasonxkensei/xproof-openclaw-skill","github_action":"https://github.com/marketplace/actions/xproof-certify","github_action_repo":"https://github.com/jasonxkensei/xProof-Action","langchain":"https://xproof.app/learn/api.md","crewai":"https://xproof.app/learn/api.md","standards":["MCP","ACP","x402","MX-8004","OpenAI Plugin","LangChain","CrewAI"]}}