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/developer
The BASIC tier (200 calls/day, no credit card) 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 MCP ID is io.github.lambopoewert/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 seven tools. Here is what each one does:
madeonsol_kol_feed — Returns recent trades from the 1,000+ tracked 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 6,700+ Pump.fun deployers with historical graduation and PnL data.
madeonsol_token_info — Looks up a token by mint address. Returns deployer address, deployer tier, current market activity from the DEX feed, social links, and KOL sentiment.
madeonsol_api_status — Returns current API uptime and quota usage. Useful at the start of a session to confirm the service is healthy and check how many calls you have remaining.
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_info 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_info with the mint address and return deployer tier, market data, and KOL sentiment in a single response.
Step 5: Streaming Tools (PRO and ULTRA)
On PRO and ULTRA tiers, the MCP server exposes an additional streaming tool:
madeonsol_stream_token — Returns a WebSocket URL for real-time DEX trade events on a specific token. This is the entry point into the live trade stream, which covers 12 DEX programs with sub-3-second detection latency.
To use streaming tools, your API key must be on a PRO or ULTRA plan. The stream URL returned by the tool can be connected to directly from a script or handed to another tool in the same session.
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 $49/month). ULTRA gives 100,000 calls/day at $199/month 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"
}
}
}
}
This is useful if you want to use the MCP server occasionally without committing to a subscription, or if you are experimenting with autonomous agent setups where each agent manages its own wallet. Discovery information for the x402 payment endpoint is available at madeonsol.com/api/x402.
Summary
The MadeOnSol MCP server takes about five minutes to set up. Once configured, Claude and Cursor gain access to live KOL trades, deployer intelligence, and coordination signals without any additional code. The BASIC free tier covers typical research use, and upgrading is straightforward when you need higher volume.
Get your API key at madeonsol.com/developer, then install the server and paste the config block above.