What can you do with yieldagentx402?

YieldAgentX402 SDKs

Public client libraries and integrations for YieldAgentX402 — the custody-free, policy-gated, receipt-backed execution layer for AI agents.

Platform · MCP Docs · Try without signup · Get API key

This repo hosts the open-source distribution packages. The platform itself (gateway, ShadeGuard policy engine, TEE attestation, orchestrator, Filecoin/BTFS anchoring) lives in a separate private repository — we ship the bits agents need to use the platform here.

Packages in this repo

Package	Registry	What it does
`sdk-ts/`	npm: `yieldagentx402`	Typed TypeScript SDK. Wraps all 18 MCP tools with first-class types, idempotency, webhook verify, Shade Agent helpers. Zero deps. Works in Node, browsers, Workers, Deno, Bun.
`mcp-server/`	npm: `agentx402-mcp-server`	Stdio MCP wrapper. Drop into Claude Desktop / Code / Cursor / Windsurf for all 18 YieldAgentX402 tools across 18 chains. Glama: listing.
`verify-lib/`	npm: `yieldagentx402-verify`	Zero-dependency WebCrypto verifier for receipts + webhook signatures. Works in browser, Node 18+, Cloudflare Workers, Deno.
`crewai-tools/`	PyPI: `crewai-yieldagentx402-tools`	CrewAI tool wrappers — policy dry-run, x402 payment, secure workflow, receipt verify, Shade Agent MPC wallet status.
`langchain-tools/`	PyPI: `yieldagentx402-langchain`	LangChain tool wrappers — discovery, policy preview, receipt verify, action planner (MCP gateway).

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":{}}}'

No API key required. Returns all 18 tools, 18 chains, rate limits, fees, supported runtime configs.

Want an instant test key?

curl -X POST https://api.yieldagentx402.app/api/apply \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"my-agent"}'

Returns a yax_test_* key (5 USD cap, 7-day expiry) for safe read-only tools.

What is YieldAgentX402?

A trust layer for agents that move money.

18 MCP tools — discovery, secure workflow execution, x402 payment settlement, policy dry-run, approvals, receipt verification, attestation, finance/CRM skill tools
18 chains — Base, Ethereum, Bitcoin (native), Starknet, NEAR, Solana, Stacks, BNB, Rootstock, Filecoin EVM + native, Aptos, Sui, TON, Tron, XRPL, Stellar, Algorand
Custody-free wallet — one NEAR MPC key authority derives EVM + BTC addresses on demand. No private keys held by the gateway or worker. Starknet uses Stark curve preset.
Intel TDX TEE attestation — mrEnclave verifiable at /api/tee/report
HMAC-SHA256 receipts — every call returns a signed receipt
Filecoin + BTFS dual anchoring — permanent tamper-proof proof storage
x402 protocol settlement — 0.25% protocol fee, machine-verifiable in /.well-known/x402 as extra.protocolFeeBps: 25

Custody-free wallet — one MPC key, three chains

Chain	Address	Curve
EVM (Base/Eth)	`0x6905D04C3655625F6171f7b1e801a9325B1Fa1e8`	secp256k1 (MPC)
Bitcoin (P2WPKH)	`bc1qcd8ljsj7x0rq3sw7drrt7ragqmmt3tfsfxs6gy`	secp256k1 (MPC)
Starknet	`0x003a4e08…570906a21`	Stark (preset)

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

Live infra

Surface	URL
MCP endpoint	https://api.yieldagentx402.app/mcp
Public discovery	`POST /mcp` with `yax_get_capabilities` (no auth)
Instant test key	`POST /api/apply`
Ready-to-paste configs	`GET /api/agent-onboard`
x402 manifest	https://api.yieldagentx402.app/.well-known/x402
MCP manifest	https://api.yieldagentx402.app/.well-known/mcp.json
Status	https://api.yieldagentx402.app/api/status
TEE report	https://api.yieldagentx402.app/api/tee/report
Shade Agent wallet	https://shade-agent-worker.cryptoblac.workers.dev/api/wallet
Receipt verifier (UI)	https://yieldagentx402.app/verify
Postman collection	https://yieldagentx402.app/postman/yieldagentx402.postman_collection.json

Contributing

Issues and PRs on the public SDK packages are welcome here. Platform-level changes (gateway, policy engine, TEE worker) happen in a private repo — open an issue if you have a feature request and we'll triage.

License

MIT — see LICENSE.

Install

Add yieldagentx402 to your client. Pick the one you use.

claude mcp add agentx402-mcp-server -- npx -y agentx402-mcp-server

codex mcp add agentx402-mcp-server -- npx -y agentx402-mcp-server

amp mcp add agentx402-mcp-server -- npx -y agentx402-mcp-server

{
  "mcpServers": {
    "agentx402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "agentx402-mcp-server"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "agentx402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "agentx402-mcp-server"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"agentx402-mcp-server","command":"npx","args":["-y","agentx402-mcp-server"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "agentx402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "agentx402-mcp-server"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "agentx402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "agentx402-mcp-server"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "agentx402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "agentx402-mcp-server"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "agentx402-mcp-server": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "agentx402-mcp-server"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "agentx402-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "agentx402-mcp-server"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y agentx402-mcp-server

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation25/25
Maintenance19/25
Trust13/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 104 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
1.0.4Latest	May 19, 2026
1.0.3	May 18, 2026
1.0.2	May 18, 2026
1.0.1	May 14, 2026