Fabio662/yieldagentx402-sdks
๐ โ๏ธ - Custody-free, policy-gated, receipt-backed execution layer for AI agents. 16 MCP tools across 18 chains (Base, Ethereum, Bitcoin native, Starknet, NEAR, Solana, Stacks, BNB, Rootstock, Filecoin, Aptos, Sui, TON, Tron, XRPL, Stellar, Algorand). One NEAR MPC key authority signs on EVM and BTC, no private keys held anywhere. ShadeGuard policy enforcement, Intel TDX TEE attestation, HMAC-SHA256 receipts, Filecoin and BTFS anchored. x402 protocol settlement with 0.25 percent protocol fee. Public discovery with no signup needed: call yaxgetcapabilities without auth. Instant test key (5 USD cap, 7 day) via POST /api/apply. Install via npx agentx402-mcp-server.
Quick Install
{
"mcpServers": {
"fabio662-yieldagentx402-sdks": {
"command": "npx",
"args": [
"-y",
"fabio662-yieldagentx402-sdks"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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). |
Try without signup
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/x402asextra.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.