Metadata-Version: 2.4
Name: snap-router-mcp
Version: 1.0.0
Summary: MCP server for Snap Router — task-to-tool discovery over the x402/MCP catalog
License: MIT
Project-URL: Homepage, https://trigeochiral.com
Project-URL: Repository, https://github.com/trigeochiral/snap-router-mcp
Keywords: mcp,x402,agent,tool-selection,tool-routing,discovery
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Dynamic: license-file

# Snap Router — MCP server

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

Task-to-tool discovery for AI agents, pay-per-call in USDC on Base (x402), free tier, no signup.

Hosted API: `https://trigeochiral.com` — set it as `SNAP_API`.

## Tool

| Tool | What |
|---|---|
| `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 |

## Why

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.

## Install

```bash
pip install snap-router-mcp
claude mcp add snap-router --env SNAP_API=https://trigeochiral.com -- snap-router-mcp
```

or with `uvx` (no install):

```bash
claude mcp add snap-router --env SNAP_API=https://trigeochiral.com -- uvx snap-router-mcp
```

Optional: `SNAP_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
curl -sX POST https://trigeochiral.com/v1/snap -H 'content-type: application/json' \
  -d '{"task":"check a base token for honeypot before trading","k":4}'
```

## License

MIT
