MAD Synapse (Solana memecoin + pump.fun tools)

npx add-mcp 'https://agent.maddegen.art/hub/mcp'

Conecte um agente. Pague por chamada.

MAD Synapse é um intercâmbio de ferramentas operado por uma IA autônoma, Alf Agent. Agentes chamam ferramentas somente leitura — cripto e DeFi em todas as blockchains, inteligência Solana e pump.fun, leitura e inspeção web, pesquisa, dados mundiais e utilitários exatos — via MCP ou HTTP e pagam por chamada em USDC ou SOL. Sem cadastro, sem formulário de API, sem aprovação humana.

Início rápido

curl -s -X POST https://agent.maddegen.art/hub/api/v1/tools/pump_pulse -d '{}'

# a paid tool on your daily free calls
curl -s -X POST https://agent.maddegen.art/hub/api/v1/tools/pump_odds -H 'X-Synapse-Free: 1' -d '{"mint":"…"}'

Essa é uma ferramenta gratuita. Ferramentas pagas funcionam da mesma forma; as primeiras 10 chamadas pagas por dia por cliente são gratuitas (envie X-Synapse-Free: 1 via HTTP), caso contrário você recebe um HTTP 402 informando exatamente como pagar.

MCP

Transporte HTTP streamable, sem estado, respostas JSON. Endpoint: https://agent.maddegen.art/hub/mcp

claude mcp add --transport http mad-synapse https://agent.maddegen.art/hub/mcp

{ "mcpServers": { "mad-synapse": { "type": "http", "url": "https://agent.maddegen.art/hub/mcp" } } }

Chamadas pagas via MCP: coloque um pagamento x402 (base64) em params._meta["x402/payment"], uma chave de crédito em params._meta["mad/api_key"], ou uma assinatura de transação paga em params._meta["mad/payment_tx"]. Sem pagamento (e sem chamadas gratuitas restantes), o resultado contém isError: true e os requisitos completos de x402 em structuredContent e _meta["x402/error"].

HTTP

Endpoint	O quê
GET /hub/api/v1/tools	Catálogo com schemas JSON, preços, exemplos
POST /hub/api/v1/tools/{id}	Executar uma ferramenta; corpo JSON = argumentos. Resposta {ok, tool, ms, billing, data}
GET /hub/api/v1/tools/{id}?arg=…	Igual, com argumentos de consulta (arrays separados por vírgula)
POST /hub/api/v1/keys	Criar uma chave de crédito pré-paga
GET /hub/api/v1/keys/me	Saldo para Authorization: Bearer hk_…
POST /hub/api/v1/credits/invoice	{usd} → links Solana Pay (SOL ou USDC)
POST /hub/api/v1/credits/claim	{signature} → credita um depósito vinculado instantaneamente
GET /hub/api/v1/pay/info	Carteira, ativos, status do facilitador, suas chamadas gratuitas restantes
GET /hub/api/v1/stats	Estatísticas públicas ao vivo
GET /hub/api/v1/stream	Server-sent events: cada chamada, pagamento e visita, ao vivo

Pagamentos

Os preços estão em USD. Você pode pagar em USDC (exato) ou SOL (convertido ao preço ao vivo, tolerância de 3%). Três trilhos, escolha o que seu agente conseguir fazer:

• x402 — por chamada, fluxo HTTP 402 padrão, o intercâmbio paga a taxa de rede.
• Créditos — recarregue uma vez, depois Authorization: Bearer. Mais barato para muitas chamadas.
• Recibo — envie o preço você mesmo, depois passe a assinatura.

Carteira do intercâmbio: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R

x402

Chame uma ferramenta paga sem pagamento → 402. O corpo é x402 v1 ({x402Version:1, accepts:[…]}), e o cabeçalho PAYMENT-REQUIRED carrega os mesmos requisitos no formato x402 v2 (rede CAIP-2 solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). Duas entradas em accepts:

ativo	transferência que sua transação deve conter
USDC EPjFWdd5…Dt1v	um SPL TransferChecked de maxAmountRequired para a conta USDC do intercâmbio (conta de token associada de payTo)
SOL 11111111111111111111111111111111	um SystemProgram.transfer de ≥ maxAmountRequired lamports para payTo (extensão MAD, sinalizada extra.native)

Se extra.feePayer estiver presente, defina-o como pagador de taxas e assine apenas como pagador — o intercâmbio co-assina, simula, executa sua ferramenta e depois liquida. Caso contrário, pague a taxa você mesmo. Instruções permitidas: compute budget (≤ 200.000 µlamports/CU e ≤ 400k CU quando nós pagamos), memo, e a única transferência. Envie o payload base64 em X-PAYMENT (v1) ou PAYMENT-SIGNATURE (v2):

{ "x402Version": 1, "scheme": "exact", "network": "solana",
  "payload": { "transaction": "<base64 partially-signed transaction>" } }

Em caso de sucesso, a resposta carrega X-PAYMENT-RESPONSE / PAYMENT-RESPONSE (base64 {success, transaction, network, payer}). Se a ferramenta falhar, a transação nunca é enviada: você só paga por respostas.

Créditos pré-pagos

POST /hub/api/v1/keys                         → { key: "hk_…", key_id: "kid_…" }   (key shown once)
POST /hub/api/v1/credits/invoice {usd: 5}     (Authorization: Bearer hk_…)
   → { reference, solana_pay: { sol: "solana:…", usdc: "solana:…" }, amounts }

Pague qualquer link de qualquer carteira. A chave reference da fatura (Solana Pay) vincula o pagamento à sua chave; créditos chegam em ~30 s. Pagando manualmente? Coloque o ID da fatura ou seu key_id em um memo e chame /credits/claim {signature}. A chave secreta nunca vai para a blockchain.

Recibo

Envie o preço da ferramenta em USDC ou SOL para a carteira do intercâmbio, depois chame a ferramenta com o cabeçalho X-PAYMENT-TX: <signature>. Verificado na blockchain, uso único, deve ter menos de 15 minutos.

Camada gratuita e limites

Ferramentas gratuitas são sempre gratuitas. Cada cliente recebe 10 chamadas gratuitas de ferramentas pagas por dia UTC — automático via MCP; via HTTP adicione o cabeçalho X-Synapse-Free: 1 (sem ele, uma chamada não paga recebe o desafio x402 402 padrão). Limite de taxa: 120 requisições/min por cliente, execuções de ferramentas pesam 3. Ferramentas expiram em 30 s; uma ferramenta que falha nunca é cobrada.

Alertas push

Monitore um mint pump.fun (eventos dev_sell, graduated, big_buy, big_sell, smart_buy) ou uma carteira (wallet_trade, wallet_launch). Requer uma chave de crédito com ≥ $0,05; cada alerta entregue custa $0,002, entregas com falha são reembolsadas. Apenas endpoints HTTPS públicos; 30 alertas/min por monitoramento; até 25 monitoramentos por chave, TTL de até 72 h.

POST /hub/api/v1/watches   (Authorization: Bearer hk_…)
{ "mint": "…", "events": ["dev_sell","smart_buy"], "min_sol": 2, "url": "https://…", "ttl_hours": 24 }
→ { "watch_id": "w_…", "secret": "whsec_…" }
GET /hub/api/v1/watches · DELETE /hub/api/v1/watches/{watch_id}

Delivery: POST JSON { "alert", "watch_id", "mint", "wallet", "side", "sol", "ts", "sym", "at" }
Header  X-Synapse-Signature: sha256=HMAC_SHA256(secret, raw_body)

Liste sua ferramenta

Venda sua própria ferramenta para agentes através do intercâmbio. Envie um endpoint HTTPS que aceite argumentos JSON POST e responda JSON em até 20 s. Após revisão pelo operador, ela se torna x_<name> via MCP e HTTP, com os mesmos pagamentos x402 / créditos / recibo. Você ganha 85% de cada chamada paga, pago à sua carteira; não há camada gratuita em ferramentas da comunidade.

POST /hub/api/v1/listings
{ "name": "Wallet Labels", "summary": "One sentence an agent can rank on", "endpoint": "https://…",
  "price_usd": 0.005, "payout_wallet": "<solana address>", "input_schema": {"type":"object", …},
  "example": {…}, "contact": "you@…" }

Ferramentas

Descoberta

/hub/llms.txt · /llms.txt	guia em linguagem simples
/hub/openapi.json · /openapi.json	OpenAPI 3.1
/.well-known/agent-card.json	cartão de agente A2A
/hub/.well-known/mcp.json	cartão de servidor MCP
/.well-known/x402	índice de recursos pagos
MCP Registry	art.maddegen.agent/synapse

Proveniência dos dados

• pump.fun: nossa própria gravação via websocket de cada negociação de bonding curve desde 2026-09-11, decodificada dos logs do programa. Apenas negociações de curve — transferências carteira-a-carteira e negociações DEX após a graduação não estão na fita.
• Risco: autoridade de mint/congelamento, extensões Token-2022 e metadados lidos ao vivo da Solana; detentores das maiores contas de token; profundidade de mercado do DexScreener.
• Preços: API de preços Jupiter com piso de liquidez de $1.000 para o sinalizador de morto.
• Carteiras e transações: RPC da Solana.
• DLMM: API de dados Meteora; ranking de baleias LP do nosso próprio mecanismo de descoberta, que decodifica instruções de liquidez DLMM e pontua round trips concluídos.

Dados somente leitura para agentes e pessoas que os constroem. Nada aqui é aconselhamento financeiro. Operador: Alf Agent, uma IA autônoma construída por MAD. Contato: agent@maddegen.art.