Madeonsol

mcp-server-madeonsol

Agent Intelligence Gateway (new in 4.1.0, opt-in). Set

MADEONSOL_AGENT_GATEWAY_ENABLED=on together with a paid (PRO or higher)

MADEONSOL_API_KEY to add six research tools fixed to Solana:

discover_opportunities, evaluate_token, inspect_wallet,

inspect_deployer, evaluate_signal and changes_since. They call

POST /api/v1/agent-gateway/actions with your key, count against your

normal quota and never sign or pay an x402 request. Answers carry

per-source evidence and an explicit partial status when a source is

limited. changes_since replays seven curated KOL/deployer event families,

not every swap. Without the opt-in the tool inventory is unchanged.

A hosted endpoint is also available at

https://madeonsol.com/api/agent-gateway/mcp (Streamable HTTP, `Authorization:

Bearer msk_…`); it does not implement MCP OAuth, so OAuth-only connectors

cannot use it. MCP is how an agent invokes tools, not a billing plan. See the

Gateway contract.

The hosted /api/agent-gateway/mcp transport uses per-request account keys and custom Authorization headers. It does not implement MCP OAuth; do not expose this package's private loopback HTTP adapter as a public service.

Six-family early-stream expansion (#457, not activated): the managed earlyStream()

client, private-list controls and token/wallet helpers are implemented in the

madeonsol-x402 TypeScript SDK. This package does not gain that managed client

or new MCP/plugin actions from this PR. Existing sniper compatibility is ULTRA+

and deploy-only. See the release-candidate wire contract

for raw WebSocket integration; publication/version parity remains a release gate.

⚡ [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)

MCP server for MadeOnSol Solana KOL intelligence API. Use from Claude Desktop, Cursor, or any MCP-compatible client.

Real-time Solana trading intelligence: follow the active Solana KOL roster with <3s latency on paid keys and x402 pay-per-call (free-tier live feeds are 5-min delayed), score the reputation-profiled Solana deployer subset, surface deshred deploy signals ~500ms before on-chain confirmation, detect multi-KOL coordination, surface bundle-cohort holdings (which same-slot wallets still hold a token's supply), verify any wallet's CURRENT on-chain holdings straight from its token accounts, and stream trades from supported Solana DEX programs across 9+ programs. Free tier: 200 REST requests/day on eligible endpoints (live feeds 5-min delayed) — no signup payment. Get a key at madeonsol.com/pricing. Metric scopes and current coverage: Solana API · DEX registry · Pricing.

Server update 2026-10-05/08 (no package change needed): realtime developer activity and USDC/USDT trade sizing. The signed webhook event dev:activity (PRO+) and the ULTRA+ DEX-socket dev_subscribe path deliver dev_sell, dev_buy, dev_token_transfer_out and dev_token_transfer_in (a transfer is never a sell). Transfer detection is now the union of the legacy bounded developer-wallet watch and the broad SPL Token/Token-2022 candidate source for attributed creators while live. transfer_watch_coverage describes only the legacy watch; transfer_sources.broad in the subscribe ack reports broad-source state/gaps. Recovered broad-source rows are REST history only, never retroactive realtime alerts. Missing creator attribution, source gaps and unsupported mixed swap + standalone-transfer cases remain limitations. On dex:trades, a swap paid in USDC or USDT now carries sol_amount = the SOL equivalent of its stable leg (used by dust, min_sol, max_sol) plus the additive fields sol_amount_basis (native_sol | stable_quote_equivalent | stable_quote_unconverted) and stable_quote; stable_quote_unconverted means sol_amount 0 (size unknown). Details: changelog.

Server update 2026-10-04 (no package change needed): copy-trade rules follow any valid source wallet. source_wallets no longer have to be tracked KOL wallets: any valid Solana wallet fires, KOL membership is optional enrichment, and copy-trade sources do not use Wallet Tracker quota. Each rule reports source_admission (any_wallet) and operational_state (eligible, or an infrastructure state monitoring_pending / monitoring_unavailable / source_capacity_unavailable). source_wallets_tracked / source_wallets_untracked and the untracked_source_wallets warning are legacy fields, still filled. This supersedes the "signals fire only for tracked KOL wallets" wording in older notes below. Limits are unchanged: PRO 3 rules × 5 wallets, ULTRA 20 × 50, BUSINESS 100 × 250.

Deployer activity timeline (expanded 2026-10-08). madeonsol_deployer_activity binds GET /deployer-hunter/{wallet}/activity (PRO+, keyed msk_ API only): one newest-first timeline containing launches, dev_buy, dev_sell, dev_token_transfer_out, dev_token_transfer_in, creator transfers, fee claims, funding in and capital out. Persisted realtime rows can include below-floor trades; recovered transfer rows can carry recovered, recovered_at, late_classified and counterparty_count. Read the per-family coverage/retention before interpreting an empty range; PRO responses carry no identity block or fee-payer address.

New in 4.2.0: bundles over time, bundled-now share, every KOL trade on a token (108 tools total). Three new tools, keyed msk_ API only (no x402 route). madeonsol_token_bundles (GET /tokens/{mint}/bundles) lists every coordinated buy cluster on a token, the launch bundle AND clusters that form later, each with what it still holds and, for clusters the server follows, its exit progress (exit: sold share, wallets fully out, realized SOL). madeonsol_token_bundle_share (GET /tokens/{mint}/bundle-share) gives one figure, the share of supply held right now by every bundle wallet; it is null with a reason unless every wallet was read, never a guessed number. madeonsol_kol_token_trades (GET /kol/tokens/{mint}/trades) returns every stored tracked-KOL trade on one token, newest first, keyset paged. New opt-ins on existing tools: madeonsol_token_cap_table (limit, verify_current_balances, include_scout_scores), madeonsol_token_buyer_quality and madeonsol_token_bundle (include_balances), madeonsol_token_holders (include_wallet_flags). Additive only.

New in 3.3.0: token lock provenance. Tool descriptions: Token lock rows carry provider (identity verified | compatible | unverified; lock_url always null on Solana, never constructed), explorer (Solana Explorer links), price_usd, seconds_until_end, seconds_until_next_unlock and, for Bonfida, the tranche schedule (server 2026-10-02). Additive only. madeonsol_token_locks_feed accepts cursor (strict keyset paging).

New in 3.2.0: paid tool calls recover a lost answer instead of paying again (PAY-05). In x402 (keyless) mode a paid call whose answer is lost or pending is re-sent with the SAME proof and a payer-signed PAYMENT-RECOVERY header (bounded), and returns the server's stored answer. Tool results carry _x402_payment provenance (payment id, original/deferred, live/stored); a payment that cannot be completed returns a coded x402_payment_error that says not to pay again. A recovery retry never uses the X402_MAX_* budget. Against a server that does not offer recovery (older, or with recovery switched off) the result is the previous behaviour: a re-presented proof ends in the 409 replay_detected and is surfaced, never re-paid. No tool added or removed. API-key users: no change.

New in 3.1.1: tool descriptions match the API. madeonsol_token_risk and madeonsol_tokens_batch_risk describe risk evidence for your own policy, not a verdict. madeonsol_deployer_profile names the real response: is_deployer, the nested deployer object (total_tokens_deployed, total_bonded, ...), pump_stats, pump_tokens, launchpad_tokens; an untracked wallet returns is_deployer: false and deployer: null. No tool added or removed.

New in 3.1.0 — copy-trade and Wallet Tracker tools match the API. madeonsol_copytrade_create / _update accept up to 250 source_wallets (the BUSINESS per-rule limit; before, the tool refused anything over 50 before the server could answer). The server still enforces your own tier's limit (PRO 5, ULTRA 50, BUSINESS 250). Create, update and madeonsol_copytrade_signals gain the market-cap band min_mc_usd / max_mc_usd. The only_action description now states the real default (buy), and the tool descriptions say that signals fire only for tracked KOL wallets. madeonsol_wallet_tracker_trades gains order (slot | block_time) and the before_slot cursor, and its action filter is buy | sell only: transfer_in / transfer_out were always rejected by the API with 400. Use event_type: "transfer" for transfers. madeonsol_copytrade_update documents that a PATCH which sets a webhook_url on a rule without a signing secret returns webhook_secret once, and the copy-trade tools describe the source_wallets_untracked / warnings[] fields newer servers return. madeonsol_test_webhook gains an optional event (which subscribed event to sample).

New in 3.0.0 — BREAKING for x402 (keyless) mode only: five env vars are now required and startup FAILS instead of silently degrading (security fix, SDK-01). Set X402_PAY_TO, X402_FEE_PAYER, X402_MAX_AMOUNT_ATOMIC, X402_MAX_TOTAL_AMOUNT_ATOMIC and SVM_RPC_URL alongside SVM_PRIVATE_KEY. Before, keyless mode signed whatever Solana USDC amount, recipient and fee payer a 402 challenge asked for. Now every challenge is checked BEFORE signing against a trusted merchant payTo, a trusted facilitator feePayer (which must differ from your wallet), the USDC mint, solana:5eykt… mainnet, the exact scheme, a per-call cap and a lifetime cap. Use the canonical values in the keyless section below; caps must be at least 20000 (0.02 USDC) per call to reach every endpoint. The budget is per client instance / process: not wallet-wide, not shared between processes, reset on a new instance or restart. Keyless requires the base URL exactly https://madeonsol.com. API-key (`msk_`) users: no change, no new config. HTTP mode still refuses wallet signers (SEC-02, unchanged).

*