io.github.Fabio662/yieldagentx402
Policy-gated x402 MCP for agent workflows with TEE receipts, 18 tools, and no custody.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
agentx402-mcp-serverclaude mcp add yieldagentx402 -e 'YAX_API_KEY=<your yax_api_key>' -e 'YAX_AGENT_ID=<YAX_AGENT_ID>' -e 'YAX_MCP_ENDPOINT=<YAX_MCP_ENDPOINT>' -- npx -y agentx402-mcp-server@1.0.4
{
"mcpServers": {
"yieldagentx402": {
"command": "npx",
"args": [
"-y",
"agentx402-mcp-server@1.0.4"
],
"env": {
"YAX_API_KEY": "<your yax_api_key>",
"YAX_AGENT_ID": "<YAX_AGENT_ID>",
"YAX_MCP_ENDPOINT": "<YAX_MCP_ENDPOINT>"
}
}
}
}
Variables d'environnement
YAX_API_KEYobligatoire secret YieldAgentX402 API key from https://yieldagentx402.app/applyYAX_AGENT_IDobligatoire Your agent ID from the dashboard.YAX_MCP_ENDPOINTOptional full MCP endpoint override (default: https://api.yieldagentx402.app/mcp).
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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.
Questions fréquentes
Qu'est-ce que io.github.Fabio662/yieldagentx402 ?
Policy-gated x402 MCP for agent workflows with TEE receipts, 18 tools, and no custody.
Comment installer io.github.Fabio662/yieldagentx402 ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add yieldagentx402 -e 'YAX_API_KEY=<your yax_api_key>' -e 'YAX_AGENT_ID=<YAX_AGENT_ID>' -e 'YAX_MCP_ENDPOINT=<YAX_MCP_ENDPOINT>' -- npx -y agentx402-mcp-server@1.0.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.Fabio662/yieldagentx402 ?
Oui. Il attend YAX_API_KEY, YAX_AGENT_ID, à renseigner dans sa configuration.
io.github.Fabio662/yieldagentx402 est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.Fabio662/yieldagentx402 ?
Il est publié par Fabio662. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.