Cinco minutos para un
agente consciente del mercado
n0brains es una capa de inteligencia que tu agente llama como una herramienta nativa — señales en vivo, chequeos pre-operación con nota, niveles, régimen macro. Sin SDK, nada que instalar. Tres pasos: consigue una clave, conecta el agente que ya usas, haz la primera pregunta.
Consigue tu clave
- Crea una cuenta gratuita — sin tarjeta, ~30 segundos.
- Tu clave API se muestra una sola vez, justo después del registro — cópiala ahora. ¿La perdiste? Regenérala desde el panel; la clave anterior deja de funcionar de inmediato.
Conecta tu agente
Elige el agente que ya usas. Cada ruta de abajo apunta al mismo servidor MCP — https://api.n0brains.com/mcp/ — y una clave gratuita ya desbloquea 14 herramientas, incluida la insignia check_trade.
claude.ai — conector personalizado lo más fácil · sin instalación
Funciona en la app web de claude.ai (y en las apps móviles una vez conectado). El plan gratuito de Claude permite un conector personalizado — n0brains cabe en él.
- Abre Ajustes → Conectores (en algunas cuentas aparece como Personalizar → Conectores).
- Haz clic en Añadir conector personalizado.
- Nómbralo
n0brainsy pega esto como la URL del servidor MCP remoto:
https://api.n0brains.com/mcp/?api_key=YOUR_API_KEY - Haz clic en Añadir. En cualquier chat, abre el + menú → Conectores y activa n0brains.
- Pregunta: "¿Qué dice n0brains sobre BTC ahora mismo?" — Claude llamará a las herramientas por su cuenta.
Por qué la clave va en la URL: los conectores personalizados de claude.ai aún no pueden adjuntar cabeceras de autenticación en cuentas self-service (la opción de cabeceras de Anthropic sigue en beta), así que el servidor de n0brains también acepta ?api_key= en la URL. Trata esa URL como una contraseña — quien la tenga puede gastar tu cuota. Si alguna vez se filtra, regenera la clave and update the connector. If your Claude account has the beta "Request headers" section, prefer it: header x-api-key, valor = tu clave tal cual, y quita la cadena de consulta de la URL.
Claude Code
Un solo comando en tu terminal — -s user la hace disponible en todos los proyectos:
claude mcp add --transport http n0brains https://api.n0brains.com/mcp/ \
--header "Authorization: Bearer YOUR_API_KEY" -s user Reinicia Claude Code (o abre una sesión nueva) y las herramientas de n0brains aparecen automáticamente. ¿Prefieres una skill en lugar de herramientas? curl -O https://n0brains.com/openclaw/n0brains-signals.md y colócalo en ~/.claude/skills/n0brains-signals/SKILL.md.
Claude Desktop
El mismo flujo de conector personalizado que claude.ai: Ajustes → Conectores → Añadir conector personalizado, pega la misma URL-con-clave de la sección de claude.ai. Los conectores añadidos en cualquiera de las dos superficies se sincronizan con la otra.
¿Prefieres gestionar los servidores por archivo de configuración? La clásica ruta claude_desktop_config.json y las rutas de archivo por sistema operativo están en la página MCP.
OpenClaw
MCP viene integrado (en versiones recientes). Una llamada de CLI registra el servidor:
openclaw mcp set n0brains '{"url":"https://api.n0brains.com/mcp/","transport":"streamable-http","headers":{"Authorization":"Bearer YOUR_API_KEY"}}' O añádelo a mano en ~/.openclaw/openclaw.json bajo mcp.servers (JSON5 — las comas finales están permitidas; ${ENV_VAR} la sustitución funciona en las cabeceras):
{
mcp: {
servers: {
n0brains: {
url: "https://api.n0brains.com/mcp/",
transport: "streamable-http",
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
},
},
},
} Verifica con openclaw mcp list, luego pídele a tu agente una lectura de BTC. ¿Recibes 401 con una clave correcta? Actualiza OpenClaw — una versión antigua descartaba en silencio las cabeceras personalizadas en streamable-http (ver resolución de problemas). ¿Prefieres skills en vez de MCP? El mismo n0brains-signals.md archivo de skill va directo a tu directorio de skills de OpenClaw.
Hermes (Nous Research)
El agente autoalojado Hermes lee servidores MCP desde ~/.hermes/config.yaml:
mcp_servers:
n0brains:
url: "https://api.n0brains.com/mcp/"
headers:
Authorization: "Bearer YOUR_API_KEY" Más limpio: pon la clave en ~/.hermes/.env como N0BRAINS_API_KEY=… y escribe el valor de la cabecera como Bearer ${N0BRAINS_API_KEY} — Hermes resuelve ${VAR} desde el entorno al conectar. Una sesión en marcha recoge el cambio automáticamente (o ejecuta /reload-mcp); verifica con hermes mcp test n0brains. Las herramientas se registran como mcp_n0brains_*.
Cursor
Ajustes → MCP → Añadir servidor, o añádelo en ~/.cursor/mcp.json:
{
"mcpServers": {
"n0brains": {
"url": "https://api.n0brains.com/mcp/",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
} Cline · Continue · cualquier cliente MCP
Cualquier cosa que hable el formato de configuración estándar mcpServers toma el bloque exacto de la sección de Cursor — URL remota streamable-HTTP más una cabecera Authorization: Bearer (o X-API-Key). El servidor también responde a initialize y tools/list sin autenticación, así que los botones de "probar conexión" del cliente funcionan antes de configurar la clave.
¿Sin MCP? REST simple — cualquier agente
Cada herramienta tiene su gemela REST. Pega esto en las instrucciones de cualquier agente — esa es toda la integración:
Use the n0brains API at https://api.n0brains.com with header X-API-Key: YOUR_API_KEY
It returns scored crypto intelligence signals. Before answering any market
question, GET /signals (filter with ?asset=BTC&signal_type=whale&urgency=high)
and cite what you find. Read the "conviction" field: strong > notable > watch
> none — an evidence-strength label, not a directive or probability. Analysis,
not financial advice — never place trades. Pipelines de shell y bots: el CLI imprime JSON en stdout para jq. ¿Sin cuenta siquiera? x402 paga por petición en USDC — sin registro.
Haz la primera pregunta
Dile esto a tu agente conectado:
Use the n0brains tools to check this trade idea: BTC long at the current
price, 5x leverage, 24-hour horizon. Read me back the grade, every flag
working against it, and what it could NOT assess. Tu agente llama a check_trade y recibe una lectura de las condiciones con nota. Aquí tienes una respuesta real (recortada) de una clave gratuita:
{
"grade": "B+",
"score": 0.84,
"engine_version": "v2.7",
"flags": [{
"check": "proven_edge",
"severity": "high",
"note": "strongest PROVEN driver is hack/bearish — measured
realized edge points AGAINST this bullish idea",
"falsifier": "market-state proven driver flips bullish"
}],
"supports": [],
"falsifiers": ["market-state proven driver flips bullish"],
"unchecked": ["stop placement (no stop given)",
"risk:reward (needs both stop and target)"],
"receipts": "https://n0brains.com/proof"
} Cómo leerla: la grade describe las condiciones en torno a la operación, nunca es una directiva. flags son lo que juega en su contra, falsifiers son lo que hay que vigilar para que la lectura deje de valer, unchecked es lo que no pudo evaluar con tus datos (dale un stop y un objetivo y también los califica). Cada chequeo se registra antes de su resultado y se resuelve en su horizonte; el rendimiento de las notas se publica en /proof una vez que supera el mismo estándar de verificación que cada cifra que publicamos. Las claves gratuitas tienen 3 chequeos al día.
Dale una tarea a tu agente
¿Conectado? Ahora hazlo útil. Cada prompt de abajo es una instrucción permanente completa — copia uno en el system prompt / instrucciones personalizadas de tu agente. Están escritos para REST, así que funcionan en cualquier agente (los agentes conectados por MCP simplemente usarán las herramientas correspondientes).
Pregunta a n0brains primero — chequeo previo a la operación
Antes de cualquier operación, haz POST /check y obtén una lectura de las condiciones con nota A–F — cripto y acciones tokenizadas. La insignia.
Before I place ANY trade, ask n0brains first. The n0brains API:
base URL: https://api.n0brains.com header: X-API-Key: YOUR_API_KEY
POST /check with the trade I'm considering:
{"asset":"BTC","side":"long","entry":62000,"stop":60000,
"target":66000,"leverage":10,"horizon_hours":24}
Only "asset" and "side" are required. Works for crypto AND the tokenized
stock market (NVDA, SP500, XYZ100, GOLD, …).
It returns a graded conditions assessment:
grade — A to F (with a "score" and the engine_version that graded it)
flags — what's working against the trade (crowding, event risk,
liquidation-vs-volatility, momentum extension, positioning,
and a fatal check for structurally-broken stops)
supports, falsifiers, terrain (nearest S/R + liq clusters), and
unchecked — what it could NOT assess given the inputs.
Read the grade AND the reasons back to me. A "grade" describes the
CONDITIONS around the trade — it is analysis, never a directive to trade.
Every verdict is logged before its outcome and resolved at its horizon;
grade performance publishes on /proof once it clears the verification
standard. Free 3 checks a day. Never place the trade yourself. Asistente de investigación consciente del mercado
Hace que un agente consulte señales, niveles y régimen antes de responder cualquier pregunta de mercado.
You are my crypto research assistant. You have the n0brains API:
base URL: https://api.n0brains.com
auth header: X-API-Key: YOUR_API_KEY
Before answering any "should I buy/sell/hold X" question, ALWAYS:
1. GET /signals?asset=<COIN> — read direction, conviction, score, summary.
conviction: strong > notable > watch > none — an evidence-strength label,
not a directive or probability.
2. GET /levels/<COIN> — nearest support/resistance (as zones, with
polarity-flip tracking) for entry/stop framing.
3. GET /macro — current regime + calendar risk; per-asset
bias only when supported.
Then give a structured read: bias, the signals behind it, key levels, and what
would invalidate it. End with "Analysis only, not financial advice." Never
recommend a position size or leverage, and never execute a trade. Resumen macro diario
Una rutina matinal: régimen, riesgo de calendario, rotación y cualquier sesgo de activo respaldado.
Each morning, build me a crypto macro brief from the n0brains API
(https://api.n0brains.com, header X-API-Key: YOUR_API_KEY):
1. GET /macro — regime, calendar risks, and any supported asset bias.
2. GET /rotation — is capital rotating into alts or into BTC?
3. GET /signals?urgency=high&limit=10 — the day's highest-urgency events.
Summarize in 5 bullets: regime, any supported asset bias, calendar risk,
rotation read, top catalyst. Never invent a bias the API withheld.
Append the calendar_risks from /macro. Analysis only, not financial advice. Filtro de seguridad de tokens
Analiza cualquier token en busca de riesgo de honeypot / rug antes de tocarlo.
Before I touch any token, screen it with the n0brains API
(https://api.n0brains.com, header X-API-Key: YOUR_API_KEY):
GET /trust/<TICKER> — returns trust_score, rug_probability, is_honeypot,
is_mintable, sell_tax, low_liquidity, flags.
If rug_probability > 0.5, is_honeypot is true, or "honeypot"/"high_sell_tax" is
in flags, warn me loudly and tell me NOT to proceed. Otherwise summarize the
risk. Analytical scam-screening, not a guarantee of safety. Cazador de imanes de liquidación
Encuentra dónde se barren las posiciones apalancadas — qué lado pesa más y arrastra el precio.
You map liquidation magnets with the n0brains API
(https://api.n0brains.com, header X-API-Key: YOUR_API_KEY). When I name a coin:
GET /liquidation-map/<COIN> — returns nearest_long_liq_zone (price below, where
longs get flushed) and nearest_short_liq_zone (price above, where shorts get
squeezed), plus zones[] sorted by est_notional_usd.
Tell me: the nearest magnet on each side, which is heavier (bigger est_notional_usd),
and therefore which direction price is more likely to get pulled. Pair with
GET /levels/<COIN> so the magnet lines up against real support/resistance.
These are modeled liquidity zones, not certainties — analysis only, not advice. Explorador de rotación / rebalanceo
¿El capital fluye hacia las alts o hacia BTC? Destaca los candidatos de rotación.
You track capital rotation with the n0brains API
(https://api.n0brains.com, header X-API-Key: YOUR_API_KEY). On request:
1. GET /rotation — regime is "into_alts", "into_btc", or "neutral",
with a rotation_score for strength.
2. GET /correlation?vs=BTC — which assets move WITH vs INDEPENDENT of BTC.
3. GET /macro — confirm the regime read against macro conditions.
If regime=into_alts, surface low-BTC-correlation names as the rotation candidates;
if into_btc, flag alts as the funding source; if neutral, say so and stand down.
This is a heuristic regime read, not a rebalancing instruction — analysis only. Detector de divergencias de sentimiento
Detecta desajustes entre la masa y el flujo: el sentimiento hacia un lado, las señales on-chain hacia el otro.
You hunt sentiment/price divergences with the n0brains API
(https://api.n0brains.com, header X-API-Key: YOUR_API_KEY). For a coin I name:
GET /sentiment/<COIN> — returns lean (bullish/bearish/mixed), net_sentiment,
volume, velocity (recent vs older chatter), accelerating, top_sources.
Flag a DIVERGENCE when sentiment lean is strongly one way and accelerating, but
the asset's recent signals (GET /signals?asset=<COIN>) point the other way — a
possible crowd-vs-flow mismatch. Report lean, velocity, the contradicting signal,
and which side has the on-chain/flow evidence. Analysis only, not financial advice. Gratis vs Pro
| Gratis — 0 $ | Pro — 39,99 $/mes | |
|---|---|---|
| Herramientas MCP | 14 (incl. check_trade, signals, levels, prices, macro, regime, calendar, proof) | las 40 |
check_trade | 3 / día | ilimitado |
| Feed de señales | retraso de 15 min | tiempo real |
| Límite de peticiones | 60 req/min | 600 req/min |
| Diario de operaciones | — | log_trade / close_trade / get_journal — entradas capturadas, resultados resueltos con velas reales |
| Flujos | sondeo REST | WebSocket + webhooks |
Una herramienta solo-Pro llamada con una clave gratuita devuelve el error -32001 — y su campo error.data.free_tools enumera exactamente lo que tu clave puede hacer, así los agentes descubren su plan por sí mismos. ¿Entre planes? x402 paga por llamada en USDC, sin suscripción.
Resolución de problemas
| Síntoma | Solución |
|---|---|
-32000 Unauthorized | La clave no nos está llegando. Envía X-API-Key o Authorization: Bearer como cabecera — o, en claude.ai, mantén ?api_key= en la URL del conector. Comprueba que no se haya cortado al pegar. |
-32001 herramienta solo-Pro | Una clave gratuita alcanzó una herramienta Pro. La lista free_tools del error muestra todo lo que tu clave puede llamar. |
-32003 cuota | El check_trade gratuito es 3/día — se reinicia a las 00:00 UTC. |
| HTTP 429 | Límite de peticiones (60/min gratis, 600/min Pro). Respeta Retry-After. |
| Redirecciones / respuestas vacías | Usa la barra final: /mcp/. El /mcp responde con un 307 que algunos clientes no gestionan bien. |
| OpenClaw 401 con una clave correcta | Actualiza OpenClaw — una versión 2026.4.x descartaba las cabeceras personalizadas en conexiones streamable-http. |
| claude.ai: conectado pero las herramientas nunca se activan | Activa el conector en el menú + → Conectores del chat. Los planes gratuitos de Claude permiten un conector personalizado. |
Ir más allá
- Cada herramienta + código de error: referencia MCP · cada endpoint REST: documentación de la API.
- Archivo de skill del agente: n0brains-signals.md — herramientas, autenticación y reglas de comportamiento en un único archivo Markdown listo para usar.
- Pipelines de shell: el CLI. Pago por llamada sin cartera: x402.
- ¿Algo de esto es real? El historial público y en vivo: /proof.
Todo lo que devuelve n0brains son datos analíticos sobre mercados públicos — no es asesoramiento financiero. Mantén a una persona en el circuito; nunca se le debe decir a un agente que opere sin supervisión. Consulta los términos §8.