Agni Folio

Rastreador personal de patrimonio y cartera — 23 herramientas con alcance OAuth para tenencias, rendimiento, estado FIRE, P&L de cripto y escrituras de transacciones con confirmación en más de 20 mercados.

Ver en agnifolio.com

Documentación

Agni Folio incluye un servidor Model Context Protocol (MCP). Apunte cualquier cliente compatible con MCP — Claude Desktop, ChatGPT, Cursor, Cline, Continue, o el suyo propio — a nuestro servidor, inicie sesión una vez, y su IA podrá leer sus tenencias, ejecutar análisis de cartera y proponer transacciones igual que Astra dentro de la aplicación.

Qué es

Model Context Protocol es una especificación abierta para conectar asistentes de IA a datos y herramientas externas. En lugar de pegar su cartera en ChatGPT o crear integraciones personalizadas para cada herramienta, MCP ofrece a cualquier cliente de IA una forma estándar de llamar funciones tipadas sobre sus datos.

El servidor MCP de Agni Folio se encuentra en:

https://agnifolio.com/mcp

Habla JSON-RPC 2.0, soporta la versión 2025-03-26 del protocolo MCP, y está protegido por OAuth 2.1 con PKCE.

Por qué podría querer esto

Use la IA que ya paga. Si tiene Claude Desktop, Cursor, o un plan Pro en otro lugar, no necesita usar Astra dentro de la aplicación web de Agni Folio — su IA existente puede responder preguntas sobre la cartera directamente con sus datos reales.
Traiga su propio modelo. Ejecute un LLM local mediante un cliente compatible con MCP (Cline, Continue) y mantenga su análisis de cartera completamente en el dispositivo después de obtener los datos.
Intégrelo en flujos de trabajo más amplios. Pida a su IA que “mire mis tenencias de Agni Folio y las compare con la lista de seguimiento en este documento de Notion” — MCP permite que un asistente obtenga datos de muchas fuentes en una sola conversación.
Cree automatizaciones. Cualquier herramienta que hable MCP — incluidos scripts personalizados — puede consultar su cartera sin extracción de pantalla ni APIs no oficiales.

Clientes compatibles

Cualquier cliente que implemente MCP 2025-03-26 con OAuth 2.1 debería funcionar sin configuración adicional. Probado:

Cliente	Estado
Claude Desktop	✅ Compatible mediante Conectores → Añadir conector personalizado (o Desarrollador → Servidores MCP)
ChatGPT	✅ Compatible mediante conectores personalizados (modo Desarrollador; Plus / Pro / Business / Enterprise)
Cursor	✅ Compatible mediante configuración `mcpServers`
Cline	✅ Compatible (extensión de VS Code)
Continue	✅ Compatible (asistente de codificación de IA de código abierto)
Clientes MCP personalizados	✅ Cualquier cosa que implemente la especificación MCP `2025-03-26`

Cómo conectarse

Abra la configuración de MCP en su cliente de IA. Cada cliente tiene su propia forma de añadir un servidor MCP remoto. Busque un campo “Servidor MCP remoto” o “URL de servidor MCP personalizado”.
- Claude Desktop
- ChatGPT
- Cursor
- Cline / Continue / otros Claude ofrece dos formas de añadir un servidor MCP remoto — use la que muestre su versión. Opción A — Conectores (versiones más recientes, recomendada) Vaya a Configuración → Conectores, desplácese hasta Conectores personalizados y haga clic en Añadir conector personalizado (marcado como BETA). Complete:
- Nombre — por ejemplo, Agni Folio
- URL del servidor MCP remoto — https://agnifolio.com/mcp Deje en blanco la Configuración avanzada (ID de cliente OAuth / Secreto de cliente) — Agni Folio utiliza el Registro Dinámico de Clientes, por lo que Claude se registra automáticamente. Haga clic en Añadir. Opción B — Desarrollador → Servidores MCP (versiones anteriores) En Configuración → Desarrollador → Servidores MCP, haga clic en Añadir e introduzca:
```
https://agnifolio.com/mcp
```
En cualquier caso, Claude descubre el flujo OAuth mediante .well-known/oauth-authorization-server y le guía a través de la pantalla de consentimiento en el primer uso.
Apruebe la pantalla de consentimiento OAuth. La primera vez que su cliente de IA llame a Agni Folio, será redirigido a una pantalla de consentimiento que muestra:
- Qué cliente solicita acceso (por nombre)
  - Qué ámbitos (scopes) desea: agnifolio:read, agnifolio:write, o ambos
  - Los permisos en lenguaje sencillo que otorgan esos ámbitos Haga clic en Aprobar para conceder acceso, o en Denegar para abortar. Nunca compartimos sus credenciales con el cliente de IA — solo un token de acceso con ámbito limitado.
Empiece a hacer preguntas sobre su cartera a su IA. Abra su chat habilitado para MCP y pruebe:
- “Lista mis tenencias de Agni Folio”
  - “¿Cuál es mi exposición a acciones tecnológicas?”
  - “Añade una transacción de compra de 100 acciones de AAPL a $185 a mi cuenta de corretaje” (mutación — requiere el ámbito agnifolio:write) Su IA descubrirá las herramientas disponibles, llamará a la correcta y responderá con sus datos reales.

Qué puede hacer su IA

Su IA conectada obtiene el mismo catálogo de herramientas que Astra tiene dentro de Agni Folio:

Capacidad	Ejemplos de herramientas	Ámbito requerido
Leer tenencias	`list_holdings`, `get_entry_details`, `get_recent_transactions`	`agnifolio:read`
Ejecutar análisis	`compute_concentration`, `compute_xirr`, `get_dividend_summary`	`agnifolio:read`
Proponer cambios	`add_portfolio_entry`, `add_transaction`, `edit_entry`, `delete_entry`	`agnifolio:write`

Use tools/list (el método estándar de descubrimiento de MCP) para ver el catálogo en vivo y actualizado desde cualquier cliente.

Ámbitos — lectura vs escritura

Ámbito	Otorga	Recomendado para
`agnifolio:read`	Leer tenencias, ejecutar análisis, ver transacciones	Asistentes de IA de solo lectura, paneles, investigación
`agnifolio:write`	Todo lo de `read` MÁS crear / editar / eliminar entradas y transacciones	Asistentes de IA en los que confía para hacer cambios en su nombre

Usted decide qué ámbitos otorgar en la pantalla de consentimiento. La mayoría de los usuarios comienzan solo con read y actualizan a write una vez que han visto cómo se comporta la IA.

Modelo de seguridad

OAuth 2.1 + PKCE. Flujo de código de autorización estándar de la industria — sin compartir contraseñas, sin tokens de copiar y pegar.
Registro Dinámico de Clientes (RFC 7591). Los nuevos clientes MCP se auto-registran; usted los aprueba por nombre en la pantalla de consentimiento.
Llamadas limitadas por ámbito. Las herramientas de solo lectura requieren agnifolio:read; las herramientas de mutación requieren agnifolio:write. Usted elige cuáles otorgar en la pantalla de consentimiento.
Registro de auditoría por llamada. Cada ejecución de herramienta se registra: qué cliente llamó, qué herramienta, cuándo. Puede auditar su propio uso desde Configuración → IA conectada.
Revocable en cualquier momento. Desconecte un cliente desde Configuración → IA conectada. Las solicitudes futuras de ese cliente se rechazan de inmediato.

Registro de auditoría y gestión de IA conectada

Abra Configuración → IA conectada para:

Ver cada cliente de IA conectado a su cuenta, por nombre
Revisar los ámbitos que tiene cada uno
Ver la última vez que cada cliente llamó al servidor
Revocar cualquier cliente con un clic (instantáneo — sin tiempo de espera)

Cada llamada MCP externa aparece junto a la actividad en la aplicación de Astra en la misma vista de auditoría.

Descubrimiento OAuth (para desarrolladores de clientes)

Si está construyendo o depurando un cliente MCP, nuestros endpoints de descubrimiento siguen la especificación:

# Authorization server metadata (RFC 8414)
curl https://agnifolio.com/.well-known/oauth-authorization-server

# Protected resource metadata
curl https://agnifolio.com/.well-known/oauth-protected-resource

Ambos devuelven JSON que declara nuestro authorization_endpoint, token_endpoint, registration_endpoint, revocation_endpoint, ámbitos compatibles, tipos de respuesta compatibles y code_challenge_methods_supported: ["S256"].

La URL del recurso es https://agnifolio.com/mcp.

Cuándo MCP no es la herramienta adecuada

Cotizaciones de precios en tiempo real durante el horario de mercado. El MCP de Agni Folio devuelve precios diarios en caché, no la cinta en vivo. Use la aplicación de su corredor para precios en el momento de la ejecución.
Importaciones masivas de una sola vez. Si tiene un estado de cuenta de corretaje de 500 filas, la página dedicada de Importación de transacciones con IA es más rápida y determinista que pedir a una IA externa que haga lo mismo.
Conversaciones sensibles de rendición de cuentas. Los check-ins de Money Crew, la configuración de titulares legados y otros flujos de trabajo orientados a personas viven dentro de la aplicación de Agni Folio — no están expuestos a través de MCP.

Qué sigue

Agente de IA Astra — el mismo conjunto de herramientas, presentado dentro de la aplicación web de Agni Folio en lugar de a través de su IA externa
Información de cartera — la vista de análisis estática dentro de la aplicación
Seguimiento de inversiones — cómo se estructura la subyacente que su IA leerá