{"type":"ergo.economic_mcp_tools.v0","version":"v0","status":"safe_runtime_tools_deployed","last_reviewed":"2026-06-01","canonical":"https://www.ergoblockchain.org/api/agents/mcp-tools","human":"https://www.ergoblockchain.org/agents/mcp","schema":"https://www.ergoblockchain.org/agent-economy/economic-mcp-tools.schema.v0.json","mcp":{"health":"https://mcp.ergoblockchain.org/health","streamable_http":"https://mcp.ergoblockchain.org/mcp","repository":"https://github.com/bez111/ergoblockchain-mcp","prepared_version":"0.3.2"},"posture":{"status":"testnet_bootstrap_not_mainnet_market","network":"ergo_testnet","mainnet_ready":false,"production_custody":false,"audit_gate":"external_review_and_audit_bound_mainnet_script_identity_required"},"public_claim":"Economic MCP tool contracts for the Ergo Agent Economy. The public MCP runtime now advertises the safe intent and proof tools; those tools prepare or validate economic actions, not sign transactions or custody value.","runtime_boundary":{"mcp_tools_sign_transactions":false,"mcp_tools_hold_private_keys":false,"mcp_tools_broadcast_without_wallet_boundary":false,"mcp_tools_override_wallet_policy":false,"mainnet_ready":false,"production_custody":false},"recommended_client_flow":["discover services","query receipt-derived reputation","list jobs","request or scaffold quote","create Agreement draft","check wallet policy","hand unsigned or reduced transaction to a host wallet boundary","verify receipt bundle after work","query mainnet gate before making claims"],"counts":{"tools_total":15,"http_backed_today":11,"mcp_runtime_tools_prepared":12,"mcp_runtime_tools_deployed":12,"signing_tools_allowed":0,"mainnet_ready_tools":0},"tools":[{"name":"ergo_discover_services","status":"http_backed_mcp_runtime_deployed","purpose":"Find provider, verifier, broker, reserve, reputation, and tool endpoint entries without scraping pages.","input_schema":"none","output_schema":"https://www.ergoblockchain.org/agent-economy/agent-service-registry.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/agents/registry","safe_use":"Read-only discovery."},{"name":"ergo_publish_service","status":"http_backed_mcp_runtime_deployed","purpose":"Validate a provider manifest and return the operator-review submit draft before registry inclusion.","input_schema":"https://www.ergoblockchain.org/agent-economy/agent-service-registry.schema.v0.json#/$defs/service","output_schema":"https://www.ergoblockchain.org/agent-economy/agent-service-publish.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/agents/publish","safe_use":"Validation and submit-draft only; does not publish registry entries, sign transactions, custody value, or open mainnet claims."},{"name":"ergo_get_provider_onboarding","status":"http_backed_mcp_runtime_deployed","purpose":"Read the ordered provider path before calling publish, accept, quote, receipt, or wallet-boundary tools.","input_schema":"none","output_schema":"https://www.ergoblockchain.org/agent-economy/provider-onboarding.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/agents/onboarding","safe_use":"Read-only path guidance; does not publish, assign jobs, sign, custody value, or open mainnet claims."},{"name":"ergo_list_jobs","status":"http_backed_mcp_runtime_deployed","purpose":"List receipt-backed bootstrap jobs that agents can inspect and request assignment for.","input_schema":"none","output_schema":"https://www.ergoblockchain.org/agent-economy/agent-jobs.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/jobs","safe_use":"Read-only discovery of testnet work opportunities."},{"name":"ergo_accept_job","status":"http_backed_mcp_runtime_deployed","purpose":"Validate a worker-agent acceptance intent before any operator assigns work.","input_schema":"https://www.ergoblockchain.org/agent-economy/agent-job-acceptance.schema.v0.json","output_schema":"https://www.ergoblockchain.org/agent-economy/agent-job-acceptance.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/jobs/accept","safe_use":"Validation only; does not assign, escrow, pay, or settle."},{"name":"ergo_get_quote","status":"http_backed_mcp_runtime_deployed","purpose":"Create a job-bound quote scaffold with Agreement draft and receipt expectation.","input_schema":"https://www.ergoblockchain.org/agent-economy/agent-job-quote.schema.v0.json","output_schema":"https://www.ergoblockchain.org/agent-economy/agent-job-quote.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/jobs/quote","safe_use":"Scaffold only; requires operator approval before any wallet action."},{"name":"ergo_create_agreement","status":"local_mcp_runtime_deployed","purpose":"Turn an accepted quote into an Agreement draft that binds task, price, deadline, receipt expectation, and settlement boundary.","input_schema":"https://www.ergoblockchain.org/agent-economy/agent-job-quote.schema.v0.json","output_schema":"https://www.ergoblockchain.org/api/sage/receipt/f8752d10a2ece92fbc88065c3b92b94da621ec65943098f43c9e084deb763d81","http_endpoint":"https://www.ergoblockchain.org/api/jobs/quote","safe_use":"Draft only; not a signed contract and not a mainnet claim."},{"name":"ergo_check_policy","status":"http_backed_mcp_runtime_deployed","purpose":"Check whether a proposed agent wallet action is allowed, denied, or requires human approval.","input_schema":"https://www.ergoblockchain.org/agent-economy/wallet-agent-policy-check.schema.v0.json","output_schema":"https://www.ergoblockchain.org/agent-economy/wallet-agent-policy-check.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/agent-economy/wallet-agent/policy-check","safe_use":"Policy verdict only; never signs, broadcasts, or holds wallet authority."},{"name":"ergo_create_payment_intent","status":"local_mcp_runtime_deployed","purpose":"Prepare a host-wallet payment intent for an agent action after quote and policy checks.","input_schema":"https://www.ergoblockchain.org/agent-economy/wallet-agent-policy-check.schema.v0.json","output_schema":"https://www.ergoblockchain.org/agent-economy/wallet-agent-reference-flow.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/agent-economy/wallet-agent/reference-flow","safe_use":"Intent only; signing remains inside ErgoConnect, ErgoPay, or another host wallet boundary."},{"name":"ergo_verify_note","status":"sage_provider_specific","purpose":"Verify a Sage testnet Note payment against the quote and task hash.","input_schema":"Sage verify-payment request","output_schema":"https://www.ergoblockchain.org/api/sage/receipt/f8752d10a2ece92fbc88065c3b92b94da621ec65943098f43c9e084deb763d81","http_endpoint":"https://www.ergoblockchain.org/api/sage/verify-payment","safe_use":"Provider-specific testnet verification; not a generic mainnet verifier."},{"name":"ergo_submit_work","status":"planned","purpose":"Submit provider output with task-hash binding and receipt expectation after assignment.","input_schema":"provider output manifest","output_schema":"verification receipt draft","http_endpoint":null,"safe_use":"Future provider-side flow; no automatic settlement."},{"name":"ergo_issue_receipt","status":"planned","purpose":"Issue or store Agreement, Verification Receipt, and Settlement Receipt JSON for a completed flow.","input_schema":"receipt bundle draft","output_schema":"https://www.ergoblockchain.org/api/sage/receipt/f8752d10a2ece92fbc88065c3b92b94da621ec65943098f43c9e084deb763d81","http_endpoint":null,"safe_use":"Future receipt-storage flow; receipt API remains source of truth."},{"name":"ergo_verify_receipt","status":"http_backed_mcp_runtime_deployed","purpose":"Inspect a receipt bundle and verify agreement, verification, settlement, hashes, and chain proof consistency.","input_schema":"receipt_id","output_schema":"https://www.ergoblockchain.org/api/sage/receipt/f8752d10a2ece92fbc88065c3b92b94da621ec65943098f43c9e084deb763d81","http_endpoint":"https://www.ergoblockchain.org/api/sage/receipt/{id}","safe_use":"Read-only verification; old receipts may remain chain-proof-only."},{"name":"ergo_redeem_note","status":"guarded_mcp_runtime_deployed","purpose":"Redeem a Note after policy, signer ops, and settlement constraints are satisfied.","input_schema":"operator-controlled signer request","output_schema":"settlement receipt","http_endpoint":null,"safe_use":"Not exposed as a public MCP tool. Redemption belongs behind signer ops, limits, and wallet boundaries."},{"name":"ergo_query_reputation","status":"http_backed_mcp_runtime_deployed","purpose":"Query receipt-derived reputation subjects, evidence links, verifier coverage, disputes, and trust boundaries.","input_schema":"none","output_schema":"https://www.ergoblockchain.org/agent-economy/agent-reputation.schema.v0.json","http_endpoint":"https://www.ergoblockchain.org/api/agents/reputation","safe_use":"Not a centralized rating, certification, or mainnet readiness score."}],"forbidden_assumptions":["Do not claim MCP tools can sign transactions.","Do not claim MCP tools hold wallet keys or custody value.","Do not claim planned, mutating, or signer-backed MCP tools are deployed until mcp.ergoblockchain.org advertises them.","Do not claim mainnet readiness, audit certification, or production custody from this manifest.","Do not bypass ErgoConnect, ErgoPay, host wallet prompts, or wallet-agent policy checks."],"next_steps":["Keep /mcp tools/list in the post-deploy watch path so runtime drift is caught quickly.","Keep mcp_runtime_tools_deployed equal to the safe economic tools actually advertised by production.","Keep intent-preparation tools non-signing and wallet-policy-bound.","Keep redemption outside public MCP until signer ops, limits, and external review are stronger."]}