# MCPVOT x402 Intelligence Network

> **The Premier AI Agent Intelligence API on Base Blockchain**

MCPVOT is an x402-protocol compliant intelligence network providing real-time analytics for VOT, MAXX, and Farcaster ecosystem tokens on Base Mainnet. All APIs are gasless - facilitator pays gas for seamless AI agent integration.

## What is MCPVOT?

MCPVOT (Model Context Protocol VOT) is a comprehensive blockchain intelligence platform that:
- Provides **real-time token analytics** for VOT, MAXX, and 10+ Farcaster tokens
- Offers **gasless API access** via x402 protocol (USDC payments, facilitator covers gas)
- Features **deflationary tokenomics** - 55% of payments burn VOT tokens
- Integrates with **MCP (Model Context Protocol)** for AI agents
- Listed on **x402scan.com** for AI agent discovery

## Key Features

### 1. x402 Gasless Payments
- Pay with USDC on Base Mainnet
- Facilitator executes all transactions (you never pay gas)
- Instant token delivery via treasury inventory system
- 402 Payment Required responses for automated payments

### 2. Token Intelligence APIs
- **VOT Intelligence**: Holder distribution, burn analytics, trading signals
- **MAXX Intelligence**: Deflationary metrics, liquidity analysis, price feeds
- **Farcaster Ecosystem**: Social sentiment for DEGEN, HIGHER, BUILD, and more
- **Token Comparison**: AI-powered side-by-side analysis

### 3. AI Agent Integration
- ERC-8004 compliant agent registration
- MCP manifest at `/.well-known/mcp-manifest.json`
- Agent registration at `/.well-known/agent-registration.json`
- Compatible with Claude, ChatGPT, and autonomous agents

## Quick Start

### Get a Quote (No Payment Required)
```
GET https://mcpvot.xyz/api/vot/order?usdAmount=10
```

### Buy VOT Tokens (x402 Flow)
```
POST https://mcpvot.xyz/api/x402/buy-vot
Body: { "usdcAmount": "10", "walletAddress": "0x..." }
```

### Access Intelligence API
```
POST https://mcpvot.xyz/api/x402/vot-intelligence
Header: X-PAYMENT: <base64-encoded-payment>
```

## Pricing

| Endpoint | Price | Description |
|----------|-------|-------------|
| VOT Intelligence | $0.10 | Comprehensive VOT analytics |
| MAXX Intelligence | $0.10 | Deflationary metrics |
| Farcaster Ecosystem | $0.10 | 10+ token social analysis |
| Token Compare | $0.10 | AI comparison engine |
| Burn Stats | FREE | Transparency endpoint |

## Documentation Links

- **API Docs**: https://mcpvot.xyz/docs/api
- **MCP Manifest**: https://mcpvot.xyz/.well-known/mcp-manifest.json
- **Agent Registration**: https://mcpvot.xyz/.well-known/agent-registration.json
- **x402scan Listing**: https://x402scan.com/resource/mcpvots
- **GitHub**: https://github.com/MCPVOTS/MCPVOTS

## Token Addresses (Base Mainnet)

- **VOT Token**: `0xc1e1E7aDfDf1553b339D8046704e8e37E2CA9B07`
- **MAXX Token**: `0xFB7a83abe4F4A4E51c77B92E521390B769ff6467`
- **USDC**: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- **Treasury**: `0x824ea259C1e92f0c5dC1d85dcbb80290B90BE7fa` (mcpvot.base.eth)

## Architecture

- **Frontend**: Next.js 15 + Tailwind CSS + Three.js
- **Backend**: Vercel Edge Functions + ethers.js
- **Blockchain**: Base Mainnet (Chain ID: 8453)
- **Payments**: x402 Protocol with EIP-3009 (TransferWithAuthorization)
- **Data Sources**: GeckoTerminal, DexScreener, Birdeye, Neynar

## Contact

- **Website**: https://mcpvot.xyz
- **Farcaster**: @mcpvots
- **Discord**: https://discord.gg/mcpvots
- **Support**: support@mcpvot.xyz