# tryx402 — Developer Portal & Agentic Documentation Index

> The budget router and execution gateway for AI agents consuming paid x402 APIs.

## Navigation & Discovery Links

- [Complete Agent Integration Guide](https://www.tryx402.app/llms-full.txt)
- [OpenAPI 3.1 Specification](https://www.tryx402.app/openapi.json)
- [Machine-Readable Pricing Catalog](https://www.tryx402.app/api/pricing.json)
- [Google A2A Agent Card](https://www.tryx402.app/.well-known/agent.json)
- [Snowflake/Google ARD Resources](https://www.tryx402.app/.well-known/agentic-resources.json)
- [Agent Skill Definition](https://www.tryx402.app/skill.md)
- [AGENTS.md Context Rules](https://www.tryx402.app/AGENTS.md)
- [Official GitHub Repository](https://github.com/crypto-yannso/tryx402)
- [About Us & Architecture](https://www.tryx402.app/about.html)
- [Contact & Support](https://www.tryx402.app/contact.html)
- [Privacy Policy](https://www.tryx402.app/privacy.html)
- [Terms of Service](https://www.tryx402.app/terms.html)

---

## When to Use tryx402 (Agent Guidance)

Use tryx402 when your autonomous workflow needs to:
- **Execute paid tool-calls** over the HTTP 402 / x402 protocol (e.g. data enrichment, live web extraction, search, solvency checks, voice calls) without risk of wallet drain.
- **Prevent duplicate debits** on network timeouts through deterministic `Idempotency-Key` headers.
- **Enforce a strict session budget limit** ($0.50, $1.00, $5.00) so unbounded reasoning loops throw an exception rather than depleting funds.
- **Resell paid API endpoints** to end-users who pay via credit card / Stripe Checkout in EUR/USD/GBP without handling crypto keys.

Do not use tryx402 for free, ungated public APIs or direct model inference (use OpenRouter for model tokens).

---

## Core Architecture
tryx402 sits between autonomous agent runtimes (Claude Code, Cursor, Codex, OpenCode, Hermes) and paid HTTP 402 / x402 API resources:
1. **Pre-Authorization Spend Checks**: Inspects HTTP 402 challenges (`maxAmountRequired`) before transaction signing. Throws `BudgetExceeded` if over ceiling.
2. **Idempotency Protection**: Deterministic `Idempotency-Key` headers eliminate double charges on network retries.
3. **Structured Accounting Ledgers**: Emits per-call expenditure in JSON grouped by origin and project.
4. **Fiat Bridge**: Supports multi-currency account re-charging via Stripe Checkout (EUR, GBP, USD, JPY).

---

## Fast MCP Setup (Zero-Dependency)
```json
{
  "mcpServers": {
    "tryx402": {
      "command": "python3",
      "args": ["-m", "tryx402.mcp_server"],
      "env": { "TRYX402_MAX_BUDGET_USD": "1.00" }
    }
  }
}
```
Exposed tools: `gateway_search`, `gateway_discover`, `gateway_call`, `gateway_spent`.