PocketSmith Read-only
oficialSolo lectura: transacciones, presupuestos, previsiones e información de la herramienta de finanzas personales PocketSmith.
¿Qué puedes hacer con PocketSmith Read Only MCP?
- Revisión de salud financiera — Solicita un resumen del patrimonio neto, el ritmo de gasto en comparación con el presupuesto y el estado del presupuesto por categoría.
- Comparaciones de gastos — Compara los gastos de dos períodos por categoría y beneficiario para ver qué cambió.
- Detección de gastos recurrentes — Encuentra suscripciones y facturas recurrentes, con su frecuencia y costo anual total.
- Previsiones de flujo de caja y patrimonio neto — Proyecta los saldos de las cuentas y el patrimonio neto a futuro con el motor de previsiones de PocketSmith.
- Búsqueda de transacciones — Busca transacciones filtradas por fecha, categoría, palabra clave o estado.
- Enlaces directos — Obtén un enlace a la página, el informe o la búsqueda filtrada exactos de PocketSmith de los que se está hablando.
Servidor MCP alojado
npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP
Conecta tu cuenta de PocketSmith a cualquier asistente de IA compatible con el Model Context Protocol.
Al conectar tu asistente de IA a PocketSmith mediante el Model Context Protocol (MCP), tendrá acceso directo a tus datos financieros, presupuestos y previsiones. Podrá ofrecerte información y análisis, además de realizar varias acciones por ti.
Qué hace
El servidor MCP de PocketSmith permite que los asistentes de IA consulten y gestionen tus datos de PocketSmith en tu nombre. En lugar de alternar entre tu asistente de IA y PocketSmith, puedes hacer preguntas y realizar acciones en lenguaje natural:
- Revisar tus gastos, presupuestos y patrimonio neto
- Buscar y categorizar transacciones
- Crear y actualizar eventos presupuestarios
- Analizar tendencias y comparar gastos entre períodos
- Comprobar el estado de sincronización de las fuentes bancarias y activar actualizaciones
- Obtener enlaces directos a la página o el informe adecuado de PocketSmith
Hay dos modos de acceso disponibles:
| Modo | Descripción | Cómo conectarse |
|---|---|---|
| Acceso completo | Las 66 herramientas: consultar, crear, actualizar y eliminar | Con un clic desde el directorio de Claude o ChatGPT |
| Solo lectura | 40 herramientas de solo lectura: consultar y analizar, sin cambios | Configuración manual como conector personalizado (unos pasos adicionales) |
La mayoría de las personas deberían elegir el acceso completo. Para eliminar cualquier elemento, siempre se requiere tu aprobación explícita, y puedes pedirle al asistente que te consulte antes de realizar cualquier otro cambio. Elige el modo de solo lectura si quieres garantizar que el asistente nunca pueda modificar tus datos.
Conexión
El acceso completo está disponible como aplicación en los directorios de Claude y ChatGPT, así que conectarse requiere un solo clic. El modo de solo lectura aún no aparece en ninguno de los dos directorios, por lo que debes añadirlo manualmente como conector personalizado mediante la URL de la sección Otros clientes MCP que aparece más abajo.
Claude (claude.ai, Claude Desktop y aplicaciones móviles)
Acceso completo:
- Abre PocketSmith Complete Access en el directorio de Claude
- Haz clic en Connect
- Se te redirigirá a PocketSmith para autorizar el acceso
Los conectores están vinculados a tu cuenta de Claude, así que, una vez conectado en claude.ai, PocketSmith también estará disponible en Claude Desktop y en las aplicaciones móviles de Claude.
Solo lectura:
- En claude.ai o en Claude Desktop, abre Settings > Connectors
- Haz clic en Add custom connector
- Introduce un nombre (por ejemplo, "PocketSmith Read-only") y la URL
https://mcp-readonly.pocketsmith.com/mcp - Haz clic en Connect junto al nuevo conector y autoriza el acceso en PocketSmith
Claude Code
# Full access
claude mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
# Read-only
claude mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Claude Code te pedirá que autorices mediante OAuth la primera vez que lo uses.
ChatGPT (chatgpt.com y aplicación de escritorio)
Acceso completo:
- Abre PocketSmith en el directorio de aplicaciones de ChatGPT en chatgpt.com
- Haz clic en Connect
- Se te redirigirá a PocketSmith para autorizar el acceso
Las aplicaciones están vinculadas a tu cuenta de ChatGPT, así que, una vez conectado en chatgpt.com, PocketSmith también estará disponible en la aplicación de escritorio de ChatGPT. Si no aparece, reinicia la aplicación de escritorio.
Solo lectura:
El modo de solo lectura debe configurarse en chatgpt.com, no en la aplicación de escritorio:
- Abre Settings > Apps & Connectors y activa Developer mode (en Advanced settings)
- Haz clic en Create para añadir un conector personalizado
- Introduce un nombre (por ejemplo, "PocketSmith Read-only") y la URL
https://mcp-readonly.pocketsmith.com/mcp - Haz clic en Connect: se te redirigirá a PocketSmith para autorizar el acceso
No uses la opción Settings > Plugins > Add MCP server de la aplicación de escritorio: los servidores que se añaden allí solo están disponibles en Codex, no en ChatGPT.
Espacios de trabajo Business/Enterprise/Edu: primero, un administrador del espacio de trabajo debe habilitar la aplicación o añadir el conector desde Workspace settings. Después, cada usuario conecta y autoriza su propia cuenta de PocketSmith.
Codex
Acceso completo: si ya conectaste PocketSmith desde el directorio de aplicaciones de ChatGPT, estará disponible automáticamente en Codex a partir de tu próximo chat. De lo contrario, añádelo desde la línea de comandos:
codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
Solo lectura:
codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Codex te pedirá que autorices mediante OAuth la primera vez que lo uses.
Otros clientes MCP
| Modo | URL |
|---|---|
| Acceso completo | https://mcp.pocketsmith.com/mcp |
| Solo lectura | https://mcp-readonly.pocketsmith.com/mcp |
Cualquier cliente MCP compatible con el transporte HTTP y OAuth puede conectarse mediante estas URL. El servidor admite OAuth 2.0 con PKCE y publica metadatos de descubrimiento en /.well-known/oauth-authorization-server y /.well-known/oauth-protected-resource.
Autenticación
La autenticación se gestiona automáticamente mediante OAuth. Cuando te conectes por primera vez, se te redirigirá a PocketSmith para iniciar sesión y conceder acceso. El asistente de IA recibe un token limitado al modo de acceso que hayas elegido (completo o de solo lectura) y nunca ve tu contraseña de PocketSmith.
Los tokens están cifrados y no mantienen estado: no se almacena nada en el servidor MCP. Puedes revocar el acceso en cualquier momento desde la página de aplicaciones autorizadas de PocketSmith.
Ejemplos de uso
«¿Cómo voy este mes?»
Pide una revisión de tu salud financiera para obtener un resumen de un vistazo:
Tú: ¿Cómo voy económicamente este mes? ¿Voy según lo previsto con mi presupuesto?
Usa la herramienta financial_health_snapshot para mostrar tu patrimonio neto, el ritmo de gastos del mes actual frente al presupuesto, indicadores de estado del presupuesto por categoría y cualquier tarea pendiente, como transacciones sin categorizar.
«¿Qué suscripciones estoy pagando?»
Encuentra cargos recurrentes que quizá hayas olvidado:
Tú: ¿Puedes encontrar todos mis gastos recurrentes y suscripciones? Quiero ver cuánto pago al mes y el coste anual total.
Usa la herramienta find_recurring_expenses para analizar tu historial de transacciones, identificar cargos periódicos por beneficiario, clasificar su frecuencia y calcular el coste anual total.
«Compara mis gastos con los del mes pasado»
Descubre en qué se diferenció el destino de tu dinero:
Tú: Compara mis gastos de este mes con los del mes pasado. ¿Qué categorías aumentaron o disminuyeron?
Usa la herramienta spending_comparison para desglosar ambos períodos por categoría y beneficiario, y destacar los cambios y los beneficiarios nuevos o que ya no aparecen.
«Revisa mis finanzas de marzo»
Obtén una revisión completa de fin de mes:
Tú: Hazme una revisión completa de marzo de 2025: ingresos, gastos, tasa de ahorro y cómo me fue con el presupuesto.
Usa la herramienta month_end_review para generar un informe detallado con un resumen de ingresos y gastos, la tasa de ahorro, las desviaciones del presupuesto por categoría, los principales beneficiarios, las transacciones destacadas y una instantánea del patrimonio neto.
«Categoriza mis transacciones recientes»
Pon en orden las transacciones sin categorizar:
Tú: Tengo un montón de transacciones sin categorizar de la última semana. ¿Puedes revisarlas y categorizarlas?
Usa list_transactions para encontrar transacciones recientes sin categorizar, luego list_categories para consultar el árbol de categorías y update_transaction para asignar las categorías adecuadas según los nombres de los beneficiarios. (Requiere el modo de acceso completo.)
«¿Cuál será el saldo de mi cuenta de ahorros dentro de 6 meses?»
Proyecta los saldos de tus cuentas:
Tú: ¿Cómo evolucionará el saldo de mi cuenta de ahorros durante los próximos 6 meses según mi presupuesto?
Usa cash_flow_forecast para proyectar los saldos mediante el motor de previsiones de PocketSmith, mostrar la evolución prevista de cada cuenta y señalar los momentos en que los saldos podrían caer por debajo de un umbral seguro.
«Llévame allí»
Obtén un enlace directo a la página o el informe adecuado en la aplicación web de PocketSmith:
Tú: ¿Cómo han cambiado mis gastos en comestibles durante el último año? Dame un enlace para poder investigarlo por mi cuenta.
Usa get_trend_analysis para resumir la tendencia y luego navigate_to_trends para crear un enlace directo al informe de tendencias, con filtros previos para la categoría Comestibles y el intervalo de fechas, para que puedas seguir explorando en PocketSmith. Todas las herramientas de navegación funcionan así: el asistente responde y luego te proporciona un enlace a la página, el informe o la búsqueda de transacciones exactos de los que hablaba.
Herramientas disponibles
Análisis (herramientas de análisis compuesto)
Estas herramientas combinan varias llamadas a la API para generar análisis completos y listos para usar:
| Herramienta | Qué hace |
|---|---|
financial_health_snapshot | Patrimonio neto, ritmo de gastos, indicadores de estado del presupuesto y tareas pendientes |
month_end_review | Revisión completa del período con ingresos y gastos, tasa de ahorro, desviación del presupuesto y principales beneficiarios |
spending_comparison | Comparación en paralelo de dos períodos por categoría y beneficiario |
find_recurring_expenses | Detecta suscripciones y facturas recurrentes, con el coste anual total |
cash_flow_forecast | Proyecciones futuras de los saldos de las cuentas con alertas de zonas de riesgo |
net_worth_forecast | Evolución del patrimonio neto con tendencias históricas, previsiones y proyecciones de hitos |
forecast_accuracy | Compara los saldos reales con los previstos para evaluar la fiabilidad del presupuesto |
Presupuestos
| Herramienta | Qué hace |
|---|---|
get_budget | Análisis del presupuesto por categoría para el período previsto |
get_budget_summary | Valores reales de gastos e ingresos frente a los presupuestados para un intervalo de fechas |
get_trend_analysis | Tendencias de gastos por categoría a lo largo del tiempo |
delete_forecast_cache | Fuerza el recálculo del presupuesto después de ediciones masivas |
Transacciones
| Herramienta | Qué hace |
|---|---|
list_transactions | Busca y filtra transacciones por fecha, categoría, palabra clave y estado |
get_transaction | Obtiene todos los detalles de una transacción |
create_transaction | Añade una transacción nueva |
update_transaction | Edita una transacción (beneficiario, categoría, etiquetas, notas, divisiones) |
delete_transaction | Elimina una transacción |
Cuentas e instituciones
| Herramienta | Qué hace |
|---|---|
list_accounts | Muestra todas las cuentas por usuario o institución |
get_account | Obtiene los detalles de una cuenta, incluidos el saldo y las cuentas secundarias |
create_account / update_account / delete_account | Gestiona cuentas |
update_account_display_order | Reordena las cuentas |
list_institutions / get_institution | Consulta instituciones financieras |
create_institution / update_institution / delete_institution | Gestiona instituciones |
list_transaction_accounts / get_transaction_account / update_transaction_account | Consulta y actualiza cuentas de transacciones |
Categorías y reglas
| Herramienta | Qué hace |
|---|---|
list_categories / get_category | Ver la jerarquía de categorías |
create_category / update_category / delete_category | Administrar categorías |
list_category_rules / create_category_rule | Ver y crear reglas de categorización automática |
Eventos de presupuesto
| Herramienta | Qué hace |
|---|---|
list_events / get_event | Ver eventos de previsión del presupuesto |
create_event / update_event / delete_event | Administrar eventos de presupuesto recurrentes y puntuales |
Archivos adjuntos
| Herramienta | Qué hace |
|---|---|
list_attachments / get_attachment | Ver recibos y documentos adjuntos |
create_attachment / update_attachment / delete_attachment | Administrar archivos adjuntos |
assign_transaction_attachment / unassign_transaction_attachment | Vincular o desvincular archivos adjuntos de transacciones |
Fuentes de datos
| Herramienta | Qué hace |
|---|---|
get_data_feeds_connection_status | Comprobar el estado de sincronización de las fuentes bancarias y los datos del proveedor |
refresh_data_feeds_connection | Iniciar una sincronización de una o todas las conexiones de fuentes bancarias |
Navegación
Estas herramientas generan enlaces directos para que el asistente pueda dirigirte a la página exacta de PocketSmith relacionada con la conversación, con filtros previos para las cuentas, categorías y fechas adecuadas, además de cualquier otro control de la página necesario para el informe.
| Herramienta | Qué hace |
|---|---|
navigate_to_transactions | Búsqueda de transacciones, con filtros previos por cuenta, categoría, palabra clave o fecha |
navigate_to_budget | Ir a la página de presupuesto, con ajustes de fecha y otros controles que se pueden configurar mediante el enlace |
navigate_to_trends | Informe de tendencias de gastos o ingresos de una categoría a lo largo del tiempo, con todos los controles disponibles mediante el enlace |
navigate_to_income_expense | Informe de ingresos y gastos (estado de pérdidas y ganancias) con filtros, intervalos de fechas y otras opciones disponibles mediante el enlace |
navigate_to_cashflows | Estado de flujos de efectivo (tabla mes a mes) |
navigate_to_net_worth | Página de patrimonio neto, con todos los filtros y otras opciones disponibles mediante el enlace |
navigate_to_calendar | Calendario de eventos y saldos presupuestarios programados y previstos, con intervalos de fechas disponibles mediante el enlace |
navigate_to_account_summary | Resumen de cuenta para una cuenta y un mes específicos |
Otros
| Herramienta | Qué hace |
|---|---|
get_current_user / update_user | Ver y actualizar el perfil y la configuración del usuario |
list_labels | Ver todas las etiquetas de transacciones |
list_saved_searches | Ver los filtros guardados de búsqueda de transacciones |
list_currencies / get_currency | Datos de referencia de divisas |
list_time_zones | Datos de referencia de zonas horarias |
Modelo de datos de PocketSmith
Comprender la jerarquía de PocketSmith ayuda al hacer preguntas:
Institution (e.g. "Sample Bank")
→ Account (container/group, e.g. "Everyday Credit Card")
→ Transaction Account (where transactions live)
→ Scenario (where budget forecast events live)
- Instituciones representan bancos o proveedores financieros
- Cuentas agrupan una o más cuentas de transacciones y escenarios
- Cuentas de transacciones contienen los registros de transacciones reales
- Escenarios contienen eventos presupuestarios que impulsan el motor de previsiones de PocketSmith
- Categorías tienen una estructura jerárquica (padre/hijo) y se comparten entre todas las cuentas
- Etiquetas son marcas que puedes añadir a las transacciones para agruparlas de forma flexible
Privacidad y seguridad
- Política de privacidad de PocketSmith: https://www.pocketsmith.com/legal/privacy-policy/
- Tus credenciales de PocketSmith nunca se comparten con el asistente de IA
- Los tokens OAuth se cifran con AES-256-GCM y son sin estado (no se almacena nada en el servidor)
- Toda la comunicación con la API utiliza cifrado TLS
- Puedes revocar el acceso en cualquier momento desde aplicaciones autorizadas de PocketSmith
Asistencia
- Ayuda y asistencia: https://learn.pocketsmith.com
- Contactar con asistencia: help@pocketsmith.com