MadeOnSol MCP

mcp-server-madeonsol

⚡ Instale via Smithery · 🤖 Use no Claude Desktop · 🖱️ Use no Cursor · 📚 Documentação da API · 💰 Chave de API gratuita · 🔎 No Glama

Servidor MCP para a API de inteligência de KOLs da MadeOnSol na Solana. Use no Claude Desktop, Cursor ou em qualquer cliente compatível com MCP.

Inteligência de trading em tempo real na Solana: acompanhe mais de 2.000 carteiras de KOLs com latência <3s em chaves pagas e pagamento por chamada via x402 (feeds ao vivo do nível gratuito têm atraso de 5 min), pontue mais de 85 mil deployers do Pump.fun, revele sinais de deploy do deshred ~500ms antes da confirmação on-chain, detecte coordenação entre múltiplos KOLs, revele participações de coortes em bundles (quais carteiras do mesmo slot ainda detêm o supply de um token), verifique as participações on-chain ATUAIS de qualquer carteira diretamente de suas contas de token e transmita cada trade DEX em mais de 9 programas. Nível gratuito: 200 requisições/dia em mais de 40 endpoints (feeds ao vivo com atraso de 5 min) — sem pagamento no cadastro. Obtenha uma chave em madeonsol.com/pricing.

Novo na 3.0.0 — MUDANÇA IMPORTANTE apenas para o modo x402 (sem chave): cinco variáveis de ambiente agora são obrigatórias e a inicialização FALHA em vez de degradar silenciosamente (correção de segurança, SDK-01). Defina X402_PAY_TO, X402_FEE_PAYER, X402_MAX_AMOUNT_ATOMIC, X402_MAX_TOTAL_AMOUNT_ATOMIC e SVM_RPC_URL junto com SVM_PRIVATE_KEY. Antes, o modo sem chave assinava qualquer valor em USDC da Solana, destinatário e pagador de taxa que um desafio 402 pedisse. Agora, todo desafio é verificado ANTES da assinatura contra um merchant payTo confiável, um facilitator feePayer confiável (que deve ser diferente da sua carteira), o mint do USDC, a mainnet solana:5eykt…, o esquema exact, um limite por chamada e um limite vitalício. Use os valores canônicos na seção sem chave abaixo; os limites devem ser de pelo menos 20000 (0,02 USDC) por chamada para alcançar todos os endpoints. O orçamento é por instância/processo do cliente: não é por carteira, não é compartilhado entre processos e é redefinido em uma nova instância ou reinicialização. O modo sem chave exige a URL base exatamente https://madeonsol.com. Usuários de chave de API (msk_): sem mudanças, sem nova configuração. O modo HTTP ainda recusa signers de carteira (SEC-02, inalterado).

Novo na 2.0.0 — MUDANÇA IMPORTANTE: o modo HTTP agora exige um token separado (correção de segurança, SEC-02). Se você executa este servidor com MCP_TRANSPORT=http, agora também precisa definir MCP_HTTP_TOKEN (um segredo aleatório que você gera) e enviá-lo como Authorization: Bearer <token> em cada requisição, incluindo GET /health e o endpoint do server-card — antes, qualquer coisa que alcançasse a porta vinculada podia chamar todas as ferramentas usando a própria chave de API do operador, sem nenhuma autenticação. O modo HTTP agora é estritamente restrito a loopback literal (127.0.0.1 / ::1), rejeita cabeçalhos Origin/X-Forwarded-* e cabeçalhos duplicados Authorization/Host imediatamente, expõe apenas POST /mcp mais as duas rotas GET e se recusa a iniciar se um signer de carteira/pagamento estiver configurado — o modo HTTP nunca pode carregar uma chave de pagador. Se você usa o transporte padrão stdio (Claude Desktop, Cursor, a maioria dos clientes MCP), nada muda — nenhuma ação necessária. Esta é uma correção de token de operador compartilhado único, não um novo sistema multiusuário ou OAuth; cada chamador HTTP ainda compartilha a chave de API MadeOnSol do próprio operador. Documentação completa: docs/audit/SEC02_PRIVATE_HTTP_MCP.md.

Novo na 1.27.1 — o servidor agora reporta instructions do MCP. O campo instructions da resposta initialize (orientação operacional para o agente chamador — distinta desta descrição do README/pacote) nunca foi definido; diretórios que inspecionam o servidor ao vivo (Glama) reportavam "nenhuma instrução MCP registrada." Sem novas ferramentas; ainda 104 no total.

Novo na 1.27.0 — top traders, gerenciamento de watchlist de snipers e duas ferramentas de atualização (104 ferramentas no total). Seis adições encontradas por uma auditoria interna de cobertura de infraestrutura agêntica. madeonsol_token_top_traders (GET /tokens/{mint}/top-traders, PRO/ULTRA) classifica as carteiras de um token por PnL realizado ou ROI, enriquecido com identidade de KOL/carteira alfa — este endpoint já existia na API REST e no trilho x402, mas não tinha ferramenta MCP. madeonsol_sniper_watchlist_list / _add / _remove (PRO+/ULTRA) gerenciam sua watchlist personalizada de deploy de snipers (madeonsol_sniper_recent(watchlist: true) restringe a ela) — antes, só era acessível via HTTP bruto. madeonsol_update_webhook (PATCH) altera a URL, os eventos ou o estado ativo de um webhook sem excluí-lo e recriá-lo. madeonsol_wallet_tracker_relabel (PATCH) renomeia ou limpa o rótulo de uma carteira rastreada.

Novo na 1.26.0 — reputação do deployer em uma data, e recompensas de taxas de criador. Duas novas ferramentas (PRO+, somente API com chave msk_ — sem rota x402). madeonsol_deployer_as_of vincula GET /deployer-hunter/{wallet}/as-of: a reputação do deployer exatamente como estava em date (padrão hoje, UTC) — o snapshot mais recente de escrita-sob-mudança nessa data ou antes dela, para que um agente faça backtest sem viés de look-ahead. snapshot.snapshot_date pode ser anterior a date (escrita-sob-mudança); snapshot.carried: true marca isso. Sem snapshot nessa data ou antes de date → as_of: false, snapshot: null — nada é jamais sintetizado. date deve ser ≥ 2026-04-07 e não no futuro. madeonsol_deployer_rewards vincula GET /deployer-hunter/{wallet}/rewards: recompensas de taxas de criador do pump.fun, respondidas de duas formas que nunca são mescladas — collected (o que realmente chegou à carteira: reivindicações diretas de vault mantidas por 90 dias, reivindicações de handle social, pagamentos a acionistas em qualquer token) e attributed (todo pagamento nos tokens que ele implantou, dividido em to_self/to_others + redirected_pct). Todo campo monetário é {sol, usdc, usd}; usd é null (nunca um 0 silencioso) quando existe um valor em SOL e nenhum preço de SOL estava disponível. top_tokens/top_recipients (≤10, ordenados por USD) mostram para onde foram as taxas atribuídas. Funciona também para não-deployers (is_deployer: false, attributed vazios).

Novo na 1.25.0 — surtos e revivals de tokens: disparos de momentum com a metade honesta anexada. A nova ferramenta madeonsol_tokens_surges vincula GET /tokens/surges (PRO+, somente API com chave msk_ — sem rota x402): cada disparo de momentum de token, do mais recente ao mais antigo. Dois tipos, um formato de linha. surge — um token com menos de 30 min cujo market cap dispara forte contra seu MC de lançamento, em três níveis que cada um dispara no máximo uma vez por mint: early (≤10 min, ≥$12k, ≥3× o lançamento), strong (≤30 min, ≥$30k, ≥6× o lançamento e ≥2× a amostra mais baixa dos últimos 3 min — está subindo agora), breakout (≤2 min, ≥$45k, ≥8×). Um nível deve ser sustentado (tick atual e uma amostra com ≥10 s de idade; nada dispara antes de 20 s de idade) — um bundle do mesmo slot marcado a $475k com 1 s de idade é um pico, não um surto. revival — um token sem candle de trade de 1 minuto por ≥24 h que volta a ser negociado, confirmado apenas pela fita (≥5 compras, ≥$500 de volume de compra, MC ≥1,5× o fechamento pré-dormência), nunca pela marcação de preço; tier é null. Portões rígidos em ambos: liquidez ≥$1,5k e ≥2% do MC, e o MC ganho deve ser pago por volume de compra (uma marcação de preço em pool spoof move o MC com ~$0). Cada linha carrega o burst tape (source candles / wallet_trades; unique_buyers apenas onde o mint está na cobertura de trades — wallet_data_available:false caso contrário, nunca um zero inferido), kol compradores, a coorte dos primeiros 20 early_buyers (bundled / sold / carteiras sniper), reputação deployer e risk_flags[] (bundled_launch, few_buyers, wash_pattern, thin_liquidity, cold_deployer, sniper_heavy, early_buyers_exiting, sell_pressure, no_tape_trades, no_prior_price, mint_authority_active, transfer_fee — vazio significa que nenhuma flag foi levantada, não que foi verificado como limpo). Linhas com ≥65 min de idade carregam o outcome de +1 h; stats=1 imprime taxas de acerto por (tipo, nível) (up_1h_pct, median_peak_multiple, doubled_1h_pct) — fora da amostra por construção. Filtros kind, tier, mint, launchpad, deployer_tier, min_mc_usd / max_mc_usd, min_buys, exclude_flags, only_clean; cursores since / before. Enviado ao vivo no novo canal WS token:surges (eventos token:surge / token:revival; filtros de inscrição kinds[], tiers[], launchpads[], exclude_flags[], min_mc_usd / max_mc_usd, deployer_tier[]) e aceito por madeonsol_create_webhook como eventos token:surge / token:revival com os mesmos filtros. A resposta ecoa os limites ao vivo em definitions.

Novo na 1.24.1 — tokens de stream nunca expiram. madeonsol_stream_token (POST /stream/token) agora retorna o mesmo token em todas as chamadas, para sempre. Ele só para de funcionar se sua assinatura expirar ou se você chamar a ferramenta com rotate: true para substituí-lo (o valor anterior continua funcionando por 60 s). expires_at e o novo next_refresh_at são sempre null (mantidos para compatibilidade de wire — não agende renovações neles); a resposta ganha rotated (booleano) e lifetime (string). O servidor nunca rotaciona por conta própria e nunca envia token_refresh a menos que você tenha rotacionado; um fechamento 4001 significa "gere novamente" (expirou ou rotacionou), nunca um timer. Prefira Authorization: Bearer <token> no handshake do WebSocket — ?token= ainda funciona e é mascarado nos logs de acesso.

Novo na 1.24.0 — locks e vesting de tokens, unlocks futuros e compartilhamento/reivindicações de taxas de criador do pump.fun. Cinco novas ferramentas (todas PRO+, somente API com chave msk_ — sem rota x402). madeonsol_token_locks vincula GET /tokens/{mint}/locks: todo contrato on-chain de lock/vesting em um mint (Streamflow, Jupiter Lock, vesting da Bonfida) com o cronograma, os termos (cancelable_by_sender = o locker pode retirar — os fundos estão bloqueados contra o destinatário, não contra o locker) e uma visão derivada ao vivo (locked_*, claimable_*, next_unlock) além de um summary com totais de unlock futuros de 7d/30d. madeonsol_token_locks_feed (GET /tokens/locks) é o feed entre tokens de NOVOS contratos (cursor pagination.next_since, ou push no canal WS token:locks), madeonsol_token_unlocks (GET /tokens/unlocks) lista os próximos EVENTOS de unlock (cliff / período / final / tranche) em uma janela de 1h–90d ordenados por mais_próximo / maior_usd / maior_pct. Locks de LP não estão incluídos — apenas locks de token/vesting. madeonsol_token_fee_shares (GET /tokens/{mint}/fee-shares) decodifica o SharingConfig on-chain de uma moeda do pump.fun — acionistas com share_bps, is_admin, is_social_pda (taxas destinadas a uma identidade X: social.platform 2 = X, user_id = o id numérico da plataforma, não o handle), redirected_bps, is_default: true = 100% para o criador — além de um resumo de distribuições e histórico de configuração; madeonsol_token_fee_claims (GET /tokens/fee-claims) é o feed de eventos de taxa (distribution com payouts[], social_claim, shares_created/updated/reset, creator_transferred, creator_claim por endereço, apenas quando solicitado via type=), enviado no canal WS token:fee_claims. O histórico de eventos de taxa começa em 2026-08-17. Todos os valores em unidades base são strings de dígitos; ui / usd / pct são null quando decimais ou preço são desconhecidos. Novo na versão 1.23.0 — censo de detentores ao vivo: contagem exata de detentores, detentores rotulados e pools que são nomeados, não apenas excluídos. A nova ferramenta madeonsol_token_holders vincula GET /tokens/{mint}/holders (PRO+): cada conta de token da moeda lida do ledger em confirmed e mesclada por proprietário, então concentration.holder_count é EXATA (proprietários distintos não zero menos pools / curvas de bonding / queimas) — nunca uma estimativa derivada de negociações; ela é null somente quando o provedor recusa o censo para uma mega-cap, caso em que você obtém a visão dos 20 principais e source.census_fallback_reason informa isso. Cada proprietário divulgado carrega nossos rótulos (deployer / kol / early_buyer / bundle / bot / dump_cluster — vazio significa desconhecido para nós, não limpo), e excluded[] NOMEIA o que foi retirado do denominador circulante: reason = pool (com dex + pool_address), bonding_curve (pump.fun / LaunchLab), burn, ou program_account somente quando realmente não conseguimos atribuir o PDA; pool_pct / burned_pct / program_pct dividem a exclusão. Os valores são strings u64 brutas. Divulgação: PRO ranques 1–10, ULTRA 1–50, BUSINESS 1–100 — a matemática é independente do nível. Tokens grandes levam 5–30 s upstream: você recebe 503 holder_scan_in_progress com retry_after_seconds: 20 enquanto a varredura termina no cache, e a nova tentativa é instantânea.

Novo na versão 1.22.0 — dois preços na fita de negociações, e o correto agora é o padrão. A fita de negociações agora informa quanto uma negociação realmente custou. price_sol/price_usd em cada negociação são o preço executado DESTA negociação — sol_amount / token_amount, reconciliando exatamente com os valores na mesma linha e com os pontos finais de PnL. Como sol_amount é o movimento líquido de SOL da carteira, essa é a taxa efetiva completa do trader: taxa de swap e qualquer aluguel de conta incluídos, não o meio do pool. O preço canônico do pool do rastreador de capitalização de mercado mudou para os novos campos market_price_sol/market_price_usd — ele é amostrado uma vez por token por atualização de pool, então cada negociação no mesmo slot o compartilha. Até agora price_sol carregava esse valor canônico e discordava dos valores da própria linha por uma mediana de 7,9% (p90 ~74%): um preço de mercado desatualizado lê baixo em uma bomba e alto em uma queda, então qualquer coisa que você calculou como média da fita herdou o viés em vez de cancelá-lo. Use price_sol para base de custo, execuções e PnL; market_price_sol para uma série por token independente do tamanho e direção da negociação. Tanto madeonsol_token_trades quanto madeonsol_wallet_trades carregam todos os quatro campos, e ambas as descrições de ferramentas explicam qual preço usar para que um agente não calcule a média do errado.

Novo na versão 1.21.0 — superfície do Deployer Hunter concluída. Sete novas operações que existiam na API, mas não tinham vinculação SDK: madeonsol_deployer_leaderboard, madeonsol_deployer_stats, madeonsol_deployer_profile, madeonsol_deployer_tokens, madeonsol_deployer_alert_stats, madeonsol_deployer_best_tokens e madeonsol_deployer_recent_bonds. Leia bonding_rate (vitalício) contra recent_bond_rate (contínuo) — a lacuna entre eles é o sinal, não qualquer número isoladamente. runner_rate só significa algo uma vez que labeled_tokens >= 3, e uma carteira não rastreada retorna um perfil com contadores zerados, não um 404, então verifique total_deployed antes de ler uma taxa de vínculo de 0% como um histórico. Os intervalos de dependência agora são limitados às versões realmente testadas (@x402/* ^2.x, @solana/kit ^5.5.1) em vez de >=0.0.1 abertos, e os pares x402 importados lentamente são marcados como opcionais — uma instalação com chave não puxa mais toda a pilha Solana. Novo na 1.20.0 — Profundidade de token / impacto de preço + auto-atividade do deployer no risco. Nova ferramenta madeonsol_token_depth (GET /tokens/{mint}/depth) — impacto de preço / slippage por pool: "quanto SOL move o preço deste token em N%", por pool (NÃO rota-ótima). Passe até 8 compras de SOL sizes (cada >0 e ≤10000; padrão [0.5, 1, 5, 10]); cada pool computável retorna spot_price_sol, fee_pct, uma entrada quotes[] por tamanho (size_sol, tokens_out, avg_price_sol, price_impact_pct) e to_move_price — o SOL necessário para mover o preço 1% / 5% / 10%. AMMs de produto constante são servidos a partir de reservas de stream (source: "stream" com reserves_age_ms); curvas de bonding pump.fun/bonk a partir de uma leitura ao vivo das reservas virtuais da curva (source: "live_rpc"). Pools que não podem ser precificados honestamente — CLMM/Orca/DLMM concentrados, curvas Meteora-DBC, modelos não classificados — voltam em unsupported_pools[] com um reason (ex.: concentrated_liquidity_depth_not_supported, curve_graduated_use_amm_pool) em vez de um número errado; primary_pool nomeia o pool computável mais profundo, found: false significa que nenhum pool é rastreado. Somente PRO/ULTRA. E madeonsol_token_risk agora retorna um bloco dev de nível superior (auto-atividade do deployer; null quando o mint não tem linha no pipeline do deployer): o snapshot de auto-compra da tx de criação (buy_sol, buy_tokens, buy_supply_pct), o rollup pós-criação (bought_tokens_after — captura a compra do dev em tx separada no mesmo segundo que o snapshot de criação lê como 0 — sold_tokens, sold_sol, first_sell_at/last_sell_at), holdings on-chain ao vivo (holdings_tokens, holdings_supply_pct — denominador 1B da pump.fun, nulo em outros lugares — wallet_empty: a carteira do dev está vazia AGORA) e transferred_out (tokens restantes sem venda; null = desconhecido, nunca um palpite), além de as_of. Payloads de webhook/WS deployer:alert ganham dev_buy_sol + dev_buy_supply_pct.

Novo na 1.19.0 — Classificação de carteiras em lote + fita de negociação de token + catálogo keyless maior. Nova ferramenta madeonsol_wallet_batch_classify — flags de reputação para 1–100 carteiras em uma chamada (conta como uma solicitação): por carteira is_sniper / is_bundler / is_dumper / is_kol (+ kol_name), bot_confidence (enum de string none/low/medium/high, null quando não rastreado por alpha) e um bloco dump_cluster (dump_cohorts, runner_cohorts, total_cohorts, as_of). As flags são escopadas ao pipeline da pump.fun — false = não observado, NÃO verificado como limpo; is_bundler é vitalício, is_dumper é uma janela móvel de 42 dias. Nova ferramenta madeonsol_token_trades — fita de negociação paginada por cursor e escopada por mint (o complemento de backfill ao firehose ao vivo): tx_signature, wallet_address, action, sol_amount, token_amount, price_sol/price_usd, early_buyer_rank, slot, block_time, traded_at; filtros action / wallet / since–until (padrão histórico COMPLETO — captura começa em 2026-04-12), além de um bloco de honestidade coverage. Ambos PRO/ULTRA. Flags madeonsol_wallet_stats ganham is_sniper/is_bundler/is_dumper + dump_cluster, e bot_confidence agora é corretamente tipado como enum de string (foi documentado como número e sempre retornava null devido a um bug no servidor — agora retorna valores reais). Entradas madeonsol_token_risk e deploys madeonsol_sniper_recent ganham o rollup de janela de slot sniper_footprint/footprint (buys, buyers, sol, supply_pct, sniper_wallet_buys, data_available, as_of — null = não observável, não zero). O catálogo keyless x402 cresce de 18 → 25 endpoints: candles de token ($0.01), quase-bonded ($0.01), top-traders ($0.02), cap-table ($0.02), sniper recente ($0.01), fluxo de token ($0.01), trajetória do deployer ($0.01) — madeonsol_sniper_recent e madeonsol_deployer_trajectory agora funcionam sem chave via x402 também.

Novo na 1.18.0 — Holdings de carteira verificados on-chain. Nova ferramenta madeonsol_wallet_holdings — as holdings ATUAIS da carteira lidas direto da chain: suas contas de token SPL + Token-2022 reais e saldo SOL, cada uma enriquecida com nossos price_usd / value_usd / market_cap_usd / name / symbol / is_bonded, além de transfer_delta (quantia on-chain − posição líquida derivada de negociações — expõe fluxos não-swap como airdrops, financiamento de insiders e troca de carteiras). Distinto de madeonsol_wallet_positions (FIFO derivado de negociações): isto é o que a carteira realmente detém agora. Params: limit (1–500, padrão 200), min_value_usd (padrão 0). Retorna { address, sol_balance, holdings[], summary, verified_at, trade_window_days, cache_hit, ttl_seconds }. Somente ULTRA.

Novo na 1.17.0 — Holdings de coorte de bundle. Nova ferramenta madeonsol_token_bundle — quais carteiras "bundle" do mesmo slot compraram um token e quanto do supply elas ainda detêm (o sinal de rug/insider "percentual atual detido" dos incumbentes, a partir de dados on-chain confirmados). Retorna um bloco bundle (wallet_count, bundle_kind atomic_tx/same_slot/none, held_ratio, held_pct_of_supply — o destaque, líquido detido / supply circulante, nulo se desconhecido — fully_exited, buy_volume, tokens_held) além de um array wallets[] (rank, wallet, held_ratio, has_sold, atomic, is_kol). BASIC obtêm apenas o bloco de bundle (wallets[] vazio); PRO adiciona carteiras top-10 apenas com flags; ULTRA retorna a coorte completa com identidades enriquecidas (kol_name, win_rate, bot_confidence, tokens_held).

Novo na 1.16.0 — Pontuação de risco em lote + controle de sessão de stream ao vivo. Nova ferramenta madeonsol_tokens_batch_risk — pontuação de risco de rug/segurança em massa para até 50 mints em uma chamada, retornando o mesmo formato por mint que madeonsol_token_risk (pontuação 0–100, band, factors[] explicável, inputs bruto) além de um timestamp as_of; mints não rastreados retornam como { mint, error: "not_tracked" } sem falhar o lote, e a chamada inteira conta como uma solicitação contra a cota. Além disso, duas ferramentas de sessão WebSocket: madeonsol_stream_sessions_list (liste suas sessões ao vivo — id, service, tier, channels, connected_at, remote_ip, messages_sent) e madeonsol_stream_session_kill (force desconexão de uma sessão por id para liberar seu slot de conexão, ex.: um socket fantasma). Somente PRO/ULTRA.

Novo na 1.15.0 — Descoberta de quase-bonded + ordenações de tendência. Nova ferramenta madeonsol_almost_bonded — tokens pump.fun pré-bond perto da graduação, ranqueados por velocidade (Δprogresso/min): "95% e acelerando" vence "92% parado". Cada token carrega progress_pct, velocity_pct_per_min, eta_minutes, stalled, real_sol_reserves, market_cap_usd, liquidity_usd, authorities_revoked, deployer_tier e 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. Somente PRO/ULTRA. Além disso, madeonsol_tokens_list ganha quatro ordenações de momentum — mc_change_5m_desc, mc_change_1h_desc, volume_1h_desc e trending (rank composto de volume recente × momentum positivo).

Novo na 1.14.0 — Fluxo de negociação de token. Nova ferramenta madeonsol_token_flow — um agregado de fluxo de negociação (volume orgânico-vs-falso) em uma janela 1h/24h: unique_wallets / unique_buyers / unique_sellers, buy_count / sell_count / total_trades, buy_sol / sell_sol / net_sol (venda − compra; positivo = SOL líquido saindo do pool) e trades_per_wallet (proxy de wash-trading). Somente PRO/ULTRA. Alertas de deployer (madeonsol_deployer_alerts) agora carregam deployers.deployer_sol_balance — o saldo SOL da carteira do deployer no momento do alerta (nulo para linhas históricas).

Novo na 1.13.0 — Candles OHLCV de token. Nova ferramenta madeonsol_token_candles — candles históricos de preço (1m/5m/15m/1h/4h/1d) agregados do firehose de negociações on-chain. Cada candle tem t/open/high/low/close/volume_usd/trades/market_cap_usd. PRO retorna OHLCV dos últimos 30 dias; ULTRA adiciona splits de volume de compra/venda + contagem, fluxo líquido, volume MEV, liquidez de abertura/fechamento, MC alto/baixo e histórico completo. Somente PRO/ULTRA.

Novo na 1.12.0 — Pontuação de risco de token. Nova ferramenta madeonsol_token_risk — uma pontuação transparente de risco de rug/segurança de 0–100 (maior = mais arriscado) com um band (safe/caution/danger), um array factors[] explicável e o inputs bruto (autoridade de mint/congelamento, liquidez, razão liq-para-MC, taxa de transferência, coorte de lançamento, taxa de bond do deployer, sinal KOL, blacklist). Somente PRO/ULTRA.

Novo na 1.11.0 — madeonsol_tokens_list ganha três novos params de filtro: min_liq_mc_ratio, max_liq_mc_ratio e deployer_tier. Itens de resposta agora incluem liquidity_to_mc_ratio e deployer_tier. Nova ferramenta: madeonsol_signal_performance — avalie a eficácia do sinal (taxa de acerto, tamanho da amostra, resultado mediano) antes de agir em qualquer sinal. Entradas do leaderboard KOL agora incluem median_hold_minutes_30d e percentile_early_entry_30d.

Novo na 1.10.4 — Alertas/perfis de deployer agora expõem runner_rate + labeled_tokens (fração dos tokens rotulados de um deployer que rodaram vs caíram, gate em labeled_tokens ≥3) além de avg_time_to_bond_minutes.

Novo na 1.10.3 — Detecção de cluster de dump. O detalhamento madeonsol_token_buyer_quality agora inclui dump_cluster_count (3+ carteiras de cluster de dump nos primeiros-20 → taxa histórica de dump de 94% vs base de 61%) e recycled_early_buyer_count. O detalhamento completo é retornado em todos os tiers. Também: a API agora empurra cada graduação da pump.fun em tempo real (canal WS token:graduations).

Novo na 1.10 — Alertas de Sniper Deshred. madeonsol_sniper_recent superfície deploys da pump.fun a partir de dados de nível shred ~500ms antes da confirmação on-chain. PRO: deployers elite/bons. ULTRA: todos os tiers + watchlist personalizada. Use WebSocket sniper:deploys ou webhook sniper:deploy para push ao vivo.

Novo na 1.9 — Alertas de preço, leaderboard de scout, histórico de coordenação. CRUD madeonsol_price_alerts_* (PRO=5, ULTRA=25). madeonsol_scout_leaderboard ranqueia os melhores scouts por taxa de follow-on de primeiro toque. madeonsol_coordination_history e madeonsol_peak_history expõem o registro histórico. madeonsol_wallet_stats agora retorna derived: win_rate, roi, verdict, biggest_miss.

Novo na 1.8 — API Universal de Carteira. madeonsol_wallet_stats, madeonsol_wallet_pnl, madeonsol_wallet_positions, madeonsol_wallet_trades — PnL de base de custo FIFO e negociações brutas paginadas por cursor para qualquer carteira Solana. PRO+. Acertos de cache não contam contra a cota.

Novo na 1.7.0 (2026-05-12) — Duas novas ferramentas: madeonsol_me (introspecção de conta/cota — leia tier, solicitações restantes e uso por recurso sem analisar cabeçalhos de rate-limit) e madeonsol_tokens_list (diretório de token filtrado e ordenável PRO+ — faixa de MC, piso de liquidez, DEX primária, flags de autoridade/segurança, além de deltas computados de volume 1h / participação-MEV / mudança-MC). Respostas de token agora expõem campos velocity / participação-MEV. O diretório de token padrão é min_liq=2000 para pular poeira de MC fantasma — passe min_liq=0 para optar por sair. /token/{mint} agora retorna erros 400 estruturados (code / reason / example / docs) em vez de strings simples. Campo obsoleto avg_entry_mc_usd totalmente removido dos leaderboards KOL/alpha.

Instalar via Smithery (uma linha)

Smithery é o caminho mais fácil — ele escreve a configuração para você e cuida da instalação:

npx -y smithery mcp add madeonsol/solana-kol-intelligence

O Smithery solicita seu MADEONSOL_API_KEY (grátis em madeonsol.com/pricing) e configura o Claude Desktop ou seu cliente MCP escolhido. Reinicie o cliente e pergunte: "O que os KOLs estão comprando agora?"

Você também pode navegar pelas ferramentas pela CLI:

npx -y smithery tool get madeonsol/solana-kol-intelligence madeonsol_kol_feed

Início rápido — configuração manual (10 segundos)

npm install -g mcp-server-madeonsol

Adicione ao claude_desktop_config.json ou às configurações MCP do Cursor (tier grátis em https://madeonsol.com/pricing):

{ "mcpServers": { "madeonsol": { "command": "mcp-server-madeonsol", "env": { "MADEONSOL_API_KEY": "msk_..." } } } }

Reinicie o Claude Desktop e pergunte: "O que os KOLs estão comprando agora?"

Início rápido para agentes de IA (x402 / pagamento por chamada)

Construindo um agente autônomo? Pule o cadastro. Configure uma carteira Solana financiada e um orçamento de pagamento explícito. Chamadas de ferramentas pagas autorizam micropagamentos dentro desse orçamento via x402 — sem chave de API, sem conta, sem burocracia de limite de taxa.

{
  "mcpServers": {
    "madeonsol": {
      "command": "mcp-server-madeonsol",
      "env": {
        "SVM_PRIVATE_KEY": "<base58 solana private key>",
        "X402_PAY_TO": "GLu63pRCYrp4BJu5P5ciYKxgeZFW9c8TJ8jWzK3TB9AR",
        "X402_FEE_PAYER": "2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4",
        "X402_MAX_AMOUNT_ATOMIC": "20000",
        "X402_MAX_TOTAL_AMOUNT_ATOMIC": "1000000",
        "SVM_RPC_URL": "https://<your-trusted-solana-rpc>"
      }
    }
  }
}

Como funciona:

• A carteira por trás do SVM_PRIVATE_KEY liquida cada requisição como um micropagamento USDC na Solana (~$0,005–$0,02 por chamada, liquidado on-chain). Sem assinatura; o orçamento de autorização configurado limita os gastos.

• O catálogo sem chave cobre 25 endpoints — as adições mais recentes: candles de token ($0,01), quase-bonded ($0,01), top-traders ($0,02), cap-table ($0,02), deploys recentes do sniper ($0,01), fluxo de token ($0,01) e trajetória do deployer ($0,01).

• A ferramenta gratuita madeonsol_discovery não requer autenticação e retorna cada endpoint com seu preço exato por chamada — chame-a primeiro para ver quanto custa cada ferramenta.

• Instale as dependências de pares x402 junto com o servidor (necessário apenas neste modo):

  npm install -g mcp-server-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
  

Somente dados. O MadeOnSol retorna inteligência de negociação — ele nunca negocia, assina swaps ou assume custódia de fundos. A única coisa que sua carteira paga é a taxa de dados por chamada.

Prefere uma fatura mensal fixa, camada gratuita ou nenhuma carteira? Use o caminho do desenvolvedor abaixo.

Política de pagamento obrigatória (atualização sem chave que quebra compatibilidade)

Pagamentos Solana sem chave exigem um merchant confiável explícito, facilitador e orçamento de autorização. O modo com chave de API permanece inalterado e tem precedência sobre uma carteira configurada.

Apenas pagamentos exatos em USDC da mainnet são permitidos. Defina os dois endereços a partir da sua configuração de operador confiável, independentemente de um desafio do servidor. SVM_RPC_URL deve ser seu RPC HTTPS confiável; não há fallback de RPC público. A carteira do agente não pode ser também a pagadora de taxas do facilitador.

Configuração	Significado
X402_PAY_TO	Carteira merchant confiável que recebe USDC
X402_FEE_PAYER	Carteira facilitadora confiável que paga taxas de transação
X402_MAX_AMOUNT_ATOMIC	Máximo por pagamento, como string de inteiro positivo
X402_MAX_TOTAL_AMOUNT_ATOMIC	Limite de autorização vitalício, como string de inteiro positivo
SVM_RPC_URL	URL RPC HTTPS Solana confiável explícita

USDC usa 6 casas decimais: 20000 = 0,02 USDC e 1000000 = 1 USDC. Escolha limites que cubram os endpoints que você pretende usar; estes exemplos não são uma garantia de preço.

Valores canônicos do MadeOnSol (USDC mainnet Solana). Fixados aqui (GitHub + README do npm) para que você não precise obtê-los de um 402:

• merchant payTo / X402_PAY_TO: GLu63pRCYrp4BJu5P5ciYKxgeZFW9c8TJ8jWzK3TB9AR (também exibido em https://madeonsol.com/x402 e https://madeonsol.com/.well-known/x402)
• facilitador feePayer / X402_FEE_PAYER: 2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4. Este é o pagador de taxas do PayAI, o facilitador terceirizado que o trilho Solana do MadeOnSol usa. Se o PayAI o rotacionar, chamadas sem chave falham de forma segura (o cliente se recusa a assinar) até que você atualize este valor; um lançamento do MadeOnSol anunciará o novo.
• preços: pernas Solana são 5000–20000 atômicos (0,005–0,02 USDC), então maxAmountAtomic / X402_MAX_AMOUNT_ATOMIC devem ser pelo menos 20000 para alcançar todos os endpoints.

O orçamento é por instância de cliente / processo: não é por carteira, não é compartilhado entre processos, é redefinido quando uma nova instância ou processo inicia. O modo sem chave exige a URL base exatamente https://madeonsol.com.

O limite é reservado antes que chamadas concorrentes possam aprovar/assinar. Uma negação não assinada o libera; entrar na criação de pagamento o retém mesmo se RPC, assinatura ou a resposta paga falharem. Ele mede tentativas autorizadas, não gastos liquidados. Não há reembolso automático ou replay de pagamento. Um timeout não pode desfazer uma prova já enviada.

O limite é por processo do servidor; reiniciar inicia um novo limite. Reutilize o processo em execução. Vários servidores MCP ou outros clientes compartilhando uma carteira precisam de um orçamento compartilhado externo. Configurações sem chave ausentes/inválidas interrompem a inicialização; a assinatura da carteira permanece restrita ao stdio. O timeout de tentativa de pagamento é de 30 segundos por padrão.

Autenticação

Duas opções (em ordem de prioridade):

Método	Variável de ambiente	Melhor para
Chave de API MadeOnSol (recomendado)	MADEONSOL_API_KEY	Desenvolvedores — obtenha uma chave gratuita
Micropagamentos x402	SVM_PRIVATE_KEY	Agentes de IA com carteiras Solana

Mudança que quebra compatibilidade na v1.0: A autenticação RapidAPI (RAPIDAPI_KEY) foi removida. O marketplace RapidAPI do MadeOnSol foi aposentado em 2026-04-19. Obtenha uma chave msk_ gratuita em madeonsol.com/pricing.

Instalação

npm install -g mcp-server-madeonsol

As dependências de pares x402 (@x402/fetch @x402/svm @x402/core @solana/kit @scure/base) são necessárias apenas ao usar SVM_PRIVATE_KEY.

Configuração

Claude Desktop

Adicione a claude_desktop_config.json:

{
  "mcpServers": {
    "madeonsol": {
      "command": "mcp-server-madeonsol",
      "env": {
        "MADEONSOL_API_KEY": "msk_your_api_key_here"
      }
    }
  }
}

Cursor

Adicione às configurações do MCP o mesmo comando e variáveis de ambiente.

Transporte HTTP privado (SEC-02)

Stdio permanece o padrão para Claude Desktop, Cursor e outros clientes MCP locais. HTTP agora exige uma configuração explícita de operador privado; configurações de inicialização HTTP anteriormente não autenticadas falharão de forma segura.

1. Defina MADEONSOL_API_KEY como a chave msk_ do operador.
2. Gere um token de acesso aleatório separado, por exemplo node -e "console.log(require('node:crypto').randomBytes(32).toString('base64url'))", e armazene-o como MCP_HTTP_TOKEN. Não reutilize a chave de API upstream nem coloque qualquer credencial em uma URL.
3. Defina MCP_TRANSPORT=http, HOST=127.0.0.1 (padrão, ou ::1) e opcionalmente PORT (padrão 3100). Bindings não-loopback, credenciais ausentes e qualquer SVM_PRIVATE_KEY ou RHC_PAYER_KEY são recusados antes da inicialização. O modo carteira Solana/x402 permanece disponível via stdio.
4. Conecte-se a http://127.0.0.1:3100/mcp com Authorization: Bearer <MCP_HTTP_TOKEN> em cada requisição, além dos cabeçalhos normais de MCP Content-Type e Accept. Use stdio se o cliente não puder anexar cabeçalhos. O token local é verificado pelo adaptador MCP; apenas MADEONSOL_API_KEY é enviado upstream.

Apenas POST /mcp, GET /health e GET /.well-known/mcp/server-card.json são expostos, todos autenticados. / e caminhos arbitrários não são mais endpoints MCP. O adaptador é stateless: ele não emite IDs de sessão, rejeita Mcp-Session-Id fornecidos e retorna 405 para GET/DELETE em /mcp. O host deve ser o literal loopback selecionado com sua porta, ou localhost com essa porta exata. Cabeçalhos Origin de navegador, cabeçalhos de proxy encaminhados e requisições cross-origin são rejeitados; nenhum acesso CORS é concedido.

Limites: corpos JSON não compactados de 256 KiB, cabeçalhos de 8 KiB, prazo de upload de corpo de 10 segundos e 16 requisições autenticadas ativas. Entradas superdimensionadas ou malformadas são rejeitadas antes do despacho da ferramenta. Este não é um prazo geral de execução de ferramenta; uma ação upstream já enviada pode continuar após uma desconexão.

Todos que possuem o token local agem como o mesmo operador, incluindo acesso às ferramentas de mutação desse operador. Este não é um servidor multi-usuário/OAuth: não o coloque atrás de um proxy público, não o compartilhe com usuários não confiáveis nem exponha um signatário financiado. Usuários separados exigem processos/credenciais isolados ou um transporte futuro que autentique cada principal e mapeie suas próprias credenciais. Reinicie com um novo MCP_HTTP_TOKEN para rotacionar o acesso.

A imagem Docker usa a mesma restrição de loopback e exige ambas as credenciais de ambiente. Seu healthcheck autentica sem colocar o token na URL. Ela não suporta uma porta Docker publicada publicamente; use stdio ou um cliente no mesmo namespace de rede confiável.

Ferramentas

Inteligência KOL

Ferramenta	Descrição
madeonsol_kol_feed	Feed de negociações KOL em tempo real (1.000+ carteiras)
madeonsol_kol_coordination	Sinais de convergência multi-KOL (v1.1) — janela de pico de densidade, detecção de saída, pontuação 0-100
madeonsol_kol_first_touches	Eventos de primeiro-toque KOL — sinal de scout com backtest. Filtre por nível de scout, taxa de vitória, idade do token, sufixo da mint
madeonsol_kol_leaderboard	Rankings de PnL e taxa de vitória de KOLs (180 dias de histórico; períodos: hoje, 7d, 30d, 90d, 180d)
madeonsol_kol_pairs	Matriz de afinidade KOL — quais KOLs negociam os mesmos tokens em conjunto
madeonsol_kol_hot_tokens	Tokens de momentum KOL — interesse de compra acelerado
madeonsol_kol_trending_tokens	Tokens classificados por volume de compra de KOLs (janelas de 5m–12h). ULTRA adiciona endereços completos de carteiras KOL.
madeonsol_kol_pnl	PnL profundo por carteira: curva de equity, métricas de risco, posições fechadas. ULTRA adiciona posições abertas (tokens comprados mas ainda não vendidos).
madeonsol_kol_timing	Perfil de timing de entrada/saída KOL — disponível em todos os níveis

Deployer Hunter

Ferramenta	Descrição
madeonsol_deployer_alerts	Lançamentos de deployers Pump.fun com enriquecimento KOL. Filtre por nível (elite/bom/moderado/emergente/frio). ULTRA desbloqueia paginação completa. O deployers de cada alerta agora inclui deployer_sol_balance — o saldo SOL da carteira do deployer no momento do alerta (null para linhas históricas).
madeonsol_deployer_trajectory	Curva de habilidade do deployer — sequências, taxa de bond rolante, tendência — disponível em todos os níveis
madeonsol_deployer_history	Série temporal diária de reputação de um deployer pump.fun (bonding_rate, recent_bond_rate, tier, avg_peak_mc por dia) — faça backtest de sinais de deployer no momento do lançamento sem viés de look-ahead. limit 1–365 (padrão 90)

Alertas Deshred Sniper (novo na 1.10 — Pro/Ultra)

Feed de deploys pump.fun pré-confirmados reconstruído a partir de dados em nível de shred (deshred) — lançamentos aparecem ~500ms antes de confirmarem on-chain. Pro vê deployers elite/bons; Ultra vê todos os níveis.

Ferramenta	Descrição
madeonsol_sniper_recent	Feed de deploys deshred do mais recente primeiro. Pro: elite/bom · Ultra: todos os níveis · x402 sem chave: $0,01 (elite/bom). watchlist: true (Ultra) restringe à sua watchlist personalizada de deployers. Novo 1.19: cada deploy carrega footprint — o resumo de snipe por janela de slot (buys, buyers, sol, supply_pct, sniper_wallet_buys, data_available, as_of) ou null quando ainda não liquidado/observável
madeonsol_sniper_by_deployer	Deploys deshred para uma única carteira de deployer (Ultra)

Rastreador de Carteiras

Ferramenta	Descrição
madeonsol_wallet_tracker_watchlist	Liste suas carteiras rastreadas e capacidade restante (Free: 10, Pro: 50, Ultra: 100)
madeonsol_wallet_tracker_add	Adicione uma carteira à sua watchlist
madeonsol_wallet_tracker_remove	Remova uma carteira da sua watchlist
madeonsol_wallet_tracker_trades	Eventos históricos de swap/transferência para carteiras observadas (retenção de 120 dias)
madeonsol_wallet_tracker_summary	Estatísticas por carteira: contagens de swap, SOL comprado/vendido, último evento

Carteira Universal (novo na 1.8 — qualquer carteira, não apenas KOLs selecionados, PRO+)

Ferramenta	Descrição
madeonsol_wallet_stats	Estatísticas agregadas de 90d + flags entre produtos (is_kol, is_alpha_tracked + bot_confidence none/low/medium/high, is_deployer + tokens_deployed, novo 1.19: is_sniper / is_bundler / is_dumper + coortes dump_cluster) — avaliação rápida de uma carteira desconhecida
madeonsol_wallet_batch_classify	Novo 1.19 · Flags de reputação em lote para 1–100 carteiras em uma chamada — is_sniper/is_bundler/is_dumper/is_kol + kol_name, bot_confidence, dump_cluster. Escopo do pipeline Pump.fun: false = não observado, não verificado como limpo
madeonsol_wallet_pnl	PnL completo com base de custo FIFO: SOL realizado + não realizado, fator de lucro, drawdown máximo, minutos de manutenção médios + medianos, curva de PnL UTC diária, posições fechadas + abertas hidratadas com preços ao vivo do mc-tracker
madeonsol_wallet_positions	Apenas posições abertas — fatia mais leve do /pnl. Compartilha o mesmo cache.
madeonsol_wallet_holdings	Novo 1.18 · Holdings on-chain atuais VERIFICADAS (contas SPL reais + Token-2022 + SOL) enriquecidas com preço/MC/nome, além de transfer_delta vs posição derivada de negociações. Apenas ULTRA.
madeonsol_wallet_trades	Negociações brutas paginadas por cursor com filtros de ação / token / desde-até

Cacheado no servidor com TTL dinâmico (5min / 1h / 24h com base na última atividade). Base de custo observável apenas dentro da janela de 90 dias.

Inteligência de Carteira Alpha

Pontuado a partir de mais de 1,5 milhão de registros de compradores iniciais (carteiras vistas entre os 20 primeiros compradores de tokens Pump.fun).

Ferramenta	Nível	Descrição
madeonsol_alpha_leaderboard	Todos	Carteiras de compradores iniciais mais lucrativas. Até 100 no Free/Pro; ULTRA desbloqueia 500 + sinais de bot
madeonsol_alpha_wallet	ULTRA	Detalhamento completo por token + array bot_signals
madeonsol_alpha_linked	ULTRA	Carteiras vinculadas comportamentalmente (co-compra de 3+ tokens em até 2s)

Qualidade do Token

Ferramenta	Nível	Descrição
madeonsol_tokens_list	PRO+	Diretório de tokens filtrado e ordenável — faixa de MC, piso de liquidez, DEX primária, flags de autoridade/segurança, deltas calculados de volume 1h / participação MEV / variação de MC, além de ordenações por momentum (mc_change_5m_desc, mc_change_1h_desc, volume_1h_desc, trending). O padrão min_liq=2000 ignora poeira de MC fantasma.
madeonsol_almost_bonded	PRO+	Tokens pump.fun pré-bond próximos da graduação, ranqueados por velocidade (Δprogresso/min) — progress_pct, velocity_pct_per_min, eta_minutes, stalled, deployer_tier, age_minutes
madeonsol_token_cap_table	PRO+	Primeiros compradores que não são o deployer, enriquecidos com flags de PnL/KOL/bot. PRO=10, ULTRA=20
madeonsol_token_buyer_quality	Todos	Pontuação de qualidade do comprador de 0 a 100 + detalhamento completo (cache de 5 min)
madeonsol_token_risk	PRO+	Pontuação transparente de risco de rug/segurança de 0 a 100 com band, factors[] explicável e inputs bruto (novo 1.19: inputs.sniper_footprint — resumo de snipe por janela de slot, null = não observável; novo 1.20: bloco dev de nível superior — auto-compra do deployer na criação, resumo de vendas, participações on-chain em tempo real, wallet_empty, transferred_out)
madeonsol_token_bundle	Todos	Participações do coorte de bundle — quais carteiras de bundle do mesmo slot compraram um token e quanto do supply ainda detêm (manchete held_pct_of_supply, além de bundle_kind, held_ratio, fully_exited). BASIC: apenas bloco de bundle. PRO: flags top-10. ULTRA: coorte completo + identidades
madeonsol_token_pools	PRO+	Mapa de liquidez por venue — cada pool DEX em que um token negocia (pump.fun/PumpSwap/Raydium/Meteora/Orca) com liquidity_usd por pool, is_active (ativo vs estacionado), além de um summary (contagens de pool/DEX, total_liquidity_usd, primary_pool, concentração top_pool_share_pct)
madeonsol_token_depth	Novo 1.20 · PRO+	Impacto de preço / slippage por pool — quotes[] por tamanho de compra em SOL (tokens_out, avg_price_sol, price_impact_pct) + to_move_price (SOL para mover o preço 1%/5%/10%). sizes máx. 8, padrão [0.5, 1, 5, 10]; pools não suportados (CLMM/DLMM/DBC) sinalizados com um reason
madeonsol_token_holders	Novo · PRO+	Censo de detentores em tempo real + concentração — quem detém AGORA (vs madeonsol_token_cap_table = quem comprou primeiro). concentration.holder_count é EXATO (censo getProgramAccounts com escopo de mint mesclado por proprietário; null somente quando o provedor recusa um mega-cap → fallback top-20 com source.census_fallback_reason, nunca estimado por negociação). Cada proprietário divulgado rotulado deployer / kol / early_buyer / bundle / bot / dump_cluster (vazio = desconhecido, não limpo). Pools / curvas de bonding / burns EXCLUÍDOS do denominador circulante e NOMEADOS em excluded[] (reason: pool + dex + pool_address, bonding_curve, burn, program_account); amount_raw é uma STRING u64 bruta. Divulgação PRO 10 / ULTRA 50 / BUSINESS 100. Tokens grandes: a primeira chamada pode retornar HTTP 503 holder_scan_in_progress (retry_after_seconds: 20) — a varredura continua + cache, a nova tentativa é instantânea
madeonsol_token_locks	Novo 1.24 · PRO+	Locks e vesting de tokens em um mint — cada contrato Streamflow / Jupiter Lock / Bonfida: program, kind (lock / vesting), status derivado, remetente / destinatário, cronograma (start_at / cliff_at / end_at, period_seconds), termos (cancelable_by_sender — o locker pode retirar), locked_* / claimable_* / next_unlock em tempo real, além de summary (totais bloqueados / depositados, unlocking_7d_* / unlocking_30d_*, next_unlock mais próximo, active_cancelable_by_sender). Filtros status, program, limit ≤500. Valores em unidades base são STRINGS; ui/usd/pct null quando desconhecidos. Locks de LP não incluídos
madeonsol_token_locks_feed	Novo 1.24 · PRO+	Feed entre tokens de NOVOS contratos de lock / vesting, mais recentes primeiro — mesma forma de linha + token {symbol, price_usd, market_cap_usd}. Cursores since / before (pagination.next_since / next_before); filtros mint, sender, recipient, program, kind, status, min_usd, min_pct_of_supply, include_estimated (linhas Jupiter retroalimentadas). Push: canal WS token:locks (evento token:lock)
madeonsol_token_unlocks	Novo 1.24 · PRO+	Próximos EVENTOS de unlock em todos os contratos ativos dentro de within = 1h–90d — uma entrada por contrato = seu próximo event (cliff / período / final / tranche) com amount_* + window_amount_* (liberação total no período), token, lock. sort mais próximo / maior_usd / maior_pct; filtros mint, program, kind, min_usd, min_pct_of_supply; limit ≤200, offset
madeonsol_token_fee_shares	Novo 1.24 · PRO+	SharingConfig de taxa do criador pump.fun em uma moeda — shareholders[] (share_bps, is_admin, is_social_pda + social {platform (2 = X), user_id, lifetime_claimed}, received_*), redirected_bps, social_bps, is_default (100% para o criador), stream source / chain; resumo distributions (destinatários, destinatários_anteriores), history[], recent_distributions[]. Valores em unidades base de cotação (lamports) como STRINGS. Histórico de eventos começa em 2026-08-17
madeonsol_token_fee_claims	Novo 1.24 · PRO+	Feed de eventos de taxa pump.fun, mais recentes primeiro — distribuição type (com payouts[] por acionista) / social_claim (identidade X → carteira, mint nulo) / shares_created / shares_updated / shares_reset / creator_transferred / creator_claim (excluído a menos que type= solicite). Filtros type (lista separada por vírgulas), mint, recipient, actor, social_platform, social_user_id, min_sol, since / before. Push: canal WS token:fee_claims (evento token:fee_claim). Histórico começa em 2026-08-17
madeonsol_tokens_surges	Novo 1.25 · PRO+	Disparos de momentum de tokens, mais recentes primeiro — kind surge (token com menos de 30 min vs seu MC de lançamento; tier early ≤10 min ≥$12k ≥3× · strong ≤30 min ≥$30k ≥6× e ≥2× o mínimo de 3 min · breakout ≤2 min ≥$45k ≥8×; cada um uma vez por mint, sustentado ≥10 s) ou revival (sem candle de negociação ≥24 h, depois ≥5 compras / ≥$500 de volume de compra / ≥1,5× o MC pré-dormência na fita — nunca uma marca de preço; tier nulo). Cada linha: burst tape (unique_buyers nulo fora da cobertura de negociação), kol, early_buyers (agrupado / vendido / sniper), deployer, risk_flags[] (vazio = nenhuma flag levantada, não verificado limpo) e outcome (+1 h MC / pico / mínimo) uma vez com ≥65 min. stats=1 = taxas de acerto por (tipo, nível) ao longo de days. Filtros kind, tier, mint, launchpad, deployer_tier, min_mc_usd / max_mc_usd, min_buys, exclude_flags (lista separada por vírgulas), only_clean; cursores since / before; limit ≤200. Push: canal WS token:surges (eventos token:surge / token:revival) + registro de webhook. Retenção de 60 dias
madeonsol_tokens_batch_risk	PRO+	Pontuação em lote de risco de rug/segurança para até 50 mints — mesma forma que madeonsol_token_risk + as_of. Mints não rastreados retornam { mint, error: "not_tracked" } sem falhar o lote; conta como uma solicitação
madeonsol_token_candles	PRO+	Candles OHLCV históricos (1m–1d). PRO=OHLCV 30d; ULTRA=+fluxo líquido, delta de liquidez, volume MEV, histórico completo
madeonsol_token_flow	PRO+	Agregado de fluxo de negociação (volume orgânico vs falso) em um window de 1h/24h — carteiras únicas/compradores/vendedores, contagens de compra/venda + SOL, net_sol, proxy de wash-trading trades_per_wallet
madeonsol_token_trades	Novo 1.19 · PRO+	Fita de negociação com escopo de mint — negociações brutas paginadas por cursor para um token (filtros de ação / carteira / desde–até, padrão FULL history). Histórico começa em 2026-04-12; o bloco coverage marca o escopo

Regras de Copy-Trade (PRO/ULTRA)

Regras no lado do servidor que disparam sinais quando uma carteira de origem observada negocia. Entregues via webhook (assinado com HMAC) e/ou WebSocket.

Ferramenta	Descrição
madeonsol_copytrade_list	Liste suas regras
madeonsol_copytrade_create	Crie uma regra. Retorna webhook_secret uma vez — armazene-a
madeonsol_copytrade_get	Obtenha uma regra
madeonsol_copytrade_update	Atualize campos ou alterne is_active
madeonsol_copytrade_delete	Exclua permanentemente
madeonsol_copytrade_signals	Sinais disparados recentes (até 7 dias)

Alertas de Coordenação KOL (PRO/ULTRA — sinais push v1.1)

Alertas push em tempo real quando um cluster de KOLs co-compra o mesmo token. Dispara em ~1s (push pg_notify). Entregues via WebSocket (canal kol:coordination, com escopo de usuário) e/ou webhook assinado com HMAC.

Ferramenta	Descrição
madeonsol_coordination_alerts_list	Liste suas regras (PRO=5, ULTRA=20)
madeonsol_coordination_alerts_create	Crie uma regra. Retorna webhook_secret uma vez — armazene-a
madeonsol_coordination_alerts_get	Obtenha uma regra
madeonsol_coordination_alerts_update	Atualize campos ou alterne is_active
madeonsol_coordination_alerts_delete	Exclua permanentemente

Sinal KOL Scout — primeiro toque de KOL (novo na 1.3)

Cada evento de "primeira compra de KOL em um mint de token". Filtrável por nível de scout (S/A/B/C de mv_kol_scout_score), taxa de vitória do KOL, idade do token, sufixo do mint.

Backtest: scouts de nível S atraem ≥3 KOLs de acompanhamento em 4h ~50% das vezes vs ~14% de linha de base (38d / 491k compras / 72.549 eventos). Leaderboard público em madeonsol.com/kol/scouts.

Ferramenta	Descrição
madeonsol_kol_first_touches	Eventos recentes de primeiro toque de KOL. Filtros: min_scout_tier, min_kol_winrate_7d, token_age_max_min, mint_suffix, preset, etc.
madeonsol_first_touch_subscriptions_list	Liste suas assinaturas de webhook de primeiro toque — ULTRA
madeonsol_first_touch_subscriptions_create	Crie uma regra de webhook (assinado com HMAC). Retorna webhook_secret uma vez — armazene-a. Até 10/usuário — ULTRA
madeonsol_first_touch_subscriptions_get	Obtenha uma assinatura — ULTRA
madeonsol_first_touch_subscriptions_update	Atualize campos ou alterne is_active — ULTRA
madeonsol_first_touch_subscriptions_delete	Exclua permanentemente — ULTRA

Não faça polling — use push. Tempo de liderança mediano antes do segundo KOL é de 12 segundos. Canal WebSocket: kol:first_touches (PRO+).

Alertas de Preço (novo na 1.9)

CRUD para alertas de preço de queda/recuperação de tokens. Dispara quando o market cap de um token cruza seu limite. PRO=5 regras, ULTRA=25.

Ferramenta	Descrição
madeonsol_price_alerts_list	Liste suas regras de alerta de preço
madeonsol_price_alerts_create	Crie um alerta de queda/recuperação. Retorna webhook_secret uma vez — armazene-o
madeonsol_price_alerts_get	Obtenha uma regra de alerta por ID
madeonsol_price_alerts_update	Atualize campos ou alterne is_active
madeonsol_price_alerts_delete	Exclua permanentemente

Leaderboard de Scouts & Consenso KOL (novo na 1.9)

Ferramenta	Nível	Descrição
madeonsol_scout_leaderboard	PRO+	KOLs de nível scout superior ranqueados por taxa de acompanhamento de primeiro toque, taxa de vitória e ROI
madeonsol_kol_consensus	PRO+	Tokens com o sinal mais forte de concordância KOL — ponderado por pontuação de scout e PnL recente
madeonsol_peak_history	PRO+	Janelas históricas de pico de densidade para um token — cada pico de coordenação com detalhamento de KOL
madeonsol_coordination_history	PRO+	Log global de eventos de coordenação com token, contagem de KOL, pontuação e resultado

Estatísticas Derivadas de Carteira (novo na 1.9)

madeonsol_wallet_stats agora retorna um objeto stats com campos derivados: win_rate (0-1), roi, verdict ("strong" | "profitable" | "neutral" | "losing") e biggest_miss (token com o maior ganho pós-saída que a carteira perdeu).

Streaming & Webhooks

Ferramenta	Descrição
madeonsol_stream_token	Obtenha seu token WebSocket para streaming de KOL/deployer e stream de trades DEX — PRO/ULTRA. Nunca expira (1.24.1): mesmo token em cada chamada; rotate: true o substitui (valor antigo funciona por mais 60 s); expires_at / next_refresh_at sempre null. Os canais agora também incluem token:locks (novos contratos de lock/vesting, evento token:lock), token:fee_claims (eventos de taxas do pump.fun, evento token:fee_claim) e token:surges (novo 1.25 — disparos de momentum de token, eventos token:surge / token:revival, com risk_flags[]; filtros de inscrição kinds[], tiers[], launchpads[], exclude_flags[], min_mc_usd / max_mc_usd, deployer_tier[])
madeonsol_stream_sessions_list	Liste suas sessões WebSocket ativas — id, service, tier, channels, connected_at, remote_ip, messages_sent — PRO/ULTRA
madeonsol_stream_session_kill	Remova uma sessão WebSocket ativa pelo ID para liberar seu slot de conexão (ex.: um socket fantasma) — PRO/ULTRA
madeonsol_create_webhook	Registre um webhook para notificações push em tempo real — PRO/ULTRA
madeonsol_list_webhooks	Liste seus webhooks registrados — PRO/ULTRA
madeonsol_delete_webhook	Exclua um webhook pelo ID — PRO/ULTRA
madeonsol_test_webhook	Envie um payload de teste para verificar um webhook — PRO/ULTRA

Geral

Ferramenta	Descrição
madeonsol_discovery	Liste todos os endpoints e preços (grátis, sem autenticação)
madeonsol_me	Inspecione sua conta — nível, estado da cota diária/rajada, requisições restantes, expiração da assinatura, uso por recurso (webhooks, carteiras de copy-trade, regras de coordenação, etc.). Auto-limite sem precisar analisar cabeçalhos de rate-limit.

Níveis

Nível	Preço	Carteiras monitoradas	Requisições/dia
BASIC (grátis)	$0	10	200
PRO	€43/mês (€430/ano) ≈ $49	50	10.000
ULTRA	€131/mês (€1310/ano) ≈ $149	100 + eventos WS	100.000
BUSINESS	€400/mês (€4000/ano) ≈ $449	500 + eventos WS	500.000

O nível gratuito retorna a forma completa de resposta REST em 40+ endpoints — carteiras reais, assinaturas de TX, precisão total — com feeds ao vivo atrasados em 5 minutos (respostas atrasadas carregam delay/as_of e um cabeçalho X-Data-Delay). Níveis pagos são em tempo real e desbloqueiam webhooks, WebSockets, motores de regras e profundidade de dados exclusiva do ULTRA; x402 pay-per-call é sempre em tempo real. Obtenha uma chave em madeonsol.com/pricing.

Também Disponível

Plataforma	Pacote
SDK TypeScript	madeonsol no npm
SDK Rust	madeonsol no crates.io
Python (LangChain, CrewAI)	madeonsol-x402 no PyPI
ElizaOS	@madeonsol/plugin-madeonsol
Solana Agent Kit	solana-agent-kit-plugin-madeonsol

Licença

MIT