XP-MCP

<p align="center"> <img src="logo.png" width="140"> </p>

<h1 align="center">XP-MCP</h1> <h3 align="center">Make Your AI Actually Understand APIs</h3>

<p align="center"> <a href="https://x.com/xp"><img src="https://img.shields.io/badge/X.com-Follow-000000?style=for-the-badge&logo=x&logoColor=white" alt="X.com"></a>    <a href="https://xp.wtf"><img src="https://img.shields.io/badge/Website-xp.wtf-3b82f6?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Website"></a> </p>

<p align="center"> Give your AI assistant real knowledge about 40+ APIs.<br> No more guessing. No more broken code. Just working integrations. </p>

---

What is XP-MCP?

When you ask ChatGPT, Claude, or any AI to write code that connects to an API like Binance, Polymarket, or Stripe, it often makes things up. It guesses endpoint URLs, invents parameters that don't exist, and produces code that doesn't work.

XP-MCP solves this.

We've created 40+ specialized AI agents, each one trained on the real, verified documentation for a specific API. When your AI uses XP-MCP, it gets accurate information instead of hallucinating.

The Problem We Solve

What happens without XP-MCP	What happens with XP-MCP
AI guesses API endpoints	AI knows the exact endpoints
AI invents fake parameters	AI uses real, documented parameters
Code breaks when you run it	Code works the first time
You waste hours debugging	You ship faster

---

Who Is This For?

Developers who use AI coding assistants (Cursor, Claude, GitHub Copilot) and are tired of the AI making up API details.

Teams building applications that integrate with trading platforms, payment processors, social media APIs, or blockchain services.

Anyone who wants their AI to write working code instead of broken code.

---

How It Works

graph TB
    subgraph "XP-MCP Platform"
        API[XP API Server<br>xp.wtf]
        
        subgraph "Agent Library"
            A1[Binance Agent]
            A2[Polymarket Agent]
            A3[Jupiter Agent]
            A4[GitHub Agent]
            AN[40+ More...]
        end
    end
    
    subgraph "Each Agent Contains"
        DOC[CLAUDE.md<br>Verified API Docs]
        TOOLS[MCP Tools<br>Executable Functions]
        EXAMPLES[Examples<br>Working Code]
    end
    
    USER[Your AI / LLM] --> |"1. Request Context"| API
    API --> |"2. Return CLAUDE.md"| USER
    USER --> |"3. Call Tools"| API
    API --> A1 & A2 & A3 & A4
    
    A1 --> DOC
    A1 --> TOOLS
    A1 --> EXAMPLES
    
    style API fill:#ff6b4a,stroke:#333,color:#fff
    style USER fill:#3b82f6,stroke:#333,color:#fff
    style DOC fill:#e8f5e9,stroke:#333
    style TOOLS fill:#e3f2fd,stroke:#333
    style EXAMPLES fill:#fff3e0,stroke:#333

In simple terms:

1. You connect your AI assistant to XP-MCP
2. When you ask it to work with an API (like "get Bitcoin price from Binance"), it fetches the real documentation
3. Your AI now knows exactly how the API works
4. It writes correct code that actually runs

---

Getting Started

Option 1: Use with Cursor (Recommended)

Cursor is an AI-powered code editor. Here's how to add XP-MCP:

1. Open Cursor
2. Go to Settings → MCP
3. Add this configuration:

{
  "mcpServers": {
    "xp-binance": {
      "url": "https://xp.wtf/mcp/binance/sse"
    },
    "xp-polymarket": {
      "url": "https://xp.wtf/mcp/polymarket/sse"
    },
    "xp-solscan": {
      "url": "https://xp.wtf/mcp/solscan/sse"
    },
    "xp-jupiter": {
      "url": "https://xp.wtf/mcp/jupiter/sse"
    }
  }
}

4. Restart Cursor
5. Now when you ask Cursor to work with Binance, Polymarket, Solscan, or Jupiter, it will have accurate API knowledge

Option 2: Use with Claude Desktop

Same process - add the configuration to your Claude Desktop MCP settings.

Option 3: Use the REST API Directly

If you're building your own application, you can fetch agent documentation directly:

# Get the full Binance API documentation
curl https://xp.wtf/agents/binance/context

# Get Polymarket documentation
curl https://xp.wtf/agents/polymarket/context

You can then inject this documentation into any AI system you're using.

---

The Flow

sequenceDiagram
    participant You as You
    participant AI as Your AI Assistant
    participant XP as XP-MCP Server
    participant API as Real API (Binance, etc)
    
    You->>AI: "Get the current Bitcoin price"
    AI->>XP: Request Binance documentation
    XP-->>AI: Here's exactly how Binance API works
    
    Note over AI: AI now knows the correct<br>endpoint, parameters, and format
    
    AI->>XP: Call get_ticker_price tool
    XP->>API: GET /api/v3/ticker/price?symbol=BTCUSDT
    API-->>XP: {"symbol":"BTCUSDT","price":"97234.50"}
    XP-->>AI: Price data
    AI-->>You: "Bitcoin is currently $97,234.50"

---

Available Agents

We have specialized agents for 40+ APIs across different categories:

Trading & Exchanges

Agent	What it does
binance	Cryptocurrency trading, market data, account management
bybit	Derivatives trading, perpetual contracts
coinbase	Crypto exchange, fiat on/off ramps
okx	Unified trading across spot and derivatives
hyperliquid	Decentralized perpetuals trading

Solana DeFi

Agent	What it does
jupiter	Token swaps, best price routing across all Solana DEXs
raydium	AMM liquidity pools, concentrated liquidity
meteora	Dynamic liquidity market making (DLMM)
moonshot	Token launchpad, bonding curves
helius	Enhanced Solana RPC, NFT data, transaction parsing
solscan	Solana blockchain explorer, wallet analytics
dflow	Order flow auctions, MEV protection
vanish	Privacy trading, stealth swaps
sol-incinerator	Burn tokens, reclaim SOL from empty accounts
privacy-cash	Private transactions on Solana

Prediction Markets

Agent	What it does
polymarket	Prediction market trading, event contracts
kalshi	Regulated event contracts, US-based

Market Data

Agent	What it does
coingecko	Crypto prices, market caps, historical data
coinmarketcap	Cryptocurrency rankings, market data
bitpay	Crypto payment processing, exchange rates

Social & Communication

Agent	What it does
twitter	Post tweets, search, user data
reddit	Subreddit posts, comments, user info
discord	Bot messaging, server management
slack	Team messaging, channel management
linkedin	Professional networking, profile data
soundcloud	Audio streaming, track search

Development Tools

Agent	What it does
github	Repositories, issues, pull requests
supabase	Database, authentication, storage
redis	Caching, key-value storage
pinata	IPFS pinning, Web3 storage

Cloud & Productivity

Agent	What it does
google-api	Drive, Sheets, Docs integration
google-calendar	Event scheduling, calendar management
salesforce	CRM, SOQL queries, record management

Payments

Agent	What it does
stripe	Payment processing, subscriptions, invoices
paypal	Payments, payouts, invoicing

Communications

Agent	What it does
twilio	SMS messaging, voice calls
mailchimp	Email marketing, subscriber management

AI

Agent	What it does
gemini	Google's AI model, text generation

DeFi

Agent	What it does
lighter	DeFi trading protocol
bagsapp	DeFi portfolio management

---

API Reference

If you want to integrate XP-MCP into your own systems, here are the available endpoints:

Endpoint	Method	What it does
/health	GET	Check if the service is running
/agents	GET	List all available agents
/agents/{name}	GET	Get details about a specific agent
/agents/{name}/context	GET	Get the full documentation (CLAUDE.md) for an agent
/mcp/{agent}/sse	GET	MCP Server-Sent Events endpoint for real-time connection
/v1/{agent}/{tool}	POST	Execute a specific tool

Example: Get Bitcoin Price

curl -X POST https://xp.wtf/v1/binance/get_ticker_price \
  -H "Content-Type: application/json" \
  -d '{"symbol":"BTCUSDT"}'

Example: Search Polymarket

curl -X POST https://xp.wtf/v1/polymarket/search_markets \
  -H "Content-Type: application/json" \
  -d '{"query":"bitcoin"}'

---

For Developers: Local Setup

Want to run agents locally or contribute? Here's how:

# Clone the repository
git clone https://github.com/xptech/xp-mcp.git
cd xp-mcp

# Run a specific agent locally
cd agents/binance/mcp-server
npm install
BINANCE_API_KEY=your_key npx tsx src/index.ts

Agent Structure

Each agent follows the same structure:

agents/{name}/
├── CLAUDE.md           # Complete API documentation
├── errors.md           # Error codes and how to handle them
├── README.md           # Agent overview
├── examples/           # Working code samples
└── mcp-server/         # The actual MCP server code

---

Frequently Asked Questions

Do I need to pay for this?

The hosted service at xp.wtf is currently free to use. We may introduce paid tiers for high-volume usage in the future.

Is my data safe?

XP-MCP doesn't store your queries or API responses. We simply proxy requests to the underlying APIs.

Can I add my own agents?

Yes! The repository is open source. You can create new agents following the existing structure and submit a pull request.

What if an API changes?

We actively maintain the documentation for all agents. If you notice outdated information, please open an issue.

Does this work with ChatGPT?

Currently, XP-MCP works best with tools that support the Model Context Protocol (MCP), like Cursor and Claude Desktop. For ChatGPT, you can manually fetch the documentation and paste it into your conversation.

---

Support

• Website: xp.wtf
• Twitter/X: @xp
• Issues: GitHub Issues

---

<p align="center"> Built for developers who are tired of AI hallucinations.<br> <a href="https://xp.wtf">xp.wtf</a> </p>