{
  "name": "AsterPay",
  "description": "Trust, discovery, and fiat settlement layer for AI agent commerce. Three layers: (1) KYA trust scoring 0-100, (2) Merchant Payment Endpoint — resolve a VAT or registry identifier to the IBAN/BIC on file for a registered merchant, (3) USDC/EURC to EUR settlement via SEPA Instant. USD (ACH) and GBP (Faster Payments) are on the roadmap.",
  "url": "https://x402.asterpay.io",
  "provider": {
    "organization": "AELIRA LTD",
    "url": "https://asterpay.io"
  },
  "version": "3.1.0",
  "specVersion": "1.3",
  "serviceVersion": "3.1.0",
  "documentationUrl": "https://asterpay.io/docs",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "x402": true,
    "mpp": true,
    "fiatSettlement": true,
    "merchantDiscovery": true,
    "agentTrustScoring": true,
    "prepaidAgentBudgets": true
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "check-trust-score",
      "name": "Layer 1 — Check Agent Trust Score (KYA)",
      "description": "Score any AI agent 0-100. Identity (ERC-8004), wallet history, sanctions screening (Chainalysis), third-party attestations. Higher trust = higher payment limits.",
      "tags": [
        "trust",
        "identity",
        "KYA",
        "sanctions",
        "ERC-8004",
        "compliance"
      ],
      "examples": [
        "Check trust score for 0xd8dA...96045",
        "Is this agent sanctioned?",
        "What tier is this wallet?"
      ]
    },
    {
      "id": "merchant-discovery",
      "name": "Layer 2 — Merchant Payment Endpoint (MPE)",
      "description": "The agent has an identifier for the business but not where to send money. GET /v1/mpe/merchants/resolve takes a VAT or company-registry identifier (business_id + business_id_type) or an AsterPay merchant_id and returns the IBAN/BIC on file for merchants registered with AsterPay. POST /v1/mpe/settle additionally accepts a domain (read from its /.well-known/pay.json) or a structured UBL/CII e-invoice URL. Company-name search is not supported. The IBAN is structure- and checksum-checked; bank-side PSD2 Verification of Payee (account-holder name matching) runs at payout with the licensed settlement partner, not here.",
      "tags": [
        "discovery",
        "MPE",
        "merchant",
        "IBAN",
        "VAT",
        "payment-details"
      ],
      "examples": [
        "Resolve the IBAN on file for VAT FI12345678",
        "Look up payment details for AsterPay merchant id mpe-demo-0001",
        "Read payment details from a domain's /.well-known/pay.json"
      ]
    },
    {
      "id": "settle-to-eur",
      "name": "Layer 3 — Fiat Settlement",
      "description": "Agent pays in digital dollars. AsterPay converts to EUR and sends an instant SEPA bank transfer in under 10 seconds today. USD (ACH) and GBP (Faster Payments) are on the roadmap (Q4 2026).",
      "tags": [
        "payments",
        "settlement",
        "EUR",
        "SEPA",
        "stablecoin",
        "off-ramp",
        "x402",
        "fiat"
      ],
      "examples": [
        "Settle 100 USDC to EUR for Acme GmbH",
        "Get settlement estimate for 500 USDC",
        "Convert EURC to EUR via SEPA Instant"
      ]
    },
    {
      "id": "prepaid-budget",
      "name": "Prepaid Agent Budget (/budget)",
      "description": "Give an agent spending money with a hard cap. One USDC transfer (1-500 USDC on Base, 1:1 credit, no platform fee) becomes a prepaid budget token the agent spends per call across every paid AsterPay endpoint. Funding wallet screened against the Chainalysis Sanctions Oracle before issuance. No API key, no card on file, no KYC. Valid 90 days, rollover on request. Setup: claude mcp add asterpay -- npx -y @asterpay/mcp-server — /budget is a native slash command in Claude Code.",
      "tags": [
        "budget",
        "spending-limit",
        "prepaid",
        "x402",
        "USDC",
        "hard-cap",
        "MCP"
      ],
      "examples": [
        "/budget 25",
        "Give my agent a $10 spending budget",
        "How much budget does my agent have left?"
      ]
    },
    {
      "id": "data-doors",
      "name": "Layer 4 — Official-source data feeds (33 doors)",
      "description": "Pay-per-call data behind x402/MPP: Stablecoins and crypto, Energy, Company checks, FX, Macro, World risk, Security feeds. 29 paid ($0.001-$0.005 USDC), 4 free. Every response carries source, observed_at (upstream timestamp), cadence and stale. Catalog: GET https://x402.asterpay.io/v1/data.",
      "tags": [
        "data",
        "fx",
        "energy",
        "macro",
        "stablecoins",
        "security",
        "vat",
        "risk",
        "x402",
        "mpp"
      ],
      "examples": [
        "What is the ECB EUR/USD reference rate today?",
        "Current Brent and WTI spot and the EIA 18-month forecast",
        "Which US banks failed this year?",
        "Is any major stablecoin off its peg?",
        "Show the World Risk Board"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "paths": [
        "/v1/data/crypto/fear-greed",
        "/v1/data/crypto/hacks",
        "/v1/data/stablecoins/peg",
        "/v1/data/stablecoins/supply",
        "/v1/data/energy/crude-imports",
        "/v1/data/energy/electricity-retail/{state}",
        "/v1/data/energy/natgas",
        "/v1/data/energy/nuclear-outages",
        "/v1/data/energy/oil",
        "/v1/data/energy/steo-forecast",
        "/v1/data/energy/us-energy-overview",
        "/v1/data/energy/us-grid",
        "/v1/data/company/vat/{vatId}",
        "/v1/data/fx/ecb",
        "/v1/data/fx/pair/{base}/{quote}",
        "/v1/data/macro/bank-failures",
        "/v1/data/macro/inflation/{region}",
        "/v1/data/macro/rates",
        "/v1/data/macro/recession",
        "/v1/data/macro/us-debt",
        "/v1/data/risk/agi",
        "/v1/data/risk/ai-extinction",
        "/v1/data/risk/asteroids",
        "/v1/data/risk/board",
        "/v1/data/risk/climate",
        "/v1/data/risk/doomsday-clock",
        "/v1/data/risk/earthquakes",
        "/v1/data/risk/markets",
        "/v1/data/risk/outbreaks",
        "/v1/data/risk/space-weather",
        "/v1/data/security/cve-critical",
        "/v1/data/security/kev",
        "/v1/data/security/ransomware"
      ]
    }
  ],
  "authentication": {
    "schemes": [
      "x402",
      "MPP"
    ],
    "signatureScheme": "ECDSA-SHA256"
  },
  "paymentRail": {
    "format": "JSON-LD",
    "endpoint": "https://x402.asterpay.io/.well-known/x402.json",
    "mcpTool": "get_payment_rail",
    "propagation": "auto"
  },
  "mcp": {
    "_note": "Two remote servers with declared roles, listed in full at https://asterpay.io/.well-known/mcp.json. Same protocol, different tool surface: mcp.remote is the small read-only connector, mcp.full_api exposes every tool including the paid endpoints. Pick full_api unless a client needs the minimal surface.",
    "remote": {
      "url": "https://mcp-api.asterpay.io/mcp",
      "transport": "streamable-http",
      "role": "remote-connector",
      "authentication": "none",
      "readOnly": true,
      "session": "initialize handshake required, mcp-session-id header on later calls",
      "tools": [
        "check_agent_trust",
        "settlement_estimate",
        "market_rates",
        "merchant_resolve"
      ],
      "description": "First-party remote MCP server (read-only, 4 tools). Works as a remote connector in OpenAI Responses API, Claude.ai/Desktop, Gemini ADK, VS Code and other MCP clients without a local install."
    },
    "full_api": {
      "url": "https://x402.asterpay.io/mcp",
      "transport": "streamable-http",
      "role": "full-api",
      "authentication": "none",
      "readOnly": true,
      "session": "none: tools/list and tools/call work without an initialize handshake",
      "tools": [
        "check_agent_trust",
        "verify_agent_identity",
        "get_agent_tier",
        "agent_deep_analysis",
        "settlement_estimate",
        "get_crypto_price",
        "get_trending",
        "ai_summarize",
        "ai_sentiment",
        "ai_fact_check",
        "ai_translate",
        "ai_code_review",
        "wallet_score",
        "token_analysis",
        "whale_alerts",
        "generate_qr_code",
        "discover_endpoints",
        "data_catalog",
        "data_get",
        "risk_board"
      ],
      "description": "API-host MCP server: every AsterPay tool including the paid endpoints, over the same streamable-http transport. This is the server /v1/agent/discovery points at."
    },
    "local": {
      "package": "@asterpay/mcp-server",
      "registry": "https://www.npmjs.com/package/@asterpay/mcp-server",
      "setup": "npx -y @asterpay/mcp-server",
      "description": "Local stdio MCP server for Claude Code, Cursor and other local clients. Adds commerce tools (prepaid /budget, merchant discovery, orders) plus agent_pay and get_payment_rail."
    }
  },
  "endpoints": {
    "metered_free": {
      "_note": "Free up to 25 unpaid calls per client IP per UTC day (X-Free-Quota-Remaining header). Above that the endpoint answers 402 and the stated x402/MPP price applies. A wallet that has never paid AsterPay gets its first paid call free.",
      "trust_score": {
        "method": "GET",
        "path": "/v1/agent/trust-score/{address}",
        "url": "https://x402.asterpay.io/v1/agent/trust-score/{address}",
        "description": "Full trust assessment for any wallet address",
        "authentication": "none within quota, x402 or mpp above it",
        "price": "free up to 25/day per IP, then $0.005 USDC"
      },
      "verify": {
        "method": "GET",
        "path": "/v1/agent/verify/{address}",
        "url": "https://x402.asterpay.io/v1/agent/verify/{address}",
        "description": "Quick identity verification",
        "authentication": "none within quota, x402 or mpp above it",
        "price": "free up to 25/day per IP, then $0.005 USDC"
      },
      "tier": {
        "method": "GET",
        "path": "/v1/agent/tier/{address}",
        "url": "https://x402.asterpay.io/v1/agent/tier/{address}",
        "description": "Trust tier classification (open/verified/trusted/enterprise)",
        "authentication": "none within quota, x402 or mpp above it",
        "price": "free up to 25/day per IP, then $0.005 USDC"
      },
      "settlement_estimate": {
        "method": "GET",
        "path": "/v1/settlement/estimate?amount={usdc_amount}",
        "url": "https://x402.asterpay.io/v1/settlement/estimate",
        "description": "EUR settlement estimate with fees and rate",
        "authentication": "none within quota, x402 or mpp above it",
        "price": "free up to 25/day per IP, then $0.005 USDC"
      },
      "offramp_estimate": {
        "method": "GET",
        "path": "/v2/x402/offramp/estimate?amount={usdc_amount}",
        "url": "https://x402.asterpay.io/v2/x402/offramp/estimate",
        "description": "USDC to EUR settlement estimate with rate, fees and SEPA Instant delivery time",
        "authentication": "none within quota, x402 or mpp above it",
        "price": "free up to 25/day per IP, then $0.005 USDC"
      }
    },
    "free": {
      "discovery": {
        "method": "GET",
        "path": "/v1/agent/discovery",
        "url": "https://x402.asterpay.io/v1/agent/discovery",
        "description": "Discover all available AsterPay endpoints and capabilities",
        "authentication": "none",
        "price": "free"
      },
      "budget_info": {
        "method": "GET",
        "path": "/v1/budget/info",
        "url": "https://x402.asterpay.io/v1/budget/info",
        "description": "Prepaid budget limits, pay-to address, expiry policy, setup instructions",
        "authentication": "none",
        "price": "free"
      },
      "budget_create": {
        "method": "POST",
        "path": "/v1/budget/create",
        "url": "https://x402.asterpay.io/v1/budget/create",
        "description": "Create a prepaid budget from a USDC deposit (on-chain verify + sanctions screen), returns bud_ token",
        "authentication": "none",
        "price": "free"
      },
      "budget_status": {
        "method": "GET",
        "path": "/v1/budget/status",
        "url": "https://x402.asterpay.io/v1/budget/status",
        "description": "Remaining balance, spend log, and expiry for an active budget (X-Budget-Token header)",
        "authentication": "X-Budget-Token",
        "price": "free"
      },
      "market_rates": {
        "method": "GET",
        "path": "/v2/x402/market/rates",
        "url": "https://x402.asterpay.io/v2/x402/market/rates",
        "description": "Real-time crypto market rates and FX data",
        "authentication": "none",
        "price": "free"
      },
      "mpe_resolve": {
        "method": "GET",
        "path": "/v1/mpe/merchants/resolve?business_id={vat}&business_id_type=vat",
        "url": "https://x402.asterpay.io/v1/mpe/merchants/resolve",
        "description": "Resolve a merchant VAT or company-registry identifier to IBAN/BIC. Company-name search is not supported. ?merchant_id={id} also works.",
        "authentication": "none",
        "price": "free"
      },
      "data_catalog": {
        "method": "GET",
        "path": "/v1/data",
        "url": "https://x402.asterpay.io/v1/data",
        "description": "Catalog of every data door: price, source, licence, cadence, params",
        "authentication": "none",
        "price": "free"
      },
      "session_packages": {
        "method": "GET",
        "path": "/v1/sessions/packages",
        "url": "https://x402.asterpay.io/v1/sessions/packages",
        "description": "Prepaid session credit packages and which endpoints they cover",
        "authentication": "none",
        "price": "free"
      },
      "framework": {
        "method": "GET",
        "path": "/v1/agent/framework",
        "url": "https://x402.asterpay.io/v1/agent/framework",
        "description": "KYA framework documentation: the layers, inputs and scoring",
        "authentication": "none",
        "price": "free"
      },
      "audit": {
        "method": "GET",
        "path": "/v1/agent/audit/{address}",
        "url": "https://x402.asterpay.io/v1/agent/audit/{address}",
        "description": "KYA audit snapshot: inputs and score breakdown for third-party verification",
        "authentication": "none",
        "price": "free"
      }
    },
    "paid_x402": {
      "_note": "Named highlights only. The complete generated list of every priced route (56 as of 10.9.2026, including all data doors) is https://x402.asterpay.io/.well-known/x402 — that document is built from the same pricing registry the paywall charges from, so it can never advertise a route the API does not serve.",
      "deep_analysis": {
        "method": "GET",
        "path": "/v1/agent/deep-analysis/{address}",
        "url": "https://x402.asterpay.io/v1/agent/deep-analysis/{address}",
        "description": "Comprehensive agent behavioral analysis with risk scoring",
        "authentication": "x402+mpp",
        "price": "$0.01 USDC"
      },
      "crypto_prices": {
        "method": "GET",
        "path": "/v2/x402/crypto/prices",
        "url": "https://x402.asterpay.io/v2/x402/crypto/prices",
        "description": "Live cryptocurrency price feeds",
        "authentication": "x402+mpp",
        "price": "$0.005 USDC"
      },
      "ai_sentiment": {
        "method": "GET",
        "path": "/v2/x402/ai/sentiment",
        "url": "https://x402.asterpay.io/v2/x402/ai/sentiment",
        "description": "AI-powered market sentiment analysis",
        "authentication": "x402+mpp",
        "price": "$0.01 USDC"
      },
      "offramp_quote": {
        "method": "POST",
        "path": "/v2/x402/offramp/quote",
        "url": "https://x402.asterpay.io/v2/x402/offramp/quote",
        "description": "Binding USDC/EURC to EUR quote: rate, fees, SEPA Instant delivery window",
        "authentication": "x402+mpp",
        "price": "$0.005 USDC"
      },
      "agent_readiness": {
        "method": "GET",
        "path": "/v2/x402/agent-readiness?url={website}",
        "url": "https://x402.asterpay.io/v2/x402/agent-readiness",
        "description": "Agent-readiness scan of any website: MCP, agent.json, llms.txt, OpenAPI, JSON-LD, x402",
        "authentication": "x402+mpp",
        "price": "$0.02 USDC"
      },
      "fact_check": {
        "method": "POST",
        "path": "/v2/x402/ai/fact-check",
        "url": "https://x402.asterpay.io/v2/x402/ai/fact-check",
        "description": "Claim verification with sources (deep variant at /fact-check/deep, $0.05)",
        "authentication": "x402+mpp",
        "price": "$0.01 USDC"
      },
      "data_door_example": {
        "method": "GET",
        "path": "/v1/data/fx/ecb",
        "url": "https://x402.asterpay.io/v1/data/fx/ecb",
        "description": "One of 33 metered data doors (FX, energy, macro, stablecoins, crypto, security, risk), $0.001 to $0.005 each. Every response carries the upstream observed_at, cadence and a stale flag. Free catalog of every door and its price: /v1/data.",
        "authentication": "x402+mpp",
        "price": "$0.002 USDC"
      }
    }
  },
  "supportedChains": [
    "base",
    "ethereum",
    "polygon",
    "arbitrum",
    "optimism",
    "skale-base"
  ],
  "plannedChains": [
    {
      "name": "tempo",
      "status": "preview",
      "note": "Tempo L1 (Stripe + Paradigm). Mainnet live since March 2026; AsterPay settlement on Tempo not yet live."
    },
    {
      "name": "solana",
      "status": "planned"
    },
    {
      "name": "xrpl",
      "status": "planned"
    }
  ],
  "supportedTokens": [
    "USDC",
    "EURC",
    "EURCV"
  ],
  "settlementCurrencies": [
    "EUR"
  ],
  "settlementRails": [
    "SEPA Instant"
  ],
  "plannedSettlementCurrencies": [
    {
      "currency": "USD",
      "rail": "ACH",
      "status": "roadmap",
      "eta": "Q4 2026"
    },
    {
      "currency": "GBP",
      "rail": "Faster Payments",
      "status": "roadmap",
      "eta": "Q4 2026"
    }
  ],
  "protocols": [
    "x402",
    "x402r",
    "MPP",
    "AP2",
    "A2A",
    "ERC-8004",
    "ERC-8183",
    "MCP"
  ],
  "identity": {
    "erc8004": {
      "agentId": 16850,
      "registry": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
      "chain": "base",
      "explorer": "https://basescan.org/nft/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432/16850"
    }
  },
  "network": {
    "program": "ecosystem_integration_partners",
    "description": "Public ecosystem / integration partner listings only. Not co-founders of AsterPay (operator: AELIRA LTD). Free listing program — apply at asterpay.io/partners",
    "ecosystem_partners": [
      "InsumerAPI",
      "Drip",
      "Circle Alliance",
      "ClawHub OpenClaw",
      "x402 Bazaar CDP",
      "Invoica"
    ],
    "partner_count": 6,
    "open_program": true,
    "apply": "https://asterpay.io/partners/",
    "ecosystem_page": "https://asterpay.io/ecosystem/"
  },
  "trust": {
    "signals": [
      {
        "type": "onchain_credentials",
        "provider": "asterpay-kya",
        "endpoint": "https://x402.asterpay.io/v1/agent/verify/{address}",
        "description": "ERC-8004 agent identity verification"
      },
      {
        "type": "onchain_activity",
        "provider": "asterpay-kya",
        "endpoint": "https://x402.asterpay.io/v1/agent/trust-score/{address}",
        "description": "Composite trust score (0-100) based on wallet history, activity, and identity"
      },
      {
        "type": "behavioral",
        "provider": "asterpay-kya",
        "endpoint": "https://x402.asterpay.io/v1/agent/deep-analysis/{address}",
        "description": "Deep behavioral analysis with velocity scoring (paid, x402)"
      }
    ]
  },
  "links": {
    "website": "https://asterpay.io",
    "docs": "https://asterpay.io/docs",
    "github": "https://github.com/AsterPay",
    "twitter": "https://x.com/Asterpayment",
    "npm": "https://www.npmjs.com/package/@asterpay/mcp-server",
    "pypi": "https://pypi.org/project/asterpay/",
    "mcp_remote": "https://mcp-api.asterpay.io/mcp",
    "well_known_x402": "https://x402.asterpay.io/.well-known/x402",
    "partner_program": "https://asterpay.io/partners/",
    "ecosystem_directory": "https://asterpay.io/ecosystem/"
  }
}