# MCPVOT

> MCP server + x402 payment gateway for AI agents. 8 paid tools + 1 free.
> Live at https://mcpvot.xyz

## x402 Payment Flow

All tools use **x402 exact** scheme — agents pay per-call in USDC on Base (chainId 8453).
Treasury: `0x662741340B7c58f3fd30FD4908c6A8c0f9297d25`
USDC: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

**MCP Wallet bypass:** Connect at https://mcpvot.xyz/wallet, sign a Permit, get a Session-Token. Pass as `Session-Token` header to skip per-call payment.

## MCP Tools

| Tool | Price | Description |
|------|-------|-------------|
| `get_race_results` | $0.02 | Full iRacing race results — finish order, laps, incidents, iRating changes |
| `lookup_driver` | $0.01 | iRacing driver profile — iRating, license, safety rating, career stats |
| `search_hosted_races` | $0.02 | Search hosted iRacing races by date/driver/session name |
| `search_web` | $0.01 | Google search via SerpAPI (organic results, ranked) |
| `score_agent_wallet` | $0.02 | AI agent wallet scoring via TWZRD |
| `get_dex_prices` | $0.01 | DEX token prices via 0x |
| `search_crypto_asset_info` | $0.01 | Crypto asset data via Messari |
| `search_blockchain_data` | $0.01 | Bitcoin blockchain data via Mempool.space |
| `get_ecosystem_status` | FREE | MCPVOT service status + health |

## iRacing Auth

Users provide their own iRacing session cookie via `iRacing-Session` header.
Auth flow: SHA256(password+email) → JSON POST to /auth → authcode → authtoken_members cookie.
No server-side credential storage.

## Server Info

- MCP endpoint: `POST https://mcpvot.xyz/api/mcp`
- Endpoints: `/api/x402/{tool}`
- Protocol: MCP 2025-11-25 (Streamable HTTP)
- MCP Registry: `io.github.MCPVOT/mcpvot`
- Ecosystem: `io.github.MCPVOT/mcp-agentic-wallet` (open-source wallet lib)

## Direct x402 Endpoints

All tools also available as direct x402 endpoints for custom agent integrations.
Send `X-PAYMENT` header with TransferWithAuthorization envelope.
Send `iRacing-Session` header with iRacing cookies for iRacing tools.