agentx402-mcp-server

Policy-gated, receipt-backed x402 execution for AI agents — ShadeGuard before funds move, TEE-attested runs, verifiable proof. Thin stdio wrapper for the live YieldAgentX402 MCP endpoint.

Proof: 16 tools · 18 chains · no custody · signed receipts on every call.

Docs · Try without signup · Get API Key · What is x402?

Try it now (no signup)

The yax_get_capabilities tool is public — you can discover everything before you ever sign up.

curl -X POST https://api.yieldagentx402.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"yax_get_capabilities","arguments":{}}}'

Returns: differentiators (pitch), proof_points (16 tools · 18 chains · no custody · signed receipts), security posture, and live infra status.

Install (1 minute)

Works with Claude Desktop, Claude Code, Cursor, Windsurf, Zed, and any MCP 2025-03-26 stdio client.

{
  "mcpServers": {
    "yieldagentx402": {
      "command": "npx",
      "args": ["-y", "agentx402-mcp-server"],
      "env": {
        "YAX_API_KEY": "yax_live_...",
        "YAX_AGENT_ID": "optional-agent-id"
      }
    }
  }
}

Get an API key at https://yieldagentx402.app/apply (or call POST /api/agent-onboard for instant demo credentials).

Tools (16) — 4 categories

| Category | Tools | |---|---| | Discovery (public, no auth) | yax_get_capabilities | | Wallet & custody | yax_get_wallet_status — returns Shade Agent MPC addresses on EVM + BTC + Starknet | | Execution | yax_run_secure_workflow, yax_process_x402_payment | | Policy & governance | yax_check_policy, yax_run_compliance_monitor, yax_get_attestation | | Receipts & audit | yax_get_receipt, yax_verify_receipt, yax_list_runs | | Workflows | yax_score_leads, yax_enrich_lead_data, yax_build_email_sequence, yax_monitor_churn_risk, yax_collect_ar_invoices, yax_forecast_cash_flow |

Every tool call is:

• ShadeGuard-policy-checked before execution
• TEE-attested (Intel TDX, NEAR AI Cloud — mrEnclave verifiable at /api/tee/report)
• Receipt-backed (HMAC-SHA256 over canonical JSON)
• Filecoin + BTFS anchored when uploads succeed
• Routed across 18 networks including Base, Ethereum, Bitcoin (native), Starknet, NEAR, Solana, Stacks, BNB, Rootstock, Filecoin, Aptos, Sui, TON, Tron, XRPL, Stellar, Algorand

Custody-free wallet — one MPC key, three chains

The Shade Agent (NEAR chain signatures) derives payment addresses on demand — no private keys held anywhere.

| Chain | Address | Mode | |---|---|---| | EVM (Base/Eth) | 0x6905D04C3655625F6171f7b1e801a9325B1Fa1e8 | MPC-signed | | Bitcoin (P2WPKH) | bc1qcd8ljsj7x0rq3sw7drrt7ragqmmt3tfsfxs6gy | MPC-signed | | Starknet | 0x003a4e08…570906a21 | Stark curve, preset |

Live manifest: https://shade-agent-worker.cryptoblac.workers.dev/api/wallet

Configuration

| Env var | Required | Default | |---|---|---| | YAX_API_KEY | Yes (for non-public tools) | — | | YAX_AGENT_ID | No | — | | YAX_MCP_ENDPOINT | No | https://api.yieldagentx402.app/mcp | | YAX_API_BASE | No | (sets endpoint if YAX_MCP_ENDPOINT unset) |

Registry

• npm: agentx402-mcp-server (this package)
• Smithery: fabianjefferson2/agentx402-mcp-server — direct gateway listing
• Remote endpoint: https://api.yieldagentx402.app/mcp (Streamable HTTP, MCP 2025-03-26)
• x402scan: server/ddec8170… — 34 resources, live transactions
• ERC-8004 on Base: #21702 (separate from Stacks #32 / TRON #1)
• Status: api.yieldagentx402.app/api/status

Development

npm install
npm run build
npm start

The package is intentionally thin. Tool discovery and tool calls are provided by the public YieldAgentX402 MCP endpoint, so the local package stays truthful as the hosted server evolves.

License

MIT