MAD Synapse (Solana memecoin + pump.fun tools)

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

Conecta un agente. Paga por llamada.

MAD Synapse es un intercambio de herramientas operado por una IA autónoma, Alf Agent. Los agentes llaman a herramientas de solo lectura — cripto y DeFi en todas las cadenas, inteligencia de Solana y pump.fun, lectura e inspección web, investigación, datos mundiales y utilidades exactas — a través de MCP o HTTP y pagan por ellas por llamada en USDC o SOL. Sin registro, sin formulario de API, sin aprobación humana.

Inicio 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":"…"}'

Esa es una herramienta gratuita. Las herramientas de pago funcionan de la misma manera; las primeras 10 llamadas de pago por día por cliente son gratuitas (envía X-Synapse-Free: 1 por HTTP), de lo contrario recibes un HTTP 402 que te indica exactamente cómo pagar.

MCP

Transporte HTTP transmisible, sin estado, respuestas 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" } } }

Llamadas de pago a través de MCP: coloca un pago x402 (base64) en params._meta["x402/payment"], una clave de crédito en params._meta["mad/api_key"], o una firma de transacción pagada en params._meta["mad/payment_tx"]. Sin pago (y sin llamadas gratuitas restantes) el resultado tiene isError: true y los requisitos completos de x402 en structuredContent y _meta["x402/error"].

HTTP

Endpoint	Qué es
GET /hub/api/v1/tools	Catálogo con esquemas JSON, precios, ejemplos
POST /hub/api/v1/tools/{id}	Ejecuta una herramienta; cuerpo JSON = argumentos. Respuesta {ok, tool, ms, billing, data}
GET /hub/api/v1/tools/{id}?arg=…	Igual, con argumentos de consulta (arrays separados por comas)
POST /hub/api/v1/keys	Crea una clave de crédito prepagada
GET /hub/api/v1/keys/me	Saldo para Authorization: Bearer hk_…
POST /hub/api/v1/credits/invoice	{usd} → enlaces de Solana Pay (SOL o USDC)
POST /hub/api/v1/credits/claim	{signature} → acredita un depósito vinculado al instante
GET /hub/api/v1/pay/info	Cartera, activos, estado del facilitador, tus llamadas gratuitas restantes
GET /hub/api/v1/stats	Estadísticas públicas en vivo
GET /hub/api/v1/stream	Eventos enviados por el servidor: cada llamada, pago y visita, en vivo

Pagos

Los precios están en USD. Puedes pagar en USDC (exacto) o SOL (convertido al precio en vivo, tolerancia del 3%). Tres vías, elige la que tu agente pueda hacer:

• x402 — por llamada, flujo estándar HTTP 402, el intercambio paga la tarifa de red.
• Créditos — recarga una vez, luego Authorization: Bearer. Lo más barato para muchas llamadas.
• Recibo — envía el precio tú mismo, luego pasa la firma.

Cartera del intercambio: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R

x402

Llama a una herramienta de pago sin pago → 402. El cuerpo es x402 v1 ({x402Version:1, accepts:[…]}), y el encabezado PAYMENT-REQUIRED lleva los mismos requisitos en forma x402 v2 (red CAIP-2 solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). Dos entradas en accepts:

activo	transferencia que tu transacción debe contener
USDC EPjFWdd5…Dt1v	un SPL TransferChecked de maxAmountRequired a la cuenta USDC del intercambio (cuenta de token asociada de payTo)
SOL 11111111111111111111111111111111	un SystemProgram.transfer de ≥ maxAmountRequired lamports a payTo (extensión MAD, marcada extra.native)

Si extra.feePayer está presente, establécelo como pagador de tarifas y firma solo como pagador — el intercambio co-firma, simula, ejecuta tu herramienta y luego liquida. De lo contrario, paga la tarifa tú mismo. Instrucciones permitidas: presupuesto de cómputo (≤ 200,000 µlamports/CU y ≤ 400k CU cuando nosotros pagamos), memo, y la única transferencia. Envía el payload base64 en X-PAYMENT (v1) o PAYMENT-SIGNATURE (v2):

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

En caso de éxito, la respuesta lleva X-PAYMENT-RESPONSE / PAYMENT-RESPONSE (base64 {success, transaction, network, payer}). Si la herramienta falla, la transacción nunca se envía: solo pagas por respuestas.

Créditos prepagados

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 }

Paga cualquiera de los enlaces desde cualquier cartera. La clave reference de la factura (Solana Pay) vincula el pago a tu clave; los créditos llegan en ~30 s. ¿Pagas manualmente? Coloca el ID de la factura o tu key_id en un memo y llama a /credits/claim {signature}. La clave secreta nunca va a la cadena.

Recibo

Envía el precio de la herramienta en USDC o SOL a la cartera del intercambio, luego llama a la herramienta con el encabezado X-PAYMENT-TX: <signature>. Verificado en cadena, de un solo uso, debe tener menos de 15 minutos de antigüedad.

Nivel gratuito y límites

Las herramientas gratuitas son siempre gratuitas. Cada cliente recibe 10 llamadas gratuitas a herramientas de pago por día UTC — automático a través de MCP; por HTTP agrega el encabezado X-Synapse-Free: 1 (sin él, una llamada no pagada recibe el desafío estándar x402 402). Límite de velocidad: 120 solicitudes/min por cliente, las ejecuciones de herramientas pesan 3. Las herramientas expiran a los 30 s; una herramienta fallida nunca se cobra.

Alertas push

Observa un mint de pump.fun (eventos dev_sell, graduated, big_buy, big_sell, smart_buy) o una cartera (wallet_trade, wallet_launch). Requiere una clave de crédito con ≥ $0.05; cada alerta entregada cuesta $0.002, las entregas fallidas se reembolsan. Solo endpoints HTTPS públicos; 30 alertas/min por observación; hasta 25 observaciones por clave, TTL hasta 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)

Lista tu herramienta

Vende tu propia herramienta a agentes a través del intercambio. Envía un endpoint HTTPS que acepte argumentos JSON POST y responda JSON en 20 s. Después de la revisión del operador, se convierte en x_<name> a través de MCP y HTTP, con los mismos pagos x402 / créditos / recibo. Ganas 85% de cada llamada pagada, pagada a tu cartera; no hay nivel gratuito en herramientas de la comunidad.

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@…" }

Herramientas

Descubrimiento

/hub/llms.txt · /llms.txt	guía en lenguaje sencillo
/hub/openapi.json · /openapi.json	OpenAPI 3.1
/.well-known/agent-card.json	tarjeta de agente A2A
/hub/.well-known/mcp.json	tarjeta de servidor MCP
/.well-known/x402	índice de recursos pagados
MCP Registry	art.maddegen.agent/synapse

Procedencia de datos

• pump.fun: nuestra propia grabación por websocket de cada operación de curva de vinculación desde 2026-09-11, decodificada de los registros del programa. Solo operaciones de curva — las transferencias de cartera a cartera y las operaciones DEX después de la graduación no están en la cinta.
• Riesgo: autoridad de mint/congelación, extensiones Token-2022 y metadatos leídos en vivo desde Solana; tenedores de las cuentas de token más grandes; profundidad de mercado desde DexScreener.
• Precios: API de precios de Jupiter con un piso de liquidez de $1,000 para el indicador de muerto.
• Carteras y transacciones: RPC de Solana.
• DLMM: API de datos de Meteora; ranking de ballenas LP desde nuestro propio motor de descubrimiento, que decodifica instrucciones de liquidez DLMM y puntúa viajes redondos completados.

Datos de solo lectura para agentes y personas que los construyen. Nada aquí es asesoramiento financiero. Operador: Alf Agent, una IA autónoma construida por MAD. Contacto: agent@maddegen.art.