Model Context Protocol (MCP) is an open standard that lets AI tools call external APIs as first-class tools. Instead of copying data into a chat window or writing glue code every time you want fresh market data, you configure an MCP server once and the AI can call it on demand.
MadeOnSol publishes an official MCP server that exposes the full v1 API surface — KOL trades, deployer alerts, coordination signals, token lookups, and more — to any MCP-compatible client. This post covers how to install and configure it for Claude Desktop and Cursor.
Once configured, you can ask Claude "which tokens are multiple KOLs accumulating right now?" and get a structured answer backed by live on-chain data, without writing a single line of code.
Prerequisites
- Node.js 18 or higher (for the MCP server runtime)
- Claude Desktop, or Cursor with MCP support enabled
- A MadeOnSol API key — get one free at madeonsol.com/pricing
The BASIC tier (200 calls/day, no payment required) is sufficient for research sessions in Claude or Cursor. You only hit the limit if you run many back-to-back queries in a short window.
Install the MCP Server
npm install -g mcp-server-madeonsol
This installs the mcp-server-madeonsol binary globally. The current MCP registry name is io.github.MadeOnSol/madeonsol.
Verify the install:
mcp-server-madeonsol --version
Step 1: Configure Claude Desktop
Claude Desktop reads MCP server definitions from a JSON config file. Open the file for your platform:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
If the file does not exist, create it. Add the following configuration:
{
"mcpServers": {
"madeonsol": {
"command": "mcp-server-madeonsol",
"env": {
"MADEONSOL_API_KEY": "msk_your_key_here"
}
}
}
}
If you already have other MCP servers configured, add the "madeonsol" entry inside the existing "mcpServers" object. Do not replace the whole file.
After saving, restart Claude Desktop completely — quit from the menu bar or system tray, then reopen it. Claude loads MCP server definitions at startup, not dynamically. Once restarted, you will see the MadeOnSol tools listed in the tools panel when you start a new conversation.
Step 2: Configure Cursor
Cursor supports MCP servers via its settings panel. Open Cursor, then navigate to Settings → MCP Servers. Add a new entry with the same configuration:
{
"command": "mcp-server-madeonsol",
"env": {
"MADEONSOL_API_KEY": "msk_your_key_here"
}
}
In Cursor, MCP tools are available in the AI panel (Cmd+L or Ctrl+L). You can invoke them directly in your research queries or from within an agentic Cursor session where the AI is writing and executing code.
Step 3: Available Tools
The MCP server exposes 104 tools covering the full v1 API surface — KOL tracking, deployer intelligence, token data, wallet tracking, sniper detection, copy-trade rules, price alerts, and more. Here are the ones you will reach for most in a research session:
madeonsol_kol_feed — Returns recent trades from the 1,100+ active Solana KOL wallets. Accepts filters for time window, trade direction (buy or sell), and minimum SOL size. Use this to see what smart money is trading right now.
madeonsol_kol_coordination — Returns tokens where multiple KOLs are trading in the same direction within a time window. Returns a signal field ("accumulating" or "distributing") and the list of KOLs involved. This is the convergence signal — when three or more tracked wallets buy the same token in the same hour, that is meaningful.
madeonsol_kol_leaderboard — Returns ranked KOL wallets by PnL, win rate, or trade volume over a configurable period. Includes strategy tags so you can distinguish scalpers from swingers from deployer hunters.
madeonsol_deployer_alerts — Queries the deployer-hunter database for newly launched tokens. Filters by deployer tier (elite, good, neutral, bad) and time window. The deployer database covers 1.2M+ indexed Pump.fun deployer wallets (85K+ reputation-profiled) with historical graduation and performance data.
madeonsol_token_get — Looks up a token by mint address. Returns a comprehensive per-mint snapshot: price, market cap, volume, deployer, KOL activity, age, and blacklist status.
madeonsol_me — Inspects your account: tier, quota state, remaining requests, and subscription expiry. Useful at the start of a session to confirm how many calls you have left.
madeonsol_discovery — Searches the MadeOnSol tool directory. Over 1,000 Solana dApps and tools indexed with categories, tags, and metadata.
Step 4: Example Prompts to Try
Once Claude Desktop is configured and restarted, open a new conversation and try these prompts. Claude will call the appropriate MCP tools and return structured results.
KOL leaderboard with strategy context:
Get the top 5 KOLs by PnL for the last 30 days. For each one, summarize their strategy tags and note whether they are currently active in the KOL feed.
Claude will call madeonsol_kol_leaderboard with a 30-day window, then cross-reference with madeonsol_kol_feed to check recent activity.
Elite deployer launches:
Check deployer alerts for elite and good tier launches in the last 2 hours. Show the token name, mint, deployer tier, and any KOL activity.
Claude will call madeonsol_deployer_alerts, then may call madeonsol_token_get for each result to enrich with KOL sentiment data.
Coordination signals:
Get coordination signals for the last hour. Which tokens are multiple KOLs accumulating right now? Show the token, the number of KOLs, and the net SOL flow.
This calls madeonsol_kol_coordination with period=1h. The response includes signal, kol_count, net_sol_flow, and the list of wallet names involved.
Token deep dive:
What is the token info for [paste mint address]? Is the deployer reputable? Are any KOLs currently holding or buying it?
Claude will call madeonsol_token_get with the mint address and return deployer tier, market data, and KOL sentiment in a single response.
Step 5: Streaming Tools (PRO+)
On paid streaming tiers, the MCP server exposes stream-token and session-control tools.
madeonsol_stream_token — Returns the account's permanent WebSocket stream token plus ws_url for the main signal stream; ULTRA-class accounts also receive dex_ws_url for the Solana all-DEX firehose. It does not create a token-specific DEX URL. Stream tokens no longer expire on a timer: repeated calls return the same token unless entitlement lapses or you explicitly call the tool with rotate: true.
PRO has main-stream slots; ULTRA and BUSINESS add broader limits, with ULTRA-class access to the Solana DEX firehose. Individual channels can carry stricter tier or scope requirements.
Quota and Tier Considerations
The BASIC free tier (200 calls/day) is well-suited for research sessions where you run 10-20 queries. A typical session asking 5-6 research questions will consume roughly 10-20 tool calls, depending on how many follow-up lookups Claude performs.
For heavier workloads — automated research pipelines, developer sessions with many iterations, or use alongside a running agent — consider upgrading to PRO (10,000 calls/day at €43/month, ≈ $49). ULTRA gives 100,000 calls/day at €131/month (≈ $149) and is appropriate for high-volume production setups.
Configuring x402 Instead of a Subscription
If you prefer pay-per-use over a monthly subscription, you can configure the MCP server with a Solana private key instead of an API key. In x402 mode, each tool call pays a micropayment in USDC directly from the configured wallet:
{
"mcpServers": {
"madeonsol": {
"command": "mcp-server-madeonsol",
"env": {
"SVM_PRIVATE_KEY": "your_base58_encoded_private_key",
"X402_PAY_TO": "copy-current-value-from-madeonsol.com/mcp",
"X402_FEE_PAYER": "copy-current-value-from-madeonsol.com/mcp",
"X402_MAX_AMOUNT_ATOMIC": "20000",
"X402_MAX_TOTAL_AMOUNT_ATOMIC": "1000000",
"SVM_RPC_URL": "https://your-trusted-solana-rpc"
}
}
}
}
Since MCP server 3.0.0, keyless mode requires a merchant-bound payment policy: the expected pay-to and fee-payer identities plus per-call and lifetime spend caps and a trusted Solana RPC. The server refuses unsafe keyless startup instead of letting a changed payment challenge spend outside that policy. Copy the current merchant values from the live /mcp configuration rather than freezing them in an article. Discovery information for the x402 payment endpoint is available at madeonsol.com/api/x402. If you build agents on ElizaOS rather than Claude or Cursor, the same KOL feeds are available through our ElizaOS plugin for real-time Solana KOL alpha.
Summary
