agentx402-mcp-server

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