Tryx402 MCP server

tryx402 — the OpenRouter for agent payments

<!-- mcp-name: io.github.crypto-yannso/tryx402 -->

MIT licensed. Built in France. The first open-source payment governance layer for AI agents.

A safe, provider-agnostic wrapper over AgentCash / x402. Not limited to prospecting — it drives any endpoint, and adds what AgentCash itself lacks and we learned we need the hard way:

• hard budget caps — stop before overspending
• idempotency — never pay twice for the same call (the $0.83 double-charge lesson)
• cost ledger — USD spent, reconciled, grouped by origin / account
• plan estimation — price a multi-call workflow before spending a single cent
• signed receipts — Ed25519 offline-verifiable proof of every payment
• session tokens + circuit breaker — per-task spend caps with half-open cooldown
• transparent 402→pay→retry — native httpx transport, exactly one retry, no loops
• discovery pipeline — live x402 bazaar indexing (Onyx Bazaar, gold-402)

Open source, no fear

This repo is the open-source SDK: the safe caller, budget guard, idempotency, ledger, CLI and MCP server. MIT licensed.

We don't hide features behind paywalls. We don't split the SDK into "core" and "pro". Everything is here. Use it, fork it, build on it.

The hosted service (https://www.tryx402.app) is the commercial engine: multi-currency fiat billing, margins, FX, Stripe funding, the verified-tools catalogue and the provider portal. Pricing is decided server-side via /v1/quote — a client-side margin is a margin nobody pays.

Revenue model: commission on every pay-per-call transaction routed through the hosted service. The SDK is free. The service takes a cut. That's it.

Positionnement

tryx402 est le premier SDK open source de gouvernance de paiements pour agents IA dans l'écosystème x402. Conçu en France, distribué sous MIT, adopté par la communauté.

Face aux agrégateurs propriétaires (treg.to et consorts), tryx402 défend une position différente : pas de lock-in, pas de licence restrictive, pas de "commercial use only". Le code est libre. La confiance vient du service, pas de la licence.

Embed it (for agents)

Python — one import:

from gateway import Gateway
gw = Gateway(max_budget_usd=1.0)               # safe by default
data = gw.call("https://stable-deepline.dev/api/email/validate",
               body={"email": "x@y.com"}, price=0.03)
print(gw.spent_usd)                            # 0.03

Terminal — one command (like agentcash), after pip install tryx402:

gateway call https://stable-deepline.dev/api/email/validate \
  --body '{"email":"x@y.com"}' --price 0.03 --max-budget 0.10

MCP — two modes (pick the one you need):

SDK MCP (pip install) — 6 tools, safe caller only

{
  "command": "python3",
  "args": ["-m", "tryx402.mcp_server"],
  "env": { "TRYX402_MAX_BUDGET_USD": "1.00" }
}

6 tools: gatewaysearch, gatewaydiscover, gatewaycall, gatewayspent, gatewayplan, gatewayreceipt. Works directly with your x402/AgentCash crypto wallet — no hosted account needed.

You will NOT see gatewaycheckbalance, gateway_recharge,

gatewaylookup, or gatewayproxy_call from pip install tryx402.

This is deliberate, not a bug. These tools manage your **hosted account

credits** (funded via Stripe, separate from your crypto wallet). The SDK

MCP is a safe x402 caller; the hosted gateway handles the fiat credit

layer. For the full 10-tool MCP, see Option B below or connect to

https://www.tryx402.app/api/mcp.

Gateway MCP (clone repo) — 10 tools, hosted account management

Shortened. The full README is on GitHub.