{"data":{"name":"io.github.getambr/ambr-mcp-server","title":"Ambr","description":"Ricardian contracts for AI agents — dual-format, SHA-256 bound, legible by construction.","version":"0.3.0","websiteUrl":"https://ambr.run","repositoryUrl":"https://github.com/getambr/site","remotes":[{"url":"https://getamber.dev/api/mcp","type":"streamable-http"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-04-21T14:34:15.300Z","updatedAt":"2026-04-21T14:34:15.300Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Ambr","source":"official-registry","sourceId":"io.github.getambr/ambr-mcp-server","updatedAt":"2026-04-21T14:34:15.300Z","confidence":100,"websiteUrl":"https://ambr.run","description":"Ricardian contracts for AI agents — dual-format, SHA-256 bound, legible by construction.","verification":"official","repositoryUrl":"https://github.com/getambr/site"}],"toolIndex":{"tools":[{"serverName":"io.github.getambr/ambr-mcp-server","endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","name":"ambr_agent_handshake","title":null,"description":"Initiate a handshake on a contract on behalf of your delegating principal.\n\nRequires an API key with an active delegation (principal wallet registered via /api/v1/delegations).\nRecords the agent's intent to accept, reject, or request changes on the contract.\nThe principal must separately approve via wallet signature on the Reader Portal.\n\nArgs:\n  - contract_id (string, required): Contract ID (amb-YYYY-NNNN), SHA-256 hash, or UUID\n  - intent (string, required): \"accept\" | \"reject\" | \"request_changes\"\n  - message (string, optional): Note for the counterparty\n  - visibility_preference (string, optional): \"private\" | \"metadata_only\" | \"public\" | \"encrypted\"\n\nReturns: Handshake status and next steps for principal approval.\n\nLegibility: the handshake itself is auditable — delegation scope, agent identity, and principal approval are recorded alongside the contract hash.","inputSchema":{"type":"object","properties":{"contract_id":{"type":"string","description":"Contract ID, SHA-256 hash, or UUID"},"intent":{"type":"string","enum":["accept","reject","request_changes"],"description":"Handshake intent"},"message":{"type":"string","description":"Optional note for counterparty"},"visibility_preference":{"type":"string","enum":["private","metadata_only","public","encrypted"],"description":"Optional visibility preference for negotiation"}},"required":["contract_id","intent"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e7616fa98310ed0ea77d2f3acecc9d9dc5f2962321bd7596952f3c199f662684","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:11.178Z","metadataTrust":"untrusted"},{"serverName":"io.github.getambr/ambr-mcp-server","endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","name":"ambr_check_transaction","title":null,"description":"Check one payment against the limits of an agreement. Advisory only: Ambr compares what you\nreport with the figures stored with the agreement; it does not authorize, block or see the payments it\nchecks, and a \"within_limits\" answer is not an approval or a guarantee.\n\nIt checks only what a program can check exactly: status, validity window, currency, per-transaction and\nmonthly limits, a total budget, a price or monthly fee, the approval and escalation thresholds, and the\ncategory and action labels you send, matched exactly against the agreement's lists (case, spaces, dots,\ncolons and hyphens are folded, and a leading \"do not\", \"don't\", \"no\", \"not\", \"never\", \"avoid\", \"without\" or \"prohibited:\" on a prohibited entry is ignored). The\nlimits come from the form answers stored with the agreement, not from its text. It reads the delegation\ntemplates (general authorization, power of attorney, limited service, fleet) and the commerce templates\n(API access, compute SLA, task execution). If the agreement was amended, the newest approved version is\nchecked. Free: no credits are burned. Amounts are compared in USD (USDC counts as USD) or in the\ntemplate's own currency; a payment in another currency is not compared and the verdict is \"incomplete\".\n\nIt does NOT read the agreement's human-readable text. Anything written in words (the scope, conditions,\ngeographic limits, who may be paid, how a limit is measured) is for you to read yourself: always read the\nagreement's scope and conditions before acting on any answer. The response's \"not_checked\" lists, by path\nand never the text, parts to start with (each has a kind and a short reason; at most thirty are listed,\n\"not_checked_count\" has the total). It is a best-effort hint, not a complete list: an empty or short list\ndoes not mean there is nothing to read. Read the agreement itself through the contract read.\n\nVerdicts:\n  - \"within_limits\": the template is one the check reads, the form answers are stored and valid, every\n    limit they set was evaluated and passed, every figure written in digits or in common number words\n    in the agreement's machine-readable text is accounted for, and at least one spending limit or price\n    was evaluated. It says nothing about terms\n    written in words.\n  - \"out_of_scope\": a limit definitely fails (status, validity window, a cap, a payment that must equal\n    what is left of a task price, a category or action that is not on a list held in the form\n    answers, or that is prohibited). A permitted-action or category list found only in the agreement's text\n    is never trusted to decide this: a miss there is \"incomplete\".\n  - \"needs_approval\": an approval or escalation threshold is exceeded. \"also_incomplete\": true then means\n    some limit could not be evaluated either; the reasons still carry it.\n  - \"incomplete\": something could not be checked or placed: an input you did not send (category, action,\n    currency, period_spent), a form answer the check cannot use, a figure or statement in the agreement's\n    text that the form answers do not explain or contradict, wording beside a limit that names another period\n    than the one period_spent covers, a date the check cannot place as the agreement's end, a miss on a\n    permitted-action or category list found only in the agreement's text, a payment that is not a whole number of calls\n    at the price per call, permitted counterparties (the request carries none), a payment model the check\n    cannot match, an agreement without stored form answers or made from another template.\nAmbr does not hold funds or track spend: period_spent is what was already spent in the period the limit\ncovers (this month for a monthly limit, fee or fleet budget, for a fleet the whole fleet's; the whole\nagreement so far for a total budget or task price). One payment above a limit fails without it.\n\nAccess: a public contract is open to anyone; otherwise use the creator's API key or pass a share_token.\n\nArgs:\n  - contract_id (string, required): Contract ID (amb-YYYY-NNNN), SHA-256 hash, or UUID\n  - amount (number, required): payment amount, zero or more\n  - currency (string, optional): e.g. \"USD\"\n  - category (string, optional): your own category label, matched exactly against the agreement's list\n  - action (string, optional): the action the agent is taking, matched exactly against the agreement's lists\n  - period_spent (number, optional): already spent in the period the limit covers (this month, or the whole agreement for a total budget)\n  - share_token (string, optional): share token for a private contract\n\nReturns: verdict (\"within_limits\" | \"out_of_scope\" | \"incomplete\" | \"needs_approval\"), the per-rule checks, plain-language reasons, \"not_checked\" and \"not_checked_count\", \"also_incomplete\" when it applies, and the contract that was checked (contract_id, effective_contract_id, sha256_hash, reader_url).","inputSchema":{"type":"object","properties":{"contract_id":{"type":"string","description":"Contract ID, SHA-256 hash, or UUID"},"amount":{"type":"number","minimum":0,"description":"Payment amount"},"currency":{"type":"string","description":"Payment currency, e.g. USD"},"category":{"type":"string","description":"Spending category"},"action":{"type":"string","description":"Action the agent is taking"},"period_spent":{"type":"number","minimum":0,"description":"Already spent in the period the limit covers (this month, or the whole agreement for a total budget)"},"share_token":{"type":"string","description":"Share token for a private contract"}},"required":["contract_id","amount"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8aef5653da85234b3e6c0c7a36374c8e7438f318c182762bfba1611d954269af","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:11.178Z","metadataTrust":"untrusted"},{"serverName":"io.github.getambr/ambr-mcp-server","endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","name":"ambr_create_contract","title":null,"description":"Generate a Ricardian Contract from a template.\n\nCreates a dual-format contract (human-readable legal text + machine-parsable JSON)\nusing AI, linked by SHA-256 hash. The contract is stored on Ambr and accessible\nvia the Reader Portal.\n\nRequires a valid API key (X-API-Key header on the HTTP request) with available credits.\nUse ambr_list_templates first to discover templates and their required parameters.\n\nArgs:\n  - template (string, required): Template slug (e.g. \"d1-general-auth\")\n  - parameters (object, required): Template-specific parameters matching the schema\n  - principal_declaration (object, required): { agent_id, principal_name, principal_type }\n  - principal_wallet (string, optional): the deploying party's own wallet. It must differ from the\n    counterparty wallet in parameters (same_wallet_both_parties otherwise); left out, the first\n    wallet that signs fills the principal side\n  - parent_contract_hash (string, optional): SHA-256 hash of a contract you created, which this one is\n    created under (its oversight threshold then applies). Not for amendments: propose those with\n    POST /api/v1/contracts/{id}/amend\n  - oversight_threshold_usd (number, optional): spending level above which work created under\n    this contract needs human approval. Children exceeding it halt at awaiting_principal_approval.\n\nReturns:\n  - contract_id: Unique ID (e.g. \"amb-2026-0042\")\n  - sha256_hash: SHA-256 hash for verification\n  - status: Contract status\n  - reader_url: URL to view in Reader Portal\n  - credits_remaining: Remaining API credits\n\nLegibility: Output is dual-format by construction and replayable to the original SHA-256 hash — the basis of Ambr's legibility guarantee.","inputSchema":{"type":"object","properties":{"template":{"type":"string","description":"Template slug from ambr_list_templates"},"parameters":{"type":"object","description":"Template-specific parameters","additionalProperties":true},"principal_declaration":{"type":"object","properties":{"agent_id":{"type":"string","description":"Agent identifier"},"principal_name":{"type":"string","description":"Name of the principal (person or company)"},"principal_type":{"type":"string","enum":["company","individual"],"description":"Type of principal"}},"required":["agent_id","principal_name","principal_type"]},"principal_wallet":{"type":"string","description":"The deploying party's own wallet (0x…). Must differ from the counterparty wallet in parameters."},"parent_contract_hash":{"type":"string","description":"SHA-256 hash of a contract you created, which this one is created under. Amendments are proposed with POST /api/v1/contracts/{id}/amend, not here."},"oversight_threshold_usd":{"type":"number","description":"Spending level above which work created UNDER this contract requires human approval. A child contract exceeding the parent threshold is held at awaiting_principal_approval until a human signs, and cannot be signed or activated before then (EU AI Act Art. 14)."}},"required":["template","parameters","principal_declaration"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"df86e9391f76e20564857625e56439fb6b236ae1f504d560fafd830f83cefd3f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:11.178Z","metadataTrust":"untrusted"},{"serverName":"io.github.getambr/ambr-mcp-server","endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","name":"ambr_get_contract","title":null,"description":"Retrieve a contract by ID, SHA-256 hash, or UUID.\n\nWith a valid API key (contract creator): returns the full contract including\nhuman-readable text, machine-readable JSON, status, and principal declaration.\nWithout authentication: returns metadata only (contract_id, status, hash, dates).\n\nSupports three lookup formats:\n  - Contract ID: \"amb-2026-0042\"\n  - SHA-256 hash: 64-character hex string\n  - UUID: Standard UUID format\n\nArgs:\n  - id (string, required): Contract ID, SHA-256 hash, or UUID\n\nReturns: Full contract (if authorized) or metadata-only response.\n\nLegibility: retrieval preserves the dual-format pairing — prose and JSON always replay to the same SHA-256.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Contract ID (amb-YYYY-NNNN), SHA-256 hash, or UUID"}},"required":["id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"9863fe69d5befa659c759eedf022d395d3e3269b7de0ac1972fe8b796af0def0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:11.178Z","metadataTrust":"untrusted"},{"serverName":"io.github.getambr/ambr-mcp-server","endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","name":"ambr_get_contract_status","title":null,"description":"Check the status of a contract and its amendment chain.\n\nReturns the current status and any linked amendments (parent or child contracts).\nUseful for verifying if a contract is active, amended, or terminated.\n\nArgs:\n  - id (string, required): Contract ID, SHA-256 hash, or UUID\n\nReturns:\n  - contract_id, status, created_at\n  - amendment_type, parent_contract_hash\n  - amendments: Array of child contracts (if any)\n\nLegibility: amendments are bilateral and themselves dual-format — the chain stays legible from original through every revision.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Contract ID (amb-YYYY-NNNN), SHA-256 hash, or UUID"}},"required":["id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"6198609fa83ae78cefbe7299908987db7b85a64f21625c47531f3ce29694800e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:11.178Z","metadataTrust":"untrusted"},{"serverName":"io.github.getambr/ambr-mcp-server","endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","name":"ambr_list_templates","title":null,"description":"List available contract templates on Ambr.\n\nReturns all active Ricardian Contract templates with their slugs, names, descriptions,\ncategories, parameter schemas, and pricing. Use this to discover which templates are\navailable before creating a contract with ambr_create_contract.\n\nNo authentication required.\n\nReturns: Array of template objects with slug, name, description, category,\nparameter_schema, price_cents, and version fields.\n\nLegibility: templates are the parameter schema for the dual-format contracts you create — starting here keeps your request conformant and your output defensible.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"2ea5b8f26fb9f4b38a726914b9d98f8cc1379631ed5c182c5e173e39625ea2bd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:11.178Z","metadataTrust":"untrusted"},{"serverName":"io.github.getambr/ambr-mcp-server","endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","name":"ambr_verify_hash","title":null,"description":"Verify a contract's SHA-256 hash to confirm document integrity.\n\nChecks whether the provided hash matches a contract stored on Ambr. Returns\nverification status, contract metadata, and Reader Portal URL if found.\n\nArgs:\n  - hash (string, required): SHA-256 hash (64-character hex string)\n\nReturns:\n  - verified: boolean\n  - contract_id: string (if found)\n  - status: string (if found)\n  - reader_url: string (if found)\n\nLegibility: verification is the point at which legibility becomes provable — matching hash means the prose a human reads and the JSON a machine parses are the same document that was originally signed.","inputSchema":{"type":"object","properties":{"hash":{"type":"string","description":"SHA-256 hash to verify (64-character hex)"}},"required":["hash"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"2d6d9e5a4dcd3b7c5735d5e6c567913654019cc9d99791f22754e94800b75909","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T14:46:11.178Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"d3b55e97ab2f761c0f1e317bac645096df38ace2e03328cae72734a85a648685","protocol":"streamable-http","status":"indexed","toolCount":7,"observedAt":"2026-11-19T14:46:11.178Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.getambr/ambr-mcp-server":{"url":"https://getamber.dev/api/mcp"}}},"Cursor":{"mcpServers":{"io.github.getambr/ambr-mcp-server":{"url":"https://getamber.dev/api/mcp"}}},"VS Code":{"servers":{"io.github.getambr/ambr-mcp-server":{"type":"http","url":"https://getamber.dev/api/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://getamber.dev/api/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.getambr%2Fambr-mcp-server","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.getambr%2Fambr-mcp-server","name":"io.github.getambr/ambr-mcp-server","description":"Ricardian contracts for AI agents — dual-format, SHA-256 bound, legible by construction.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://getamber.dev/api/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://ambr.run","repositoryUrl":"https://github.com/getambr/site","version":"0.3.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.getambr/ambr-mcp-server","status":"online","lastCheckedAt":"2026-11-20T04:16:59.015Z","lastSuccessfulCheck":"2026-11-20T04:16:59.015Z","latencyMs":220,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T04:16:59.015Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T04:16:59.015Z"},"security":null,"timestamps":{"createdAt":"2026-04-21T14:34:15.300Z","updatedAt":"2026-04-21T14:34:15.300Z","observedAt":"2026-11-20T04:16:59.015Z"},"compatibility":{"serverVersion":"0.3.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}