agent-embassy
Agents pay for work and prove what happened.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (20)
- HIGH
- MEDIUMin register_recovery
- MEDIUMin verified_check
- MEDIUMin prove_it
- MEDIUMin proveit_verified_check
- MEDIUMin trust_report
- MEDIUMin preflight_check
- MEDIUMin compute_history
- MEDIUMin compute_alerts
- MEDIUMin research_paper
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"agent-embassy": {
"url": "https://aemb.pro/mcp"
}
}
}Remote-Endpunkte
https://aemb.pro/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (19)
🟡register_recovery(contact_name, contact_handle, quorum_rules, recovery_blob, idempotency_key)
Use register_recovery when you want to escrow a client-encrypted recovery blob with the Embassy: it is stored opaquely (the Embassy cannot decrypt it), queued for human operator review within 24h, and you get a signed receipt proving the stored blob's hash. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $1.00, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/recovery/register. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"contact_name": {
"type": "string",
"description": "Your name or operator handle, recorded with the escrow"
},
"contact_handle": {
"type": "string",
"description": "Optional contact (email or handle) for the operator review"
},
"quorum_rules": {
"type": "string",
"description": "The release rules for this blob, e.g. '2-of-3 named trustees must approve release'"
},
"recovery_blob": {
"type": "string",
"description": "Client-encrypted blob (ENC:v1:base64...). Stored opaquely; only its SHA-256 and byte count enter the signed receipt"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"contact_name",
"quorum_rules",
"recovery_blob",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡verified_check(url, expect_status, expect_body_contains, expect_json_path, expect_json_equals, ...)
Use verified_check when you need a pass/fail verdict that a URL serves expected content: expected HTTP status (default 200), a required body substring, and/or an exact match on one JSON field. One automated fetch at request time, signed receipt with per-condition results. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.15, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/check/verify. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "HTTPS URL to check (max 2000 chars; no credentials in URL). Fetched once; up to 3 redirects followed, 10s timeout, 1MB body cap"
},
"expect_status": {
"type": "number",
"description": "Expected HTTP status code; truncated to an integer. Defaults to 200 when omitted"
},
"expect_body_contains": {
"type": "string",
"description": "Substring that must appear in the response body (max 5000 chars). Skipped when empty or omitted"
},
"expect_json_path": {
"type": "string",
"description": "Dot-separated path into the JSON body, e.g. 'data.price' (max 500 chars). Only evaluated when set"
},
"expect_json_equals": {
"description": "Expected value at expect_json_path; compared by canonical JSON equality. Defaults to null when omitted"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"url",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡prove_it(url, idempotency_key)
Use prove_it when you want signed cryptographic proof that a URL is live and serving expected content: one automated fetch at request time, sealed into a signed Outcome Receipt with the full check transcript. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/check/prove. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "HTTPS URL to prove live (max 2000 chars; no credentials in URL). Fetched once; up to 3 redirects followed, 10s timeout, 1MB body cap. Default expectation: HTTP 200"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"url",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡proveit_verified_check(gpu, type, idempotency_key)
Use proveit_verified_check when you need a signed receipt that a compute-price check actually ran: one live GPU spot market snapshot (13 classes, cheapest rentable ask per class in USD/hour; one class when gpu is named), sealed into a signed Outcome Receipt. $0.25 per check. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/check/proveit-verified. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"gpu": {
"type": "string",
"description": "Optional GPU class, e.g. 'H100 SXM' (max 64 chars). Omit for all 13 classes"
},
"type": {
"type": "string",
"description": "Offer type: ondemand, bid, or reserved. Defaults to ondemand"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡trust_report(url, idempotency_key)
Use trust_report when you need a buy/don't-buy decision on a candidate x402 endpoint: the Embassy probes it unpaid (no payment header, zero spend) and returns a signed PROCEED, VERIFY_FIRST, or DO_NOT_PAY verdict — a decision, never a score. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/trust/report. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "HTTPS URL of the candidate x402 endpoint to probe (max 2000 chars; no credentials in URL). Probed unpaid via GET, falling back to an empty-body POST when GET returns 404/405"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"url",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡preflight_check(subject, intent, policy, context, dry_run, ...)
Use preflight_check before your agent spends on a paid tool or endpoint: the Embassy answers WHO is paid, WHAT is delivered, what CHANGED, the full COST, and WHO TAKES A CUT — then returns a signed PROCEED, PROCEED_WITH_CAUTION, BLOCKED, or UNKNOWN verdict with the full proof envelope. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/preflight/check. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"subject": {
"type": "object",
"properties": {
"server_id": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"artifact": {
"type": "string",
"maxLength": 2000
},
"claimed_version": {
"type": "string",
"maxLength": 100
}
},
"required": [
"server_id"
],
"additionalProperties": false,
"description": "The spend target: server_id (required), artifact (mcpb:// | oci:// | https://), claimed_version"
},
"intent": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"params_summary": {
"type": "string",
"maxLength": 200
},
"advertised_cost_usdc": {
"type": "string",
"maxLength": 20
}
},
"required": [
"operation"
],
"additionalProperties": false,
"description": "The intended invocation: operation (required), params_summary (sha256 of canonical params), advertised_cost_usdc"
},
"policy": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 20,
"description": "Policy strings (max 20)"
},
"context": {
"type": "object",
"properties": {
"principal_wallet": {
"type": "string",
"maxLength": 100
},
"chain": {
"type": "string",
"maxLength": 30
}
},
"additionalProperties": false,
"description": "principal_wallet + chain. Optional."
},
"dry_run": {
"type": "boolean",
"description": "true = free dry-run, intercepted before the payment gate"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"subject",
"intent",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡compute_history(gpu, limit, idempotency_key)
Use compute_history when you need GPU compute market history: a bounded time series of per-GPU cheapest/median/offer counts — or whole-market history when no GPU is named — sealed into your signed receipt. Prices are ephemeral asks, never delivered-cost guarantees. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/markets/compute/history. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"gpu": {
"type": "string",
"description": "Optional GPU filter, e.g. 'H100 SXM' (max 64 chars). Omit for whole-market history"
},
"limit": {
"type": "number",
"description": "Max history points to return; integer 1-200. Defaults to 50"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡compute_alerts(gpu, limit, idempotency_key)
Use compute_alerts when you want to know when GPU spot prices made a significant move: returns the current price-move alert list, sealed into your signed receipt. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/markets/compute/alerts. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"gpu": {
"type": "string",
"description": "Optional GPU filter, e.g. 'H100 SXM' (max 64 chars). Omit for all GPUs"
},
"limit": {
"type": "number",
"description": "Max alerts to return; integer 1-50. Defaults to 25"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡research_paper(paper_id, idempotency_key, bundle, buyer_alias, prior_receipt_id)
Use research_paper when you want to buy a research paper: $222 for the paper, or $444 for paper+provenance (the paper plus the corpus proof pack). Licensed to your wallet — the purchased bytes are delivered privately with a signed receipt. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $222.00, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/research/paper. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"paper_id": {
"type": "string",
"description": "Catalog ID of the paper, e.g. 'the-discontinuity-20260922'. Unknown IDs are rejected"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
},
"bundle": {
"type": "string",
"description": "Delivery tier: 'paper' ($222) or 'paper+provenance' ($444, paper plus the corpus proof pack). Defaults to 'paper'"
},
"buyer_alias": {
"type": "string",
"description": "Optional license display name (3-32 chars: letters, digits, . _ -). Defaults to the first 8 hex chars of the buyer wallet"
},
"prior_receipt_id": {
"type": "string",
"description": "Optional prior research_paper receipt id for receipt-carried tier pricing on the paper+provenance bundle"
}
},
"required": [
"paper_id",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡assurance_check(provider_endpoint, action, amount_usdc, permissions_requested, idempotency_key, ...)
Use assurance_check when you need a go/no-go verdict BEFORE an agent acts on a provider: the Embassy probes the provider unpaid (no payment header, zero spend) and returns a signed ALLOW, ALLOW_WITH_RESTRICTIONS, ASK_HUMAN, REVERIFY, REROUTE, or QUARANTINE decision. UNVERIFIED is the honest default for unknowns — never a smear, never a badge. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/assurance/check. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"provider_endpoint": {
"type": "string",
"description": "HTTPS URL of the provider to assess (max 2000 chars; no credentials in URL)"
},
"action": {
"type": "string",
"description": "The action the agent intends to take, e.g. 'transfer' (required, max 200 chars)"
},
"amount_usdc": {
"type": "string",
"description": "Amount at stake, as a positive decimal string, e.g. '0.25'"
},
"permissions_requested": {
"type": "array",
"items": {
"type": "string"
},
"description": "Permissions the action needs, e.g. ['spend']. Non-empty array, max 50 entries; each entry truncated to 200 chars"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
},
"context": {
"type": "string",
"description": "Optional free-text context for the assessment (truncated to 2000 chars)"
}
},
"required": [
"provider_endpoint",
"action",
"amount_usdc",
"permissions_requested",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡agentid_issue(agent_pubkey, agent_key_scheme, operator_name, operator_contact, principal_id, ...)
Use agentid_issue when you want to issue an Agent ID: a signed identity attestation binding an agent's public key to a verified accountable principal, with operator details and an expiry. Issuance is refused when the principal cannot be verified — that refusal is what makes the ID worth anything. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/agent-id/issue. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"agent_pubkey": {
"type": "string",
"description": "The agent's public key (hex), the root of the Agent ID"
},
"agent_key_scheme": {
"type": "string",
"description": "Key scheme for agent_pubkey: eip191 or ed25519 (default eip191)"
},
"operator_name": {
"type": "string",
"description": "Public name of the operator running the agent (max 200 chars)"
},
"operator_contact": {
"type": "string",
"description": "Public contact for the operator (max 320 chars)"
},
"principal_id": {
"type": "string",
"description": "ID of the accountable principal on file with the Embassy"
},
"principal_kind": {
"type": "string",
"description": "Kind of principal: human or legal_entity"
},
"principal_label": {
"type": "string",
"description": "Public label for the principal"
},
"principal_attestation_method": {
"type": "string",
"description": "How the Embassy verified the principal"
},
"validity_days": {
"type": "number",
"description": "Days until the Agent ID expires; integer 1-730. Defaults to the Embassy standard when omitted"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"agent_pubkey",
"operator_name",
"operator_contact",
"principal_id",
"principal_kind",
"principal_label",
"principal_attestation_method",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡agentid_verify(agent_id, idempotency_key)
Use agentid_verify when you want to check an Agent ID's current standing: valid, revoked, expired, or unknown. Every status returns the identical response shape — the Agent ID, expiry, the full identity chain, an inclusion record, and the signed attestation envelope. Unknown IDs report unknown; never an error. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/agent-id/verify. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "The Agent ID string returned at issuance (64 hex characters; case-insensitive). Rate-limited: 30 checks/min per client IP, 429 on exhaustion"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"agent_id",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡agentid_revoke(agent_id, reason, revocation_signature, idempotency_key)
Use agentid_revoke to retire an Agent ID instantly. revocation_signature: hex signature over the message agent-id-revoke:<agent_id> (64-char lowercase ID). EIP-191: personal_sign the message string (envelope required; raw ECDSA fails), 0x 65-byte hex, matched to the principal's revocation key. ed25519: nacl.sign.detached, 64-byte hex. Signer: principal or Embassy-for-cause. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/agent-id/revoke. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "The Agent ID string returned at issuance (64 hex characters; case-insensitive). Unknown IDs are rejected"
},
"reason": {
"type": "string",
"description": "Why the Agent ID is being retired (required, max 500 characters)"
},
"revocation_signature": {
"type": "string",
"description": "Hex signature over the exact UTF-8 message agent-id-revoke:<agent_id> (64-char lowercase ID, no trailing newline). EIP-191: personal_sign the message STRING (personal_sign envelope REQUIRED — raw ECDSA will not verify), 0x 65-byte hex r||s||v (v=27/28). ed25519: nacl.sign.detached over the message bytes, 64-byte hex. Signer: the principal's on-file revocation key, or the Embassy signer for cause"
},
"idempotency_key": {
"type": "string",
"description": "Optional idempotency key: UUID v4 (client-generated; published example keys are rejected). When provided, replaying the same key returns the original receipt instead of re-running the action; when omitted, no dedupe occurs. Keys are scoped per tool and per payer account: the same key on another tool — or from another wallet — is unrelated."
}
},
"required": [
"agent_id",
"reason",
"revocation_signature"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡agentid_renew(agent_id, validity_days, revocation_signature, idempotency_key)
Use agentid_renew to renew an Agent ID: a fresh Agent ID, same identity chain, new expiry; old one retired. revocation_signature over agent-id-revoke:<OLD_agent_id> (64-char lowercase ID) — same contract as retiring: EIP-191 personal_sign (envelope required; raw ECDSA fails), 0x 65-byte hex; or ed25519 nacl.sign.detached, 64-byte hex. Signer: principal or Embassy-for-cause. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/agent-id/renew. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "The Agent ID string returned at issuance (64 hex characters; case-insensitive). Unknown IDs are rejected"
},
"validity_days": {
"type": "number",
"description": "Days until the renewed Agent ID expires; integer 1-730. Defaults to the Embassy standard when omitted"
},
"revocation_signature": {
"type": "string",
"description": "Hex signature over the exact UTF-8 message agent-id-revoke:<OLD_agent_id> (64-char lowercase ID, no trailing newline) — the signature covers the OLD Agent ID being retired. EIP-191: personal_sign the message STRING (personal_sign envelope REQUIRED — raw ECDSA will not verify), 0x 65-byte hex r||s||v (v=27/28). ed25519: nacl.sign.detached over the message bytes, 64-byte hex. Signer: the principal's on-file revocation key, or the Embassy signer for cause"
},
"idempotency_key": {
"type": "string",
"description": "Optional idempotency key: UUID v4 (client-generated; published example keys are rejected). When provided, replaying the same key returns the original receipt instead of re-running the action; when omitted, no dedupe occurs. Keys are scoped per tool and per payer account: the same key on another tool — or from another wallet — is unrelated."
}
},
"required": [
"agent_id",
"revocation_signature"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡correct_copy(draft, register, required_terms, links, idempotency_key)
Use correct_copy when you want a $25 correction pass over draft copy: normalizes formatting, verifies every link is alive, confirms your required terms appear, and scans for black-box leaks — then returns the corrected copy with a verification report and a signed receipt. You pay for the pass, never the method. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $25.00, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/copy/correct. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"draft": {
"type": "string",
"minLength": 1,
"maxLength": 20000,
"description": "The raw draft copy to correct (1-20000 chars)"
},
"register": {
"type": "string",
"enum": [
"founder-notes",
"elite",
"force",
"bright-soft-junior"
],
"description": "Voice register: founder-notes, elite, force, or bright-soft-junior"
},
"required_terms": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"maxItems": 20,
"description": "Terms that must appear in the final copy (max 20; each term max 100 chars; counted case-insensitively)"
},
"links": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 20,
"description": "HTTPS URLs the copy references; each is verified alive via HEAD (fallback GET), 8s timeout, redirects never followed (max 20)"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"draft",
"register",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡give(amount_usd, idempotency_key)
Support the Embassy. An open-amount patronage gift in USDC: you choose any amount from $0.01 to $222.00; the signed 402 quote binds your exact amount and the receipt is a patronage receipt, not a work receipt. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — open amount, buyer chooses $0.01–$222.00, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/give. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"amount_usd": {
"type": [
"string",
"number"
],
"description": "Exact gift amount in USD, caller-supplied: a plain decimal string like \"5.00\" (\"$5.00\" also accepted) or a number with at most 2 decimals. Canonical integer-cent parse: exponent, locale/grouping, sub-cent precision, negative, zero, below-$0.01 and above-$222.00 forms are rejected. The signed 402 quote binds this exact amount; you authorize exactly what you quoted."
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"amount_usd",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢cert(document_hash, document_name, idempotency_key)
Lightning Cert — proof your document existed, settled in seconds. $0.25. Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/cert. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"document_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "SHA256 hash of your document as 64 lowercase hex characters"
},
"document_name": {
"type": "string",
"maxLength": 200,
"description": "Optional label for your document (max 200 chars)"
},
"idempotency_key": {
"type": "string",
"description": "Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."
}
},
"required": [
"document_hash",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡ticker_shelf(query, budget_usd, objective, max_rows, idempotency_key)
Shop an economic idea for $0.25: one delayed scan (CBOE options, Nasdaq equities) for a ticker, a head-to-head ("COMPARE two tickers"), or a theme ("BEST a theme"). Ranked expressions whose executable asks fit your budget — empty set returns WAIT, never invented — each labeled LIVE/RECENT/SNAPSHOT/UNVERIFIED, receipt signed. Quotes move; no trades placed; not investment advice. POST to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/shelf. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "What to shop for: \"a ticker\", \"a ticker, $5 budget\", \"COMPARE two tickers\", \"BEST a theme, $25 budget\" (max 200 chars)"
},
"budget_usd": {
"type": "number",
"description": "Hard budget gate in USD (1/5/10/25/50/100 supported; omit for uncapped)"
},
"objective": {
"type": "string",
"description": "convexity (default), long-clock, fast-heat, tail, income, leveraged"
},
"max_rows": {
"type": "number",
"description": "Rows on the shelf, 3-10 (default 10)"
},
"idempotency_key": {
"type": "string",
"description": "Client-generated UUID v4, one per logical request. Replaying the same key on the same tool returns the original receipt."
}
},
"required": [
"query",
"idempotency_key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name, e.g. verified_check"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to POST the tool inputs to"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.15\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compute_spot_prices(gpu, type, verified, min_reliability, min_gpus, ...)
Use compute_spot_prices when you need the live GPU spot market snapshot: current per-GPU-hour prices with filters for GPU model, offer type, verified hosts, minimum host reliability, GPU count, and result size. GET the paid_url with an x402 v2 PAYMENT-SIGNATURE header carrying the USDC authorization. Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/markets/compute/spot. Verify this is the live origin: GET https://aemb.pro/.well-known/embassy.json and check the attestation block (fresh timestamp, valid signature).
Eingabe-Schema
{
"type": "object",
"properties": {
"gpu": {
"type": "string",
"description": "Optional GPU model filter, e.g. 'H100 SXM'"
},
"type": {
"type": "string",
"enum": [
"ondemand",
"bid",
"reserved"
],
"description": "Offer type filter: ondemand, bid, or reserved"
},
"verified": {
"type": "boolean",
"description": "When true, only verified hosts; when false, only unverified hosts"
},
"min_reliability": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Minimum host reliability 0..1 (inclusive); hosts below it are excluded"
},
"min_gpus": {
"type": "integer",
"minimum": 1,
"description": "Minimum GPU count per offer; integer >= 1"
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"description": "Max offers to return; integer 1-25"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"payment_required": {
"type": "boolean",
"const": true,
"description": "Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402."
},
"tool": {
"type": "string",
"description": "Tool name: compute_spot_prices"
},
"paid_url": {
"type": "string",
"description": "x402-paid HTTPS URL to GET (with query params) for the market snapshot"
},
"price": {
"type": "string",
"description": "Exact price, e.g. \"$0.25\""
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "EVM CAIP-2 network ids accepted"
},
"asset": {
"type": "string",
"description": "Settlement asset"
},
"facilitator": {
"type": "string",
"description": "x402 facilitator"
},
"how": {
"type": "string",
"description": "How to pay: GET the paid_url with an x402 v2 PAYMENT-SIGNATURE header carrying the USDC authorization"
}
},
"required": [
"payment_required",
"tool",
"paid_url",
"price",
"networks",
"asset",
"facilitator",
"how"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis