mcp-server-madeonsol 1.16.2 → 1.16.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +327 -327
- package/dist/index.js +1 -1
- package/glama.json +2 -2
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,327 +1,327 @@
|
|
|
1
|
-
# mcp-server-madeonsol
|
|
2
|
-
|
|
3
|
-
[](https://www.npmjs.com/package/mcp-server-madeonsol)
|
|
4
|
-
[](https://www.npmjs.com/package/mcp-server-madeonsol)
|
|
5
|
-
[](https://smithery.ai/servers/madeonsol/solana-kol-intelligence)
|
|
6
|
-
[](https://modelcontextprotocol.io/)
|
|
8
|
-
[](LICENSE)
|
|
9
|
-
|
|
10
|
-
> ⚡ **[Install via Smithery](#install-via-smithery-one-line)** · 🤖 **[Use in Claude Desktop](#claude-desktop)** · 🖱️ **[Use in Cursor](#cursor)** · 📚 **[API docs](https://madeonsol.com/api-docs)** · 💰 **[Free API key](https://madeonsol.com/pricing)** · 🔎 **[On Glama](https://glama.ai/mcp/servers/
|
|
11
|
-
|
|
12
|
-
MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Use from Claude Desktop, Cursor, or any MCP-compatible client.
|
|
13
|
-
|
|
14
|
-
> Real-time Solana trading intelligence: track 1,069 KOL wallets with <3s latency, score 23,000+ Pump.fun deployers, surface deshred deploy signals **~500ms before on-chain confirmation**, detect multi-KOL coordination, and stream every DEX trade across 9+ programs. Free tier: 200 requests/day, every endpoint — no signup payment. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
|
|
15
|
-
|
|
16
|
-
> **New in 1.16.0** — **Batch risk scoring + live stream-session control.** New tool `madeonsol_tokens_batch_risk` — bulk rug-risk/safety scoring for up to 50 mints in one call, returning the same per-mint shape as `madeonsol_token_risk` (0–100 score, `band`, explainable `factors[]`, raw `inputs`) plus an `as_of` timestamp; untracked mints come back as `{ mint, error: "not_tracked" }` without failing the batch, and the whole call counts as one request against quota. Plus two WebSocket session tools: `madeonsol_stream_sessions_list` (list your live sessions — `id`, `service`, `tier`, `channels`, `connected_at`, `remote_ip`, `messages_sent`) and `madeonsol_stream_session_kill` (force-disconnect a session by id to free its connection slot, e.g. a ghost socket). PRO/ULTRA only.
|
|
17
|
-
>
|
|
18
|
-
> **New in 1.15.0** — **Almost-bonded discovery + trending sorts.** New tool `madeonsol_almost_bonded` — pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min): "95% and accelerating" beats "92% stalled". Each token carries `progress_pct`, `velocity_pct_per_min`, `eta_minutes`, `stalled`, `real_sol_reserves`, `market_cap_usd`, `liquidity_usd`, `authorities_revoked`, `deployer_tier`, and `age_minutes`. Params: `min_progress`, `max_progress`, `min_velocity_pct_per_min`, `max_age_minutes`, `deployer_tier`, `authority_revoked`, `min_liq`, `sort` (velocity_desc / progress_desc / eta_asc), `limit`. PRO/ULTRA only. Plus `madeonsol_tokens_list` gains four momentum sorts — `mc_change_5m_desc`, `mc_change_1h_desc`, `volume_1h_desc`, and `trending` (composite recent-volume × positive-momentum rank).
|
|
19
|
-
>
|
|
20
|
-
> **New in 1.14.0** — **Token trade flow.** New tool `madeonsol_token_flow` — a trade-flow aggregate (organic-vs-fake volume) over a `1h`/`24h` window: `unique_wallets` / `unique_buyers` / `unique_sellers`, `buy_count` / `sell_count` / `total_trades`, `buy_sol` / `sell_sol` / `net_sol` (sell − buy; positive = net SOL leaving the pool), and `trades_per_wallet` (wash-trading proxy). PRO/ULTRA only. Deployer alerts (`madeonsol_deployer_alerts`) now carry `deployers.deployer_sol_balance` — the deployer wallet's SOL balance at alert time (null for historical rows).
|
|
21
|
-
>
|
|
22
|
-
> **New in 1.13.0** — **Token OHLCV candles.** New tool `madeonsol_token_candles` — historical price candles (1m/5m/15m/1h/4h/1d) aggregated from the on-chain trade firehose. Each candle has `t/open/high/low/close/volume_usd/trades/market_cap_usd`. PRO returns OHLCV for the last 30 days; ULTRA adds buy/sell volume + count splits, net flow, MEV volume, open/close liquidity, high/low MC, and full history. PRO/ULTRA only.
|
|
23
|
-
>
|
|
24
|
-
> **New in 1.12.0** — **Token risk score.** New tool `madeonsol_token_risk` — a transparent 0–100 rug-risk/safety score (higher = riskier) with a `band` (safe/caution/danger), an explainable `factors[]` array, and the raw `inputs` (mint/freeze authority, liquidity, liq-to-MC ratio, transfer fee, launch cohort, deployer bond rate, KOL signal, blacklist). PRO/ULTRA only.
|
|
25
|
-
>
|
|
26
|
-
> **New in 1.11.0** — `madeonsol_tokens_list` gains three new filter params: `min_liq_mc_ratio`, `max_liq_mc_ratio`, and `deployer_tier`. Response items now include `liquidity_to_mc_ratio` and `deployer_tier`. New tool: `madeonsol_signal_performance` — evaluate signal efficacy (hit rate, sample size, median outcome) before acting on any signal. KOL leaderboard entries now include `median_hold_minutes_30d` and `percentile_early_entry_30d`.
|
|
27
|
-
>
|
|
28
|
-
> **New in 1.10.4** — Deployer alerts/profiles now expose `runner_rate` + `labeled_tokens` (fraction of a deployer's labeled tokens that ran vs dumped, gate on `labeled_tokens` ≥3) plus `avg_time_to_bond_minutes`.
|
|
29
|
-
|
|
30
|
-
> **New in 1.10.3** — **Dump-cluster detection.** `madeonsol_token_buyer_quality` breakdown now includes `dump_cluster_count` (3+ dump-cluster wallets in the first-20 → 94% historical dump rate vs 61% base) and `recycled_early_buyer_count`. Full breakdown is returned on all tiers. Also: the API now pushes every pump.fun graduation in real time (`token:graduations` WS channel).
|
|
31
|
-
|
|
32
|
-
> **New in 1.10** — **Deshred Sniper Alerts.** `madeonsol_sniper_recent` surfaces pump.fun deploys from shred-level data ~500ms before on-chain confirmation. PRO: elite/good deployers. ULTRA: all tiers + custom watchlist. Use `sniper:deploys` WebSocket or `sniper:deploy` webhook for live push.
|
|
33
|
-
>
|
|
34
|
-
> **New in 1.9** — **Price alerts, scout leaderboard, coordination history.** `madeonsol_price_alerts_*` CRUD (PRO=5, ULTRA=25). `madeonsol_scout_leaderboard` ranks top scouts by first-touch follow-on rate. `madeonsol_coordination_history` and `madeonsol_peak_history` expose the historical record. `madeonsol_wallet_stats` now returns `derived`: win_rate, roi, verdict, biggest_miss.
|
|
35
|
-
>
|
|
36
|
-
> **New in 1.8** — **Universal Wallet API.** `madeonsol_wallet_stats`, `madeonsol_wallet_pnl`, `madeonsol_wallet_positions`, `madeonsol_wallet_trades` — FIFO cost-basis PnL and cursor-paginated raw trades for any Solana wallet. PRO+. Cache hits don't count against quota.
|
|
37
|
-
>
|
|
38
|
-
> **New in 1.7.0** *(2026-05-12)* — Two new tools: **`madeonsol_me`** (account/quota introspection — read tier, remaining requests, and per-feature usage without parsing rate-limit headers) and **`madeonsol_tokens_list`** (PRO+ filtered, sortable token directory — MC band, liquidity floor, primary DEX, authority/safety flags, plus computed 1h volume / MEV-share / MC-change deltas). Token responses now expose **velocity / MEV-share** fields. Token directory defaults to **`min_liq=2000`** to skip phantom-MC dust — pass `min_liq=0` to opt out. `/token/{mint}` now returns **structured 400 errors** (`code` / `reason` / `example` / `docs`) instead of plain strings. Deprecated `avg_entry_mc_usd` field fully removed from KOL/alpha leaderboards.
|
|
39
|
-
|
|
40
|
-
## Install via Smithery (one line)
|
|
41
|
-
|
|
42
|
-
[Smithery](https://smithery.ai/servers/madeonsol/solana-kol-intelligence) is the easiest path — it writes the config for you and handles the install:
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
npx -y smithery mcp add madeonsol/solana-kol-intelligence
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
Smithery prompts for your `MADEONSOL_API_KEY` ([free at madeonsol.com/pricing](https://madeonsol.com/pricing)) and wires up Claude Desktop or your chosen MCP client. Restart the client and ask: *"What are KOLs buying right now?"*
|
|
49
|
-
|
|
50
|
-
You can also browse tools from the CLI:
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
npx -y smithery tool get madeonsol/solana-kol-intelligence madeonsol_kol_feed
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
## Quick start — manual config (10 seconds)
|
|
57
|
-
|
|
58
|
-
```bash
|
|
59
|
-
npm install -g mcp-server-madeonsol
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Add to `claude_desktop_config.json` or Cursor MCP settings (free tier at https://madeonsol.com/pricing):
|
|
63
|
-
|
|
64
|
-
```json
|
|
65
|
-
{ "mcpServers": { "madeonsol": { "command": "mcp-server-madeonsol", "env": { "MADEONSOL_API_KEY": "msk_..." } } } }
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
Restart Claude Desktop and ask: *"What are KOLs buying right now?"*
|
|
69
|
-
|
|
70
|
-
## AI agent quickstart (x402 / pay-per-call)
|
|
71
|
-
|
|
72
|
-
Building an autonomous agent? Skip the signup. Point a **funded Solana wallet** at the server and every tool call **auto-pays a micropayment** over [x402](https://x402.org) — no API key, no account, no rate-limit dance.
|
|
73
|
-
|
|
74
|
-
```json
|
|
75
|
-
{
|
|
76
|
-
"mcpServers": {
|
|
77
|
-
"madeonsol": {
|
|
78
|
-
"command": "mcp-server-madeonsol",
|
|
79
|
-
"env": {
|
|
80
|
-
"SVM_PRIVATE_KEY": "<base58 solana private key>"
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
How it works:
|
|
88
|
-
|
|
89
|
-
- The wallet behind `SVM_PRIVATE_KEY` settles each request as a **USDC micropayment on Solana** (~$0.005–$0.02 per call, settled on-chain). No subscription, no quota.
|
|
90
|
-
- The free **`madeonsol_discovery`** tool needs no auth and returns every endpoint with its exact per-call price — call it first to see what each tool costs.
|
|
91
|
-
- Install the x402 peer deps alongside the server (only required for this mode):
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
npm install -g mcp-server-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
> **Data only.** MadeOnSol returns trading *intelligence* — it never trades, signs swaps, or takes custody of funds. The only thing your wallet ever pays for is the per-call data fee.
|
|
98
|
-
|
|
99
|
-
Prefer a fixed monthly bill, free tier, or no wallet? Use the developer path below.
|
|
100
|
-
|
|
101
|
-
## Authentication
|
|
102
|
-
|
|
103
|
-
Two options (in priority order):
|
|
104
|
-
|
|
105
|
-
| Method | Env var | Best for |
|
|
106
|
-
|---|---|---|
|
|
107
|
-
| **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/pricing) |
|
|
108
|
-
| x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
|
|
109
|
-
|
|
110
|
-
> **v1.0 breaking change:** RapidAPI auth (`RAPIDAPI_KEY`) has been removed. The MadeOnSol RapidAPI marketplace was retired on 2026-04-19. Get a free `msk_` key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
|
|
111
|
-
|
|
112
|
-
## Install
|
|
113
|
-
|
|
114
|
-
```bash
|
|
115
|
-
npm install -g mcp-server-madeonsol
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
> x402 peer deps (`@x402/fetch @x402/svm @x402/core @solana/kit @scure/base`) are only needed when using `SVM_PRIVATE_KEY`.
|
|
119
|
-
|
|
120
|
-
## Configure
|
|
121
|
-
|
|
122
|
-
### Claude Desktop
|
|
123
|
-
|
|
124
|
-
Add to `claude_desktop_config.json`:
|
|
125
|
-
|
|
126
|
-
```json
|
|
127
|
-
{
|
|
128
|
-
"mcpServers": {
|
|
129
|
-
"madeonsol": {
|
|
130
|
-
"command": "mcp-server-madeonsol",
|
|
131
|
-
"env": {
|
|
132
|
-
"MADEONSOL_API_KEY": "msk_your_api_key_here"
|
|
133
|
-
}
|
|
134
|
-
}
|
|
135
|
-
}
|
|
136
|
-
}
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
### Cursor
|
|
140
|
-
|
|
141
|
-
Add to MCP settings with the same command and env vars.
|
|
142
|
-
|
|
143
|
-
## Tools
|
|
144
|
-
|
|
145
|
-
### KOL Intelligence
|
|
146
|
-
|
|
147
|
-
| Tool | Description |
|
|
148
|
-
|---|---|
|
|
149
|
-
| `madeonsol_kol_feed` | Real-time KOL trade feed (1,000+ wallets) |
|
|
150
|
-
| `madeonsol_kol_coordination` | Multi-KOL convergence signals (v1.1) — peak-density window, exit detection, 0-100 score |
|
|
151
|
-
| `madeonsol_kol_first_touches` | First-KOL-touch events — backtested scout signal. Filter by scout tier, winrate, token age, mint suffix |
|
|
152
|
-
| `madeonsol_kol_leaderboard` | KOL PnL and win rate rankings (180 days of history; periods: today, 7d, 30d, 90d, 180d) |
|
|
153
|
-
| `madeonsol_kol_pairs` | KOL affinity matrix — which KOLs co-trade the same tokens |
|
|
154
|
-
| `madeonsol_kol_hot_tokens` | KOL momentum tokens — accelerating buy interest |
|
|
155
|
-
| `madeonsol_kol_trending_tokens` | Tokens ranked by KOL buy volume (5m–12h windows). ULTRA adds full KOL wallet addresses. |
|
|
156
|
-
| `madeonsol_kol_pnl` | Deep per-wallet PnL: equity curve, risk metrics, closed positions. ULTRA adds open positions (tokens bought but not yet sold). |
|
|
157
|
-
| `madeonsol_kol_timing` | KOL entry/exit timing profile — available on all tiers |
|
|
158
|
-
|
|
159
|
-
### Deployer Hunter
|
|
160
|
-
|
|
161
|
-
| Tool | Description |
|
|
162
|
-
|---|---|
|
|
163
|
-
| `madeonsol_deployer_alerts` | Pump.fun deployer launches with KOL enrichment. Filter by tier (elite/good/moderate/rising/cold). ULTRA unlocks full pagination. Each alert's `deployers` now includes `deployer_sol_balance` — the deployer wallet's SOL balance at alert time (null for historical rows). |
|
|
164
|
-
| `madeonsol_deployer_trajectory` | Deployer skill curve — streaks, rolling bond rate, trend — available on all tiers |
|
|
165
|
-
|
|
166
|
-
### Deshred Sniper Alerts *(new in 1.10 — Pro/Ultra)*
|
|
167
|
-
|
|
168
|
-
Pre-confirm pump.fun deploy feed reconstructed from shred-level (**deshred**) data — launches surface **~500ms before they confirm on-chain**. Pro sees elite/good deployers; Ultra sees every tier.
|
|
169
|
-
|
|
170
|
-
| Tool | Description |
|
|
171
|
-
|---|---|
|
|
172
|
-
| `madeonsol_sniper_recent` | Newest-first deshred deploy feed. Pro: elite/good · Ultra: all tiers. `watchlist: true` (Ultra) narrows to your custom deployer watchlist |
|
|
173
|
-
| `madeonsol_sniper_by_deployer` | Deshred deploys for a single deployer wallet (Ultra) |
|
|
174
|
-
|
|
175
|
-
### Wallet Tracker
|
|
176
|
-
|
|
177
|
-
| Tool | Description |
|
|
178
|
-
|---|---|
|
|
179
|
-
| `madeonsol_wallet_tracker_watchlist` | List your tracked wallets and remaining capacity (Free: 10, Pro: 50, Ultra: 100) |
|
|
180
|
-
| `madeonsol_wallet_tracker_add` | Add a wallet to your watchlist |
|
|
181
|
-
| `madeonsol_wallet_tracker_remove` | Remove a wallet from your watchlist |
|
|
182
|
-
| `madeonsol_wallet_tracker_trades` | Historical swap/transfer events for watched wallets (120-day retention) |
|
|
183
|
-
| `madeonsol_wallet_tracker_summary` | Per-wallet stats: swap counts, SOL bought/sold, last event |
|
|
184
|
-
|
|
185
|
-
### Universal Wallet *(new in 1.8 — any wallet, not just curated KOLs, PRO+)*
|
|
186
|
-
|
|
187
|
-
| Tool | Description |
|
|
188
|
-
|---|---|
|
|
189
|
-
| `madeonsol_wallet_stats` | Aggregate 90d stats + cross-product flags (is_kol, is_alpha_tracked + bot_confidence + win_rate + net_pnl, is_deployer + tokens_deployed) — quick sizing-up of an unknown wallet |
|
|
190
|
-
| `madeonsol_wallet_pnl` | Full FIFO cost-basis PnL: realized + unrealized SOL, profit factor, max drawdown, avg + median hold minutes, daily UTC PnL curve, closed + open positions hydrated with live mc-tracker prices |
|
|
191
|
-
| `madeonsol_wallet_positions` | Open positions only — lighter slice of /pnl. Shares the same cache. |
|
|
192
|
-
| `madeonsol_wallet_trades` | Cursor-paginated raw trades with action / token / since-until filters |
|
|
193
|
-
|
|
194
|
-
Cached server-side with dynamic TTL (5min / 1h / 24h based on last activity). Cost basis observable only inside the 90-day window.
|
|
195
|
-
|
|
196
|
-
### Alpha Wallet Intelligence
|
|
197
|
-
|
|
198
|
-
Scored from 1M+ early-buyer records (wallets seen in the first 20 buyers of Pump.fun tokens).
|
|
199
|
-
|
|
200
|
-
| Tool | Tier | Description |
|
|
201
|
-
|---|---|---|
|
|
202
|
-
| `madeonsol_alpha_leaderboard` | All | Top profitable early-buyer wallets. Up to 100 on Free/Pro; ULTRA unlocks 500 + bot signals |
|
|
203
|
-
| `madeonsol_alpha_wallet` | ULTRA | Full per-token breakdown + bot_signals array |
|
|
204
|
-
| `madeonsol_alpha_linked` | ULTRA | Wallets behaviorally linked (co-bought 3+ tokens within 2s) |
|
|
205
|
-
|
|
206
|
-
### Token Quality
|
|
207
|
-
|
|
208
|
-
| Tool | Tier | Description |
|
|
209
|
-
|---|---|---|
|
|
210
|
-
| `madeonsol_tokens_list` | PRO+ | Filtered, sortable token directory — MC band, liquidity floor, primary DEX, authority/safety flags, computed 1h volume / MEV-share / MC-change deltas, plus momentum sorts (`mc_change_5m_desc`, `mc_change_1h_desc`, `volume_1h_desc`, `trending`). Default `min_liq=2000` skips phantom-MC dust. |
|
|
211
|
-
| `madeonsol_almost_bonded` | PRO+ | Pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min) — `progress_pct`, `velocity_pct_per_min`, `eta_minutes`, `stalled`, `deployer_tier`, `age_minutes` |
|
|
212
|
-
| `madeonsol_token_cap_table` | PRO+ | First non-deployer early buyers, enriched with PnL/KOL/bot flags. PRO=10, ULTRA=20 |
|
|
213
|
-
| `madeonsol_token_buyer_quality` | All | 0–100 buyer-quality score + full breakdown (5-min cached) |
|
|
214
|
-
| `madeonsol_token_risk` | PRO+ | Transparent 0–100 rug-risk/safety score with `band`, explainable `factors[]`, and raw `inputs` |
|
|
215
|
-
| `madeonsol_tokens_batch_risk` | PRO+ | Bulk rug-risk/safety scoring for up to 50 mints — same shape as `madeonsol_token_risk` + `as_of`. Untracked mints return `{ mint, error: "not_tracked" }` without failing the batch; counts as one request |
|
|
216
|
-
| `madeonsol_token_candles` | PRO+ | Historical OHLCV candles (1m–1d). PRO=OHLCV 30d; ULTRA=+net flow, liquidity delta, MEV volume, full history |
|
|
217
|
-
| `madeonsol_token_flow` | PRO+ | Trade-flow aggregate (organic-vs-fake volume) over a 1h/24h `window` — unique wallets/buyers/sellers, buy/sell counts + SOL, `net_sol`, `trades_per_wallet` wash-trading proxy |
|
|
218
|
-
|
|
219
|
-
### Copy-Trade Rules (PRO/ULTRA)
|
|
220
|
-
|
|
221
|
-
Server-side rules that fire signals when a watched source wallet trades. Delivered via webhook (HMAC-signed) and/or WebSocket.
|
|
222
|
-
|
|
223
|
-
| Tool | Description |
|
|
224
|
-
|---|---|
|
|
225
|
-
| `madeonsol_copytrade_list` | List your rules |
|
|
226
|
-
| `madeonsol_copytrade_create` | Create a rule. Returns `webhook_secret` once — store it |
|
|
227
|
-
| `madeonsol_copytrade_get` | Get one rule |
|
|
228
|
-
| `madeonsol_copytrade_update` | Update fields or toggle `is_active` |
|
|
229
|
-
| `madeonsol_copytrade_delete` | Delete permanently |
|
|
230
|
-
| `madeonsol_copytrade_signals` | Recent fired signals (up to 7 days) |
|
|
231
|
-
|
|
232
|
-
### KOL Coordination Alerts (PRO/ULTRA — v1.1 push signals)
|
|
233
|
-
|
|
234
|
-
Real-time push alerts when a KOL cluster co-buys the same token. Fires within ~1s (pg_notify push). Delivered via WebSocket (`kol:coordination` channel, user-scoped) and/or HMAC-signed webhook.
|
|
235
|
-
|
|
236
|
-
| Tool | Description |
|
|
237
|
-
|---|---|
|
|
238
|
-
| `madeonsol_coordination_alerts_list` | List your rules (PRO=5, ULTRA=20) |
|
|
239
|
-
| `madeonsol_coordination_alerts_create` | Create a rule. Returns `webhook_secret` once — store it |
|
|
240
|
-
| `madeonsol_coordination_alerts_get` | Get one rule |
|
|
241
|
-
| `madeonsol_coordination_alerts_update` | Update fields or toggle `is_active` |
|
|
242
|
-
| `madeonsol_coordination_alerts_delete` | Delete permanently |
|
|
243
|
-
|
|
244
|
-
### KOL Scout Signal — first KOL touches *(new in 1.3)*
|
|
245
|
-
|
|
246
|
-
Every "first KOL buy on a token mint" event. Filterable by **scout tier** (S/A/B/C from `mv_kol_scout_score`), KOL winrate, token age, mint suffix.
|
|
247
|
-
|
|
248
|
-
**Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys / 72,549 events). Public leaderboard at [madeonsol.com/kol/scouts](https://madeonsol.com/kol/scouts).
|
|
249
|
-
|
|
250
|
-
| Tool | Description |
|
|
251
|
-
|---|---|
|
|
252
|
-
| `madeonsol_kol_first_touches` | Recent first-KOL-touch events. Filters: `min_scout_tier`, `min_kol_winrate_7d`, `token_age_max_min`, `mint_suffix`, `preset`, etc. |
|
|
253
|
-
| `madeonsol_first_touch_subscriptions_list` | List your first-touch webhook subscriptions — ULTRA |
|
|
254
|
-
| `madeonsol_first_touch_subscriptions_create` | Create a webhook rule (HMAC-signed). Returns `webhook_secret` once — store it. Up to 10/user — ULTRA |
|
|
255
|
-
| `madeonsol_first_touch_subscriptions_get` | Get one subscription — ULTRA |
|
|
256
|
-
| `madeonsol_first_touch_subscriptions_update` | Update fields or toggle `is_active` — ULTRA |
|
|
257
|
-
| `madeonsol_first_touch_subscriptions_delete` | Delete permanently — ULTRA |
|
|
258
|
-
|
|
259
|
-
> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
|
|
260
|
-
|
|
261
|
-
### Price Alerts *(new in 1.9)*
|
|
262
|
-
|
|
263
|
-
CRUD for token dip/recovery price alerts. Fires when a token's market cap crosses your threshold. PRO=5 rules, ULTRA=25.
|
|
264
|
-
|
|
265
|
-
| Tool | Description |
|
|
266
|
-
|---|---|
|
|
267
|
-
| `madeonsol_price_alerts_list` | List your price alert rules |
|
|
268
|
-
| `madeonsol_price_alerts_create` | Create a dip/recovery alert. Returns `webhook_secret` once — store it |
|
|
269
|
-
| `madeonsol_price_alerts_get` | Get one alert rule by ID |
|
|
270
|
-
| `madeonsol_price_alerts_update` | Update fields or toggle `is_active` |
|
|
271
|
-
| `madeonsol_price_alerts_delete` | Delete permanently |
|
|
272
|
-
|
|
273
|
-
### Scout Leaderboard & KOL Consensus *(new in 1.9)*
|
|
274
|
-
|
|
275
|
-
| Tool | Tier | Description |
|
|
276
|
-
|---|---|---|
|
|
277
|
-
| `madeonsol_scout_leaderboard` | PRO+ | Top scout-tier KOLs ranked by first-touch follow-on rate, win rate, and ROI |
|
|
278
|
-
| `madeonsol_kol_consensus` | PRO+ | Tokens with the strongest KOL agreement signal — weighted by scout score and recent PnL |
|
|
279
|
-
| `madeonsol_peak_history` | PRO+ | Historical peak-density windows for a token — every coordination spike with KOL breakdown |
|
|
280
|
-
| `madeonsol_coordination_history` | PRO+ | Global coordination event log with token, KOL count, score, and outcome |
|
|
281
|
-
|
|
282
|
-
### Wallet Derived Stats *(new in 1.9)*
|
|
283
|
-
|
|
284
|
-
`madeonsol_wallet_stats` now returns a `stats` object with derived fields: `win_rate` (0-1), `roi`, `verdict` ("strong" | "profitable" | "neutral" | "losing"), and `biggest_miss` (token with the highest post-exit gain the wallet missed).
|
|
285
|
-
|
|
286
|
-
### Streaming & Webhooks
|
|
287
|
-
|
|
288
|
-
| Tool | Description |
|
|
289
|
-
|---|---|
|
|
290
|
-
| `madeonsol_stream_token` | Get a 24h WebSocket token for KOL/deployer streaming and DEX trade stream — PRO/ULTRA |
|
|
291
|
-
| `madeonsol_stream_sessions_list` | List your live WebSocket sessions — `id`, `service`, `tier`, `channels`, `connected_at`, `remote_ip`, `messages_sent` — PRO/ULTRA |
|
|
292
|
-
| `madeonsol_stream_session_kill` | Evict a live WebSocket session by id to free its connection slot (e.g. a ghost socket) — PRO/ULTRA |
|
|
293
|
-
| `madeonsol_create_webhook` | Register a webhook for real-time push notifications — PRO/ULTRA |
|
|
294
|
-
| `madeonsol_list_webhooks` | List your registered webhooks — PRO/ULTRA |
|
|
295
|
-
| `madeonsol_delete_webhook` | Delete a webhook by ID — PRO/ULTRA |
|
|
296
|
-
| `madeonsol_test_webhook` | Send a test payload to verify a webhook — PRO/ULTRA |
|
|
297
|
-
|
|
298
|
-
### General
|
|
299
|
-
|
|
300
|
-
| Tool | Description |
|
|
301
|
-
|---|---|
|
|
302
|
-
| `madeonsol_discovery` | List all endpoints and prices (free, no auth) |
|
|
303
|
-
| `madeonsol_me` | Inspect your account — tier, daily/burst quota state, remaining requests, subscription expiry, per-feature usage (webhooks, copy-trade wallets, coordination rules, etc.). Self-throttle without parsing rate-limit headers. |
|
|
304
|
-
|
|
305
|
-
## Tiers
|
|
306
|
-
|
|
307
|
-
| Tier | Price | Wallets tracked | Requests/day |
|
|
308
|
-
|------|-------|-----------------|--------------|
|
|
309
|
-
| BASIC (free) | $0 | 10 | 200 |
|
|
310
|
-
| PRO | €43/mo (€430/yr) ≈ $49 | 50 | 10,000 |
|
|
311
|
-
| ULTRA | €131/mo (€1310/yr) ≈ $149 | 100 + WS events | 100,000 |
|
|
312
|
-
|
|
313
|
-
Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
|
|
314
|
-
|
|
315
|
-
## Also Available
|
|
316
|
-
|
|
317
|
-
| Platform | Package |
|
|
318
|
-
|---|---|
|
|
319
|
-
| TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
|
|
320
|
-
| Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
|
|
321
|
-
| Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
|
|
322
|
-
| ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
|
|
323
|
-
| Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
|
|
324
|
-
|
|
325
|
-
## License
|
|
326
|
-
|
|
327
|
-
MIT
|
|
1
|
+
# mcp-server-madeonsol
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/mcp-server-madeonsol)
|
|
4
|
+
[](https://www.npmjs.com/package/mcp-server-madeonsol)
|
|
5
|
+
[](https://smithery.ai/servers/madeonsol/solana-kol-intelligence)
|
|
6
|
+
[](https://glama.ai/mcp/servers/madeonsol/mcp-server-madeonsol)
|
|
7
|
+
[](https://modelcontextprotocol.io/)
|
|
8
|
+
[](LICENSE)
|
|
9
|
+
|
|
10
|
+
> ⚡ **[Install via Smithery](#install-via-smithery-one-line)** · 🤖 **[Use in Claude Desktop](#claude-desktop)** · 🖱️ **[Use in Cursor](#cursor)** · 📚 **[API docs](https://madeonsol.com/api-docs)** · 💰 **[Free API key](https://madeonsol.com/pricing)** · 🔎 **[On Glama](https://glama.ai/mcp/servers/madeonsol/mcp-server-madeonsol)**
|
|
11
|
+
|
|
12
|
+
MCP server for [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Use from Claude Desktop, Cursor, or any MCP-compatible client.
|
|
13
|
+
|
|
14
|
+
> Real-time Solana trading intelligence: track 1,069 KOL wallets with <3s latency, score 23,000+ Pump.fun deployers, surface deshred deploy signals **~500ms before on-chain confirmation**, detect multi-KOL coordination, and stream every DEX trade across 9+ programs. Free tier: 200 requests/day, every endpoint — no signup payment. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
|
|
15
|
+
|
|
16
|
+
> **New in 1.16.0** — **Batch risk scoring + live stream-session control.** New tool `madeonsol_tokens_batch_risk` — bulk rug-risk/safety scoring for up to 50 mints in one call, returning the same per-mint shape as `madeonsol_token_risk` (0–100 score, `band`, explainable `factors[]`, raw `inputs`) plus an `as_of` timestamp; untracked mints come back as `{ mint, error: "not_tracked" }` without failing the batch, and the whole call counts as one request against quota. Plus two WebSocket session tools: `madeonsol_stream_sessions_list` (list your live sessions — `id`, `service`, `tier`, `channels`, `connected_at`, `remote_ip`, `messages_sent`) and `madeonsol_stream_session_kill` (force-disconnect a session by id to free its connection slot, e.g. a ghost socket). PRO/ULTRA only.
|
|
17
|
+
>
|
|
18
|
+
> **New in 1.15.0** — **Almost-bonded discovery + trending sorts.** New tool `madeonsol_almost_bonded` — pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min): "95% and accelerating" beats "92% stalled". Each token carries `progress_pct`, `velocity_pct_per_min`, `eta_minutes`, `stalled`, `real_sol_reserves`, `market_cap_usd`, `liquidity_usd`, `authorities_revoked`, `deployer_tier`, and `age_minutes`. Params: `min_progress`, `max_progress`, `min_velocity_pct_per_min`, `max_age_minutes`, `deployer_tier`, `authority_revoked`, `min_liq`, `sort` (velocity_desc / progress_desc / eta_asc), `limit`. PRO/ULTRA only. Plus `madeonsol_tokens_list` gains four momentum sorts — `mc_change_5m_desc`, `mc_change_1h_desc`, `volume_1h_desc`, and `trending` (composite recent-volume × positive-momentum rank).
|
|
19
|
+
>
|
|
20
|
+
> **New in 1.14.0** — **Token trade flow.** New tool `madeonsol_token_flow` — a trade-flow aggregate (organic-vs-fake volume) over a `1h`/`24h` window: `unique_wallets` / `unique_buyers` / `unique_sellers`, `buy_count` / `sell_count` / `total_trades`, `buy_sol` / `sell_sol` / `net_sol` (sell − buy; positive = net SOL leaving the pool), and `trades_per_wallet` (wash-trading proxy). PRO/ULTRA only. Deployer alerts (`madeonsol_deployer_alerts`) now carry `deployers.deployer_sol_balance` — the deployer wallet's SOL balance at alert time (null for historical rows).
|
|
21
|
+
>
|
|
22
|
+
> **New in 1.13.0** — **Token OHLCV candles.** New tool `madeonsol_token_candles` — historical price candles (1m/5m/15m/1h/4h/1d) aggregated from the on-chain trade firehose. Each candle has `t/open/high/low/close/volume_usd/trades/market_cap_usd`. PRO returns OHLCV for the last 30 days; ULTRA adds buy/sell volume + count splits, net flow, MEV volume, open/close liquidity, high/low MC, and full history. PRO/ULTRA only.
|
|
23
|
+
>
|
|
24
|
+
> **New in 1.12.0** — **Token risk score.** New tool `madeonsol_token_risk` — a transparent 0–100 rug-risk/safety score (higher = riskier) with a `band` (safe/caution/danger), an explainable `factors[]` array, and the raw `inputs` (mint/freeze authority, liquidity, liq-to-MC ratio, transfer fee, launch cohort, deployer bond rate, KOL signal, blacklist). PRO/ULTRA only.
|
|
25
|
+
>
|
|
26
|
+
> **New in 1.11.0** — `madeonsol_tokens_list` gains three new filter params: `min_liq_mc_ratio`, `max_liq_mc_ratio`, and `deployer_tier`. Response items now include `liquidity_to_mc_ratio` and `deployer_tier`. New tool: `madeonsol_signal_performance` — evaluate signal efficacy (hit rate, sample size, median outcome) before acting on any signal. KOL leaderboard entries now include `median_hold_minutes_30d` and `percentile_early_entry_30d`.
|
|
27
|
+
>
|
|
28
|
+
> **New in 1.10.4** — Deployer alerts/profiles now expose `runner_rate` + `labeled_tokens` (fraction of a deployer's labeled tokens that ran vs dumped, gate on `labeled_tokens` ≥3) plus `avg_time_to_bond_minutes`.
|
|
29
|
+
|
|
30
|
+
> **New in 1.10.3** — **Dump-cluster detection.** `madeonsol_token_buyer_quality` breakdown now includes `dump_cluster_count` (3+ dump-cluster wallets in the first-20 → 94% historical dump rate vs 61% base) and `recycled_early_buyer_count`. Full breakdown is returned on all tiers. Also: the API now pushes every pump.fun graduation in real time (`token:graduations` WS channel).
|
|
31
|
+
|
|
32
|
+
> **New in 1.10** — **Deshred Sniper Alerts.** `madeonsol_sniper_recent` surfaces pump.fun deploys from shred-level data ~500ms before on-chain confirmation. PRO: elite/good deployers. ULTRA: all tiers + custom watchlist. Use `sniper:deploys` WebSocket or `sniper:deploy` webhook for live push.
|
|
33
|
+
>
|
|
34
|
+
> **New in 1.9** — **Price alerts, scout leaderboard, coordination history.** `madeonsol_price_alerts_*` CRUD (PRO=5, ULTRA=25). `madeonsol_scout_leaderboard` ranks top scouts by first-touch follow-on rate. `madeonsol_coordination_history` and `madeonsol_peak_history` expose the historical record. `madeonsol_wallet_stats` now returns `derived`: win_rate, roi, verdict, biggest_miss.
|
|
35
|
+
>
|
|
36
|
+
> **New in 1.8** — **Universal Wallet API.** `madeonsol_wallet_stats`, `madeonsol_wallet_pnl`, `madeonsol_wallet_positions`, `madeonsol_wallet_trades` — FIFO cost-basis PnL and cursor-paginated raw trades for any Solana wallet. PRO+. Cache hits don't count against quota.
|
|
37
|
+
>
|
|
38
|
+
> **New in 1.7.0** *(2026-05-12)* — Two new tools: **`madeonsol_me`** (account/quota introspection — read tier, remaining requests, and per-feature usage without parsing rate-limit headers) and **`madeonsol_tokens_list`** (PRO+ filtered, sortable token directory — MC band, liquidity floor, primary DEX, authority/safety flags, plus computed 1h volume / MEV-share / MC-change deltas). Token responses now expose **velocity / MEV-share** fields. Token directory defaults to **`min_liq=2000`** to skip phantom-MC dust — pass `min_liq=0` to opt out. `/token/{mint}` now returns **structured 400 errors** (`code` / `reason` / `example` / `docs`) instead of plain strings. Deprecated `avg_entry_mc_usd` field fully removed from KOL/alpha leaderboards.
|
|
39
|
+
|
|
40
|
+
## Install via Smithery (one line)
|
|
41
|
+
|
|
42
|
+
[Smithery](https://smithery.ai/servers/madeonsol/solana-kol-intelligence) is the easiest path — it writes the config for you and handles the install:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
npx -y smithery mcp add madeonsol/solana-kol-intelligence
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Smithery prompts for your `MADEONSOL_API_KEY` ([free at madeonsol.com/pricing](https://madeonsol.com/pricing)) and wires up Claude Desktop or your chosen MCP client. Restart the client and ask: *"What are KOLs buying right now?"*
|
|
49
|
+
|
|
50
|
+
You can also browse tools from the CLI:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
npx -y smithery tool get madeonsol/solana-kol-intelligence madeonsol_kol_feed
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Quick start — manual config (10 seconds)
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npm install -g mcp-server-madeonsol
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Add to `claude_desktop_config.json` or Cursor MCP settings (free tier at https://madeonsol.com/pricing):
|
|
63
|
+
|
|
64
|
+
```json
|
|
65
|
+
{ "mcpServers": { "madeonsol": { "command": "mcp-server-madeonsol", "env": { "MADEONSOL_API_KEY": "msk_..." } } } }
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Restart Claude Desktop and ask: *"What are KOLs buying right now?"*
|
|
69
|
+
|
|
70
|
+
## AI agent quickstart (x402 / pay-per-call)
|
|
71
|
+
|
|
72
|
+
Building an autonomous agent? Skip the signup. Point a **funded Solana wallet** at the server and every tool call **auto-pays a micropayment** over [x402](https://x402.org) — no API key, no account, no rate-limit dance.
|
|
73
|
+
|
|
74
|
+
```json
|
|
75
|
+
{
|
|
76
|
+
"mcpServers": {
|
|
77
|
+
"madeonsol": {
|
|
78
|
+
"command": "mcp-server-madeonsol",
|
|
79
|
+
"env": {
|
|
80
|
+
"SVM_PRIVATE_KEY": "<base58 solana private key>"
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
How it works:
|
|
88
|
+
|
|
89
|
+
- The wallet behind `SVM_PRIVATE_KEY` settles each request as a **USDC micropayment on Solana** (~$0.005–$0.02 per call, settled on-chain). No subscription, no quota.
|
|
90
|
+
- The free **`madeonsol_discovery`** tool needs no auth and returns every endpoint with its exact per-call price — call it first to see what each tool costs.
|
|
91
|
+
- Install the x402 peer deps alongside the server (only required for this mode):
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
npm install -g mcp-server-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
> **Data only.** MadeOnSol returns trading *intelligence* — it never trades, signs swaps, or takes custody of funds. The only thing your wallet ever pays for is the per-call data fee.
|
|
98
|
+
|
|
99
|
+
Prefer a fixed monthly bill, free tier, or no wallet? Use the developer path below.
|
|
100
|
+
|
|
101
|
+
## Authentication
|
|
102
|
+
|
|
103
|
+
Two options (in priority order):
|
|
104
|
+
|
|
105
|
+
| Method | Env var | Best for |
|
|
106
|
+
|---|---|---|
|
|
107
|
+
| **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/pricing) |
|
|
108
|
+
| x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
|
|
109
|
+
|
|
110
|
+
> **v1.0 breaking change:** RapidAPI auth (`RAPIDAPI_KEY`) has been removed. The MadeOnSol RapidAPI marketplace was retired on 2026-04-19. Get a free `msk_` key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
|
|
111
|
+
|
|
112
|
+
## Install
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
npm install -g mcp-server-madeonsol
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
> x402 peer deps (`@x402/fetch @x402/svm @x402/core @solana/kit @scure/base`) are only needed when using `SVM_PRIVATE_KEY`.
|
|
119
|
+
|
|
120
|
+
## Configure
|
|
121
|
+
|
|
122
|
+
### Claude Desktop
|
|
123
|
+
|
|
124
|
+
Add to `claude_desktop_config.json`:
|
|
125
|
+
|
|
126
|
+
```json
|
|
127
|
+
{
|
|
128
|
+
"mcpServers": {
|
|
129
|
+
"madeonsol": {
|
|
130
|
+
"command": "mcp-server-madeonsol",
|
|
131
|
+
"env": {
|
|
132
|
+
"MADEONSOL_API_KEY": "msk_your_api_key_here"
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Cursor
|
|
140
|
+
|
|
141
|
+
Add to MCP settings with the same command and env vars.
|
|
142
|
+
|
|
143
|
+
## Tools
|
|
144
|
+
|
|
145
|
+
### KOL Intelligence
|
|
146
|
+
|
|
147
|
+
| Tool | Description |
|
|
148
|
+
|---|---|
|
|
149
|
+
| `madeonsol_kol_feed` | Real-time KOL trade feed (1,000+ wallets) |
|
|
150
|
+
| `madeonsol_kol_coordination` | Multi-KOL convergence signals (v1.1) — peak-density window, exit detection, 0-100 score |
|
|
151
|
+
| `madeonsol_kol_first_touches` | First-KOL-touch events — backtested scout signal. Filter by scout tier, winrate, token age, mint suffix |
|
|
152
|
+
| `madeonsol_kol_leaderboard` | KOL PnL and win rate rankings (180 days of history; periods: today, 7d, 30d, 90d, 180d) |
|
|
153
|
+
| `madeonsol_kol_pairs` | KOL affinity matrix — which KOLs co-trade the same tokens |
|
|
154
|
+
| `madeonsol_kol_hot_tokens` | KOL momentum tokens — accelerating buy interest |
|
|
155
|
+
| `madeonsol_kol_trending_tokens` | Tokens ranked by KOL buy volume (5m–12h windows). ULTRA adds full KOL wallet addresses. |
|
|
156
|
+
| `madeonsol_kol_pnl` | Deep per-wallet PnL: equity curve, risk metrics, closed positions. ULTRA adds open positions (tokens bought but not yet sold). |
|
|
157
|
+
| `madeonsol_kol_timing` | KOL entry/exit timing profile — available on all tiers |
|
|
158
|
+
|
|
159
|
+
### Deployer Hunter
|
|
160
|
+
|
|
161
|
+
| Tool | Description |
|
|
162
|
+
|---|---|
|
|
163
|
+
| `madeonsol_deployer_alerts` | Pump.fun deployer launches with KOL enrichment. Filter by tier (elite/good/moderate/rising/cold). ULTRA unlocks full pagination. Each alert's `deployers` now includes `deployer_sol_balance` — the deployer wallet's SOL balance at alert time (null for historical rows). |
|
|
164
|
+
| `madeonsol_deployer_trajectory` | Deployer skill curve — streaks, rolling bond rate, trend — available on all tiers |
|
|
165
|
+
|
|
166
|
+
### Deshred Sniper Alerts *(new in 1.10 — Pro/Ultra)*
|
|
167
|
+
|
|
168
|
+
Pre-confirm pump.fun deploy feed reconstructed from shred-level (**deshred**) data — launches surface **~500ms before they confirm on-chain**. Pro sees elite/good deployers; Ultra sees every tier.
|
|
169
|
+
|
|
170
|
+
| Tool | Description |
|
|
171
|
+
|---|---|
|
|
172
|
+
| `madeonsol_sniper_recent` | Newest-first deshred deploy feed. Pro: elite/good · Ultra: all tiers. `watchlist: true` (Ultra) narrows to your custom deployer watchlist |
|
|
173
|
+
| `madeonsol_sniper_by_deployer` | Deshred deploys for a single deployer wallet (Ultra) |
|
|
174
|
+
|
|
175
|
+
### Wallet Tracker
|
|
176
|
+
|
|
177
|
+
| Tool | Description |
|
|
178
|
+
|---|---|
|
|
179
|
+
| `madeonsol_wallet_tracker_watchlist` | List your tracked wallets and remaining capacity (Free: 10, Pro: 50, Ultra: 100) |
|
|
180
|
+
| `madeonsol_wallet_tracker_add` | Add a wallet to your watchlist |
|
|
181
|
+
| `madeonsol_wallet_tracker_remove` | Remove a wallet from your watchlist |
|
|
182
|
+
| `madeonsol_wallet_tracker_trades` | Historical swap/transfer events for watched wallets (120-day retention) |
|
|
183
|
+
| `madeonsol_wallet_tracker_summary` | Per-wallet stats: swap counts, SOL bought/sold, last event |
|
|
184
|
+
|
|
185
|
+
### Universal Wallet *(new in 1.8 — any wallet, not just curated KOLs, PRO+)*
|
|
186
|
+
|
|
187
|
+
| Tool | Description |
|
|
188
|
+
|---|---|
|
|
189
|
+
| `madeonsol_wallet_stats` | Aggregate 90d stats + cross-product flags (is_kol, is_alpha_tracked + bot_confidence + win_rate + net_pnl, is_deployer + tokens_deployed) — quick sizing-up of an unknown wallet |
|
|
190
|
+
| `madeonsol_wallet_pnl` | Full FIFO cost-basis PnL: realized + unrealized SOL, profit factor, max drawdown, avg + median hold minutes, daily UTC PnL curve, closed + open positions hydrated with live mc-tracker prices |
|
|
191
|
+
| `madeonsol_wallet_positions` | Open positions only — lighter slice of /pnl. Shares the same cache. |
|
|
192
|
+
| `madeonsol_wallet_trades` | Cursor-paginated raw trades with action / token / since-until filters |
|
|
193
|
+
|
|
194
|
+
Cached server-side with dynamic TTL (5min / 1h / 24h based on last activity). Cost basis observable only inside the 90-day window.
|
|
195
|
+
|
|
196
|
+
### Alpha Wallet Intelligence
|
|
197
|
+
|
|
198
|
+
Scored from 1M+ early-buyer records (wallets seen in the first 20 buyers of Pump.fun tokens).
|
|
199
|
+
|
|
200
|
+
| Tool | Tier | Description |
|
|
201
|
+
|---|---|---|
|
|
202
|
+
| `madeonsol_alpha_leaderboard` | All | Top profitable early-buyer wallets. Up to 100 on Free/Pro; ULTRA unlocks 500 + bot signals |
|
|
203
|
+
| `madeonsol_alpha_wallet` | ULTRA | Full per-token breakdown + bot_signals array |
|
|
204
|
+
| `madeonsol_alpha_linked` | ULTRA | Wallets behaviorally linked (co-bought 3+ tokens within 2s) |
|
|
205
|
+
|
|
206
|
+
### Token Quality
|
|
207
|
+
|
|
208
|
+
| Tool | Tier | Description |
|
|
209
|
+
|---|---|---|
|
|
210
|
+
| `madeonsol_tokens_list` | PRO+ | Filtered, sortable token directory — MC band, liquidity floor, primary DEX, authority/safety flags, computed 1h volume / MEV-share / MC-change deltas, plus momentum sorts (`mc_change_5m_desc`, `mc_change_1h_desc`, `volume_1h_desc`, `trending`). Default `min_liq=2000` skips phantom-MC dust. |
|
|
211
|
+
| `madeonsol_almost_bonded` | PRO+ | Pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min) — `progress_pct`, `velocity_pct_per_min`, `eta_minutes`, `stalled`, `deployer_tier`, `age_minutes` |
|
|
212
|
+
| `madeonsol_token_cap_table` | PRO+ | First non-deployer early buyers, enriched with PnL/KOL/bot flags. PRO=10, ULTRA=20 |
|
|
213
|
+
| `madeonsol_token_buyer_quality` | All | 0–100 buyer-quality score + full breakdown (5-min cached) |
|
|
214
|
+
| `madeonsol_token_risk` | PRO+ | Transparent 0–100 rug-risk/safety score with `band`, explainable `factors[]`, and raw `inputs` |
|
|
215
|
+
| `madeonsol_tokens_batch_risk` | PRO+ | Bulk rug-risk/safety scoring for up to 50 mints — same shape as `madeonsol_token_risk` + `as_of`. Untracked mints return `{ mint, error: "not_tracked" }` without failing the batch; counts as one request |
|
|
216
|
+
| `madeonsol_token_candles` | PRO+ | Historical OHLCV candles (1m–1d). PRO=OHLCV 30d; ULTRA=+net flow, liquidity delta, MEV volume, full history |
|
|
217
|
+
| `madeonsol_token_flow` | PRO+ | Trade-flow aggregate (organic-vs-fake volume) over a 1h/24h `window` — unique wallets/buyers/sellers, buy/sell counts + SOL, `net_sol`, `trades_per_wallet` wash-trading proxy |
|
|
218
|
+
|
|
219
|
+
### Copy-Trade Rules (PRO/ULTRA)
|
|
220
|
+
|
|
221
|
+
Server-side rules that fire signals when a watched source wallet trades. Delivered via webhook (HMAC-signed) and/or WebSocket.
|
|
222
|
+
|
|
223
|
+
| Tool | Description |
|
|
224
|
+
|---|---|
|
|
225
|
+
| `madeonsol_copytrade_list` | List your rules |
|
|
226
|
+
| `madeonsol_copytrade_create` | Create a rule. Returns `webhook_secret` once — store it |
|
|
227
|
+
| `madeonsol_copytrade_get` | Get one rule |
|
|
228
|
+
| `madeonsol_copytrade_update` | Update fields or toggle `is_active` |
|
|
229
|
+
| `madeonsol_copytrade_delete` | Delete permanently |
|
|
230
|
+
| `madeonsol_copytrade_signals` | Recent fired signals (up to 7 days) |
|
|
231
|
+
|
|
232
|
+
### KOL Coordination Alerts (PRO/ULTRA — v1.1 push signals)
|
|
233
|
+
|
|
234
|
+
Real-time push alerts when a KOL cluster co-buys the same token. Fires within ~1s (pg_notify push). Delivered via WebSocket (`kol:coordination` channel, user-scoped) and/or HMAC-signed webhook.
|
|
235
|
+
|
|
236
|
+
| Tool | Description |
|
|
237
|
+
|---|---|
|
|
238
|
+
| `madeonsol_coordination_alerts_list` | List your rules (PRO=5, ULTRA=20) |
|
|
239
|
+
| `madeonsol_coordination_alerts_create` | Create a rule. Returns `webhook_secret` once — store it |
|
|
240
|
+
| `madeonsol_coordination_alerts_get` | Get one rule |
|
|
241
|
+
| `madeonsol_coordination_alerts_update` | Update fields or toggle `is_active` |
|
|
242
|
+
| `madeonsol_coordination_alerts_delete` | Delete permanently |
|
|
243
|
+
|
|
244
|
+
### KOL Scout Signal — first KOL touches *(new in 1.3)*
|
|
245
|
+
|
|
246
|
+
Every "first KOL buy on a token mint" event. Filterable by **scout tier** (S/A/B/C from `mv_kol_scout_score`), KOL winrate, token age, mint suffix.
|
|
247
|
+
|
|
248
|
+
**Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys / 72,549 events). Public leaderboard at [madeonsol.com/kol/scouts](https://madeonsol.com/kol/scouts).
|
|
249
|
+
|
|
250
|
+
| Tool | Description |
|
|
251
|
+
|---|---|
|
|
252
|
+
| `madeonsol_kol_first_touches` | Recent first-KOL-touch events. Filters: `min_scout_tier`, `min_kol_winrate_7d`, `token_age_max_min`, `mint_suffix`, `preset`, etc. |
|
|
253
|
+
| `madeonsol_first_touch_subscriptions_list` | List your first-touch webhook subscriptions — ULTRA |
|
|
254
|
+
| `madeonsol_first_touch_subscriptions_create` | Create a webhook rule (HMAC-signed). Returns `webhook_secret` once — store it. Up to 10/user — ULTRA |
|
|
255
|
+
| `madeonsol_first_touch_subscriptions_get` | Get one subscription — ULTRA |
|
|
256
|
+
| `madeonsol_first_touch_subscriptions_update` | Update fields or toggle `is_active` — ULTRA |
|
|
257
|
+
| `madeonsol_first_touch_subscriptions_delete` | Delete permanently — ULTRA |
|
|
258
|
+
|
|
259
|
+
> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
|
|
260
|
+
|
|
261
|
+
### Price Alerts *(new in 1.9)*
|
|
262
|
+
|
|
263
|
+
CRUD for token dip/recovery price alerts. Fires when a token's market cap crosses your threshold. PRO=5 rules, ULTRA=25.
|
|
264
|
+
|
|
265
|
+
| Tool | Description |
|
|
266
|
+
|---|---|
|
|
267
|
+
| `madeonsol_price_alerts_list` | List your price alert rules |
|
|
268
|
+
| `madeonsol_price_alerts_create` | Create a dip/recovery alert. Returns `webhook_secret` once — store it |
|
|
269
|
+
| `madeonsol_price_alerts_get` | Get one alert rule by ID |
|
|
270
|
+
| `madeonsol_price_alerts_update` | Update fields or toggle `is_active` |
|
|
271
|
+
| `madeonsol_price_alerts_delete` | Delete permanently |
|
|
272
|
+
|
|
273
|
+
### Scout Leaderboard & KOL Consensus *(new in 1.9)*
|
|
274
|
+
|
|
275
|
+
| Tool | Tier | Description |
|
|
276
|
+
|---|---|---|
|
|
277
|
+
| `madeonsol_scout_leaderboard` | PRO+ | Top scout-tier KOLs ranked by first-touch follow-on rate, win rate, and ROI |
|
|
278
|
+
| `madeonsol_kol_consensus` | PRO+ | Tokens with the strongest KOL agreement signal — weighted by scout score and recent PnL |
|
|
279
|
+
| `madeonsol_peak_history` | PRO+ | Historical peak-density windows for a token — every coordination spike with KOL breakdown |
|
|
280
|
+
| `madeonsol_coordination_history` | PRO+ | Global coordination event log with token, KOL count, score, and outcome |
|
|
281
|
+
|
|
282
|
+
### Wallet Derived Stats *(new in 1.9)*
|
|
283
|
+
|
|
284
|
+
`madeonsol_wallet_stats` now returns a `stats` object with derived fields: `win_rate` (0-1), `roi`, `verdict` ("strong" | "profitable" | "neutral" | "losing"), and `biggest_miss` (token with the highest post-exit gain the wallet missed).
|
|
285
|
+
|
|
286
|
+
### Streaming & Webhooks
|
|
287
|
+
|
|
288
|
+
| Tool | Description |
|
|
289
|
+
|---|---|
|
|
290
|
+
| `madeonsol_stream_token` | Get a 24h WebSocket token for KOL/deployer streaming and DEX trade stream — PRO/ULTRA |
|
|
291
|
+
| `madeonsol_stream_sessions_list` | List your live WebSocket sessions — `id`, `service`, `tier`, `channels`, `connected_at`, `remote_ip`, `messages_sent` — PRO/ULTRA |
|
|
292
|
+
| `madeonsol_stream_session_kill` | Evict a live WebSocket session by id to free its connection slot (e.g. a ghost socket) — PRO/ULTRA |
|
|
293
|
+
| `madeonsol_create_webhook` | Register a webhook for real-time push notifications — PRO/ULTRA |
|
|
294
|
+
| `madeonsol_list_webhooks` | List your registered webhooks — PRO/ULTRA |
|
|
295
|
+
| `madeonsol_delete_webhook` | Delete a webhook by ID — PRO/ULTRA |
|
|
296
|
+
| `madeonsol_test_webhook` | Send a test payload to verify a webhook — PRO/ULTRA |
|
|
297
|
+
|
|
298
|
+
### General
|
|
299
|
+
|
|
300
|
+
| Tool | Description |
|
|
301
|
+
|---|---|
|
|
302
|
+
| `madeonsol_discovery` | List all endpoints and prices (free, no auth) |
|
|
303
|
+
| `madeonsol_me` | Inspect your account — tier, daily/burst quota state, remaining requests, subscription expiry, per-feature usage (webhooks, copy-trade wallets, coordination rules, etc.). Self-throttle without parsing rate-limit headers. |
|
|
304
|
+
|
|
305
|
+
## Tiers
|
|
306
|
+
|
|
307
|
+
| Tier | Price | Wallets tracked | Requests/day |
|
|
308
|
+
|------|-------|-----------------|--------------|
|
|
309
|
+
| BASIC (free) | $0 | 10 | 200 |
|
|
310
|
+
| PRO | €43/mo (€430/yr) ≈ $49 | 50 | 10,000 |
|
|
311
|
+
| ULTRA | €131/mo (€1310/yr) ≈ $149 | 100 + WS events | 100,000 |
|
|
312
|
+
|
|
313
|
+
Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
|
|
314
|
+
|
|
315
|
+
## Also Available
|
|
316
|
+
|
|
317
|
+
| Platform | Package |
|
|
318
|
+
|---|---|
|
|
319
|
+
| TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
|
|
320
|
+
| Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
|
|
321
|
+
| Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
|
|
322
|
+
| ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
|
|
323
|
+
| Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
|
|
324
|
+
|
|
325
|
+
## License
|
|
326
|
+
|
|
327
|
+
MIT
|
package/dist/index.js
CHANGED
|
@@ -1033,7 +1033,7 @@ async function main() {
|
|
|
1033
1033
|
{ name: "madeonsol_signal_performance", description: "Signal performance stats for a named signal — hit rate, sample size, median outcome, confidence window." },
|
|
1034
1034
|
],
|
|
1035
1035
|
homepage: "https://madeonsol.com/solana-api",
|
|
1036
|
-
repository: "https://github.com/
|
|
1036
|
+
repository: "https://github.com/madeonsol/mcp-server-madeonsol",
|
|
1037
1037
|
}));
|
|
1038
1038
|
return;
|
|
1039
1039
|
}
|
package/glama.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-server-madeonsol",
|
|
3
|
-
"maintainers": ["
|
|
3
|
+
"maintainers": ["madeonsol"],
|
|
4
4
|
"display_name": "MadeOnSol — Solana memecoin intelligence",
|
|
5
5
|
"description": "Real-time Solana memecoin trading intelligence — track 1,000+ KOL wallets with <3s latency, score 15,500+ Pump.fun deployers, surface multi-KOL coordination signals, run server-side copy-trade rules, and stream every DEX trade across 14 programs. Backtested first-touch scout signal (S-tier scouts attract ≥3 follow-on KOLs ~50% of the time vs 14% baseline). Free tier 200 requests per day; auth via msk_ API key or x402 micropayments.",
|
|
6
6
|
"version": "1.16.0",
|
|
7
7
|
"homepage": "https://madeonsol.com/solana-api",
|
|
8
|
-
"repository": "https://github.com/
|
|
8
|
+
"repository": "https://github.com/madeonsol/mcp-server-madeonsol",
|
|
9
9
|
"license": "MIT",
|
|
10
10
|
"categories": ["blockchain", "finance", "web3"],
|
|
11
11
|
"tags": [
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-server-madeonsol",
|
|
3
|
-
"version": "1.16.
|
|
4
|
-
"mcpName": "io.github.
|
|
3
|
+
"version": "1.16.3",
|
|
4
|
+
"mcpName": "io.github.madeonsol/madeonsol",
|
|
5
5
|
"description": "MCP server for MadeOnSol Solana KOL intelligence API — use from Claude, Cursor, or any MCP client",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": {
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
"license": "MIT",
|
|
48
48
|
"repository": {
|
|
49
49
|
"type": "git",
|
|
50
|
-
"url": "https://github.com/
|
|
50
|
+
"url": "https://github.com/madeonsol/mcp-server-madeonsol"
|
|
51
51
|
},
|
|
52
52
|
"dependencies": {
|
|
53
53
|
"@modelcontextprotocol/sdk": "^1.12.1",
|