Desarrolladores

Usa tu cartera desde asistentes de IA, la terminal o tu propio código. Todo es de solo lectura y cubre solo los activos que tienes.

Obtener una clave Ver planes

Conecta tu asistente de IA

Pregunta a Claude, ChatGPT, Claude Code o Cursor por tus posiciones, o añade una conversando.

Funciona en todos los planes de Claude, en la web, el escritorio y el móvil. El plan gratuito incluye un conector personalizado.

Inicias sesión en Sonar durante la configuración. ¿No tienes cuenta? Crea una gratis.
URL del servidor
https://sonarfolio.com/api/mcp
Abre Customize y luego Connectors.
Abrir conectores de Claude(se abre en una pestaña nueva)
Selecciona + Add y luego Add custom connector. Llámalo Sonar y pega la URL del servidor.
Si te lo pide, elige Sign in now y Use Claude's published identity, sin ID ni secreto del cliente, y luego Add.
Selecciona Connect, inicia sesión y selecciona Permitir. En un chat, actívalo en + y luego Connectors.

Pruébalo: pregunta a tu asistente

¿Cuáles son mis cinco posiciones más grandes?

Usa ChatGPT en la web. Los servidores MCP personalizados dependen de tu plan de ChatGPT; en Business y Enterprise puede que un administrador tenga que permitirlos.

Inicias sesión en Sonar durante la configuración. ¿No tienes cuenta? Crea una gratis.
URL del servidor
https://sonarfolio.com/api/mcp
Abre Plugins.
Abrir plugins de ChatGPT(se abre en una pestaña nueva)
Selecciona + y luego Add custom MCP server. Llámalo Sonar y pega la URL del servidor.
Pon Authentication en OAuth y deja vacíos el ID y el secreto del cliente. Acepta el aviso y selecciona Create as a plugin.
Cuando te lo pida, inicia sesión y selecciona Permitir. Luego instálalo desde tus plugins y escribe @ en un chat.

Pruébalo: pregunta a tu asistente

¿Cuáles son mis cinco posiciones más grandes?

ChatGPT pide confirmación antes de añadir una posición.

Para clientes con encabezado como Claude Code y Cursor, con una clave de API.

Crea una cuenta gratis y luego una clave. Solo se muestra una vez.
Obtén tu clave de API

Añade Sonar a tu cliente.

Claude Code

claude mcp add --transport http sonar https://sonarfolio.com/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "sonar": {
      "url": "https://sonarfolio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Otros clientes MCP: Streamable HTTP, encabezado Authorization: Bearer YOUR_KEY

https://sonarfolio.com/api/mcp

Ejecuta /mcp en Claude Code para comprobar la conexión.

O sin clave: añade la URL sin el encabezado, ejecuta /mcp, elige Sonar y selecciona Authenticate.

Pruébalo: pregunta a tu asistente

¿Cuáles son mis cinco posiciones más grandes?

Los conectores solo ven los activos que tienes. Pueden añadir las posiciones que describas, pero no operar, mover fondos ni eliminar nada.

Solución de problemas

No se conecta o no muestra herramientas

Comprueba que la URL termina en /api/mcp y que el inicio de sesión acabó con Permitir. Si no, quita Sonar y vuelve a añadirlo.

El asistente dice que hace falta un plan o créditos

Tu plan define lo que ve el asistente; cada llamada a una herramienta es una solicitud. Consulta solicitudes y créditos en API y herramientas de IA.

Desconectaste una app o revocaste una clave

El acceso se corta al instante. Para volver a conectar, quita Sonar, añádelo de nuevo e inicia sesión.

Usas Claude con un plan Team o Enterprise

Un propietario añade Sonar una vez con la URL del servidor; cada miembro inicia sesión en su propia cuenta.

API REST

JSON sobre HTTPS con una clave Bearer. Cada endpoint tiene su herramienta MCP y su comando de la CLI.

curl https://sonarfolio.com/api/v1/assets \
  -H "Authorization: Bearer YOUR_KEY"

GET/api/v1/meMCPget_usageCLIsonar statusPlan, acceso y uso de hoyStarter
GET/api/v1/assetsMCPlist_held_assetsCLIsonar assetsDatos de mercado y sociales de cada activo que tienesStarter
GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>Un activo que tienes: cotización, datos sociales, creadores destacados, cierres de 90 díasStarter
GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>Busca el id de un activo (solo nombres)Starter
GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolioTotales, cambio en 24 h, P&G, distribución, mayores movimientosStandard
GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]Cada posición por cuentaStandard
POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]Añadir una posición: { asset_id, quantity, cost_usd?, date?, account? }Escribe datos. Los clientes MCP lo ven marcado como destructivo; la CLI pregunta antes (--yes lo omite).Starter

Las respuestas incluyen fuente, marcas de tiempo y nuestro aviso legal, además de los encabezados X-RateLimit-Limit, -Remaining, -Reset y X-Credits-Remaining. Errores: { error: { code, message } }.

Línea de comandos

Los mismos datos en tu terminal y tus scripts, con la misma clave.

Instalar e iniciar sesión

npm install -g sonarfolio
sonar login

Requiere Node 18 o posterior. sonar login guarda una clave de API y herramientas de IA; en scripts y CI, define SONAR_API_KEY en su lugar.

Más opciones de instalación

Vuelve a ejecutar la instalación para actualizar. Pruébalo sin instalar: npx -p sonarfolio sonar status. Instálalo desde este sitio: npm install -g https://sonarfolio.com/cli/latest.tgz. Tu clave se guarda en ~/.config/sonar/config.json, legible solo por ti.

Comandos

Los comandos aparecen junto a los endpoints REST, además de sonar watch [portfolio|assets] para una vista en vivo dentro de tu límite diario.

En scripts

sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'

Cada comando acepta --json e imprime el JSON de la API.

Límites y créditos

Cada llamada a la API, llamada a una herramienta MCP o comando de la CLI es una solicitud. Los límites diarios se reinician a las 00:00 UTC.

Plan	Solicitudes incluidas	Cubre
Free	Solo créditos de API	Precios y tu cartera
Starter	500 al día	Precios, datos sociales y añadir posiciones
Standard	1000 al día	Suma posiciones, P&G, distribución y datos onchain
Premium	2000 al día	Suma posiciones, P&G, distribución y datos onchain

Los nombres de plan en la lista de endpoints indican dónde se incluye una solicitud; en lo demás pagan los créditos de API, en cualquier plan. $1 por 1000, los créditos nunca caducan y cada cuenta empieza con 100.