Yieldagentx402

io.github.Fabio662Published by GitHub account Fabio662v1.0.4Updated Oct 24, 2026

Policy-gated x402 MCP for agent workflows with TEE receipts, 18 tools, and no custody.

Overview

AI-generated overview

Local stdio wrapper that connects an assistant to the hosted YieldAgentX402 endpoint for policy-checked x402 payments, attested runs and signed receipts.

What you can do
  • Discover capabilities and check wallet status without custody
  • Run secure workflows and process x402 payments across many chains
  • Check policy, submit approvals, control workflows, audit compliance and fetch attestations
  • Retrieve, verify and list receipts and past runs
  • Run business workflows such as lead scoring, lead enrichment, email sequences, churn monitoring, AR invoice collection and cash-flow forecasting
When to use it
For agents that need to move or route funds through x402 payments with policy gating and verifiable receipts, or that run the vendor's lead, churn and cash-flow workflows. Useful when an audit trail and TEE attestation matter more than a plain payment call.
Requirements
Runs locally via npx (Node.js) and forwards calls to the hosted endpoint at api.yieldagentx402.app; an API key in YAX_API_KEY is needed for non-public tools, YAX_AGENT_ID is optional, and YAX_MCP_ENDPOINT or YAX_API_BASE can override the endpoint. Network access to the vendor's service is required.
Before you install
The API key in YAX_API_KEY is a live credential for a payment-capable service; tools can process x402 payments and run workflows that spend funds, so policy and approval steps should be reviewed before use. Calls and their data go to the third-party hosted endpoint, and receipts are anchored to Filecoin and BTFS when uploads succeed.

Installation

In SourceWeft

  1. Open Yieldagentx402 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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: 18 tools · 18 chains · no custody · signed receipts on every call.

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

[yieldagentx402-sdks MCP server]


Try it now (no signup)

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

bash
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 (18 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.

json
{  "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 (18)

CategoryTools
Discovery (public, no auth)yax_get_capabilities
Wallet & custodyyax_get_wallet_status
Executionyax_run_secure_workflow, yax_process_x402_payment
Policy & governanceyax_check_policy, yax_submit_approval, yax_control_workflow, yax_audit_compliance, yax_get_attestation
Receipts & audityax_get_receipt, yax_verify_receipt, yax_list_runs
Workflowsyax_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.

ChainAddressMode
EVM (Base/Eth)0x6905D04C3655625F6171f7b1e801a9325B1Fa1e8MPC-signed
Bitcoin (P2WPKH)bc1qcd8ljsj7x0rq3sw7drrt7ragqmmt3tfsfxs6gyMPC-signed
Starknet0x003a4e08…570906a21Stark curve, preset

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


Configuration

Env varRequiredDefault
YAX_API_KEYYes (for non-public tools)—
YAX_AGENT_IDNo—
YAX_MCP_ENDPOINTNohttps://api.yieldagentx402.app/mcp
YAX_API_BASENo(sets endpoint if YAX_MCP_ENDPOINT unset)

Registry


Development

bash
npm installnpm run buildnpm 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

Source: mcp-server/README.md at commit d1b05fc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts