Metadata-Version: 2.4
Name: rgx-mcp
Version: 1.0.1
Summary: MCP server for RGX — Snap Router + Pricing-Truth for AI trading agents
License: MIT
Project-URL: Homepage, https://rgx.tail817c3b.ts.net
Project-URL: Repository, https://github.com/trigeochiral/rgx-mcp
Keywords: mcp,x402,agent,defi,base,honeypot,liquidity,tool-selection
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Dynamic: license-file

# RGX — MCP server

<!-- mcp-name: io.github.trigeochiral/rgx -->

MCP client for **RGX**: two primitives for AI trading agents, pay-per-call in USDC
on Base (x402), free tier, no signup.

Hosted API: `https://rgx.tail817c3b.ts.net` — set it as `RGX_API`.

| Tool | What |
|---|---|
| `snap_router` | **Snap Router** — your task → the ranked x402 / MCP tools that serve it, over the merged x402 Bazaar + MCP Registry catalog (16k+). One pass, ~200ms, no LLM call. $0.003 |
| `token_report` | pre-trade: real tradeable depth vs headline TVL + multi-pool price corroboration + honeypot test, one call. $0.04 |
| `token_depth` | largest trade that fills within 1 / 2 / 5% price impact, vs the headline TVL. $0.01 |
| `price_corroboration` | consensus USD price only when ≥2 deep pools agree; flags single-source / manipulated prices. $0.01 |
| `honeypot_check` | real buy + sell round-trip; flags honeypot / transfer tax. $0.005 |
| `redeem_spread` | ERC-4626 share redemption value vs market. $0.01 |
| `anomaly_screener` | tokens on a chain that just broke (depth collapse / price break / new honeypot). $0.025 |

Chains: `base`, `ethereum`, `arbitrum`.

## Why

- **Snap Router** — the tool-retrieval bottleneck: past ~2,000 tools, semantic
  retrieval beats keyword and beats long-context. Coinbase's Bazaar `/ask` is
  LLM-ranked (a model call on every task); 402index falls back to keyword-only
  when its embedding service times out. Snap Router has neither hole.
- **Pricing-Truth** — every "token safety" tool checks the *contract*. None check
  whether the liquidity is real or the price is trustworthy. A pool can show
  \$15M TVL and fill \$4.

## Install

```bash
pip install rgx-mcp
claude mcp add rgx --env RGX_API=https://rgx.tail817c3b.ts.net -- rgx-mcp
```

or with `uvx` (no install):

```bash
claude mcp add rgx --env RGX_API=https://rgx.tail817c3b.ts.net -- uvx rgx-mcp
```

Optional: `RGX_XPAYMENT` = a base64 x402 `X-PAYMENT` payload, to make paid calls
past the free tier. Without it you get 25 free calls/day per IP.

## Direct HTTP (no MCP)

```bash
# Snap Router
curl -sX POST https://rgx.tail817c3b.ts.net/v1/snap -H 'content-type: application/json' \
  -d '{"task":"check a base token for honeypot before trading","k":4}'

# Pre-trade report
curl -s https://rgx.tail817c3b.ts.net/v1/base/token/0x532f27101965dd16442E59d40670FaF5eBB142E4/report
```

Discovery: `/.well-known/agent-card.json` (A2A), `/.well-known/x402`,
`/.well-known/mcp.json`, `/llms.txt`, `/openapi.json`.

## License

MIT
