MCP server de Numeratica
✓ VerificadoPermite que los clientes de IA realicen cálculos deterministas de planificación financiera de EE. UU., incluyendo simulaciones Monte Carlo para la jubilación, impuestos, RMD y Seguridad Social.
También conocido como numeratica/mcp, mcp, @numeratica/mcp
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.5
- Último commit
- 28 jul 2026
- Licencia
- MIT
¿Qué es Numeratica MCP?
Numeratica es un MCP server. Permite que los clientes de IA realicen cálculos deterministas de planificación financiera de EE. UU., incluyendo simulaciones Monte Carlo para la jubilación, impuestos, RMD y Seguridad Social.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Numeratica
Numeratica proporciona un bridge especializado para que clientes de IA como Claude Desktop y Cursor accedan a cálculos deterministas de planificación financiera de EE. UU. Este MCP server actúa como una capa de transporte que redirige las solicitudes a la API de Numeratica alojada, garantizando que toda la lógica de cálculo permanezca centralizada y sea precisa. Permite a los usuarios realizar tareas complejas como simulaciones Monte Carlo de jubilación, cálculos de impuestos, evaluaciones de RMD, planificación de la Seguridad Social y conversiones Roth.
Los usuarios pueden ejecutar el servidor inmediatamente usando npx sin configuración inicial para explorar el catálogo de herramientas disponibles en modo de solo descubrimiento. Para ejecutar cálculos financieros reales, se debe proporcionar una NUMERATICA_API_KEY a través de una variable de entorno. El servidor está diseñado con cero dependencias en tiempo de ejecución, utilizando las capacidades integradas de Node fetch y readline para mantener una huella ligera. Funciona como un cable delgado entre tu cliente MCP local y el endpoint de la API remota.
Qué puedes hacer con él
- 1Simular escenarios de jubilaciónPide a la IA que realice una simulación de Monte Carlo para una edad de jubilación y una edad actual específicas.
- 2Explorar las herramientas financieras disponiblesUsa el modo de solo descubrimiento para ver la lista completa de setenta y seis herramientas disponibles sin necesidad de una clave de API.
- 3Calcular obligaciones fiscales complejasSolicita cálculos de planificación financiera específicos, incluyendo impuestos, RMD y Seguridad Social, a través de la interfaz de la IA.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Numeratica MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Numeratica MCP en Claude Code
$ claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcpInstalar Numeratica MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Instalar Numeratica MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Instalar Numeratica MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@numeratica/mcp"],"env":{"NUMERATICA_API_KEY":"<YOUR_NUMERATICA_API_KEY>"}}'Instalar Numeratica MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Instalar Numeratica MCP en Codex
$ codex mcp add mcp --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' -- npx -y @numeratica/mcpInstalar Numeratica MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@numeratica/mcp"] [mcp_servers.mcp.env] NUMERATICA_API_KEY = "<YOUR_NUMERATICA_API_KEY>"
Instalar Numeratica MCP en Gemini CLI
$ gemini mcp add -s user -e 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp npx -- -y @numeratica/mcpInstalar Numeratica MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Configuración
NUMERATICA_API_KEYObligatorioSecretoNumeratica API key (nmr_sk_...). Free self-serve key at https://docs.numeratica.com/get-key
NUMERATICA_BASE_URLOverride the API base URL. Defaults to https://api.numeratica.com; only needed for a staging or self-hosted deployment.
NUMERATICA_TIMEOUT_MSPer-request timeout in milliseconds (default 120000, minimum 1000). Raise it for long-horizon Monte Carlo runs.
| Nombre | Descripción | Tipo |
|---|---|---|
| NUMERATICA_API_KEY | Numeratica API key (nmr_sk_...). Free self-serve key at https://docs.numeratica.com/get-key | ObligatorioSecreto |
| NUMERATICA_BASE_URL | Override the API base URL. Defaults to https://api.numeratica.com; only needed for a staging or self-hosted deployment. | |
| NUMERATICA_TIMEOUT_MS | Per-request timeout in milliseconds (default 120000, minimum 1000). Raise it for long-horizon Monte Carlo runs. |
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblenumeratica/mcp is public and reachablegithub.com/numeratica/mcp ↗Aprobado
- El paquete indica este repositorio como su origen@numeratica/mcp names numeratica/mcp as sourcenpmjs.com/package/@numeratica/mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for @numeratica/mcpnpmjs.com/package/@numeratica/mcp/v/0.1.5#provenance ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-07-28github.com/numeratica/mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @numeratica/mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 100 msAprobado
README
Ver en GitHub@numeratica/mcp
A thin MCP bridge that connects any MCP client (Claude Desktop, Cursor, …) to the Numeratica financial-planning API — retirement Monte Carlo, taxes, RMDs, Social Security, Roth conversions, and more.
Get a free key at https://docs.numeratica.com.
How it works
This package is a transport bridge, nothing more. It reads JSON-RPC from stdin and forwards each message to the hosted POST /mcp endpoint with your API key as a bearer token, then writes the response back to stdout. The tool list and all results come straight from the API — so the bridge always stays in sync and ships no calculation logic of its own. Your key is sent only in the Authorization header and is never logged.
- Zero runtime dependencies (Node ≥ 20 built-in
fetch+node:readline). - Open source (MIT). The interesting part is the API; this is just the wire.
Install
No install needed — your MCP client runs it on demand with npx. (You can also npm i -g @numeratica/mcp to get the numeratica-mcp command.)
Step 1 — look around, no key needed
Start here. This config needs no signup and no key:
{
"mcpServers": {
"numeratica": {
"command": "npx",
"args": ["-y", "@numeratica/mcp"]
}
}
}
Put it in claude_desktop_config.json (Claude Desktop: Settings → Developer → Edit
Config) or ~/.cursor/mcp.json (Cursor, or a project .cursor/mcp.json), then
restart the client. All 76 tools appear, and you can ask what's available — "What
Numeratica tools do you have?"
Without a key the bridge runs in discovery-only mode: browsing the catalogue works, running a calculation returns a message telling you to add a key. That's the intended state, not a failure.
Step 2 — add a key to run calculations
Get a free key at docs.numeratica.com/get-key, then add one line:
{
"mcpServers": {
"numeratica": {
"command": "npx",
"args": ["-y", "@numeratica/mcp"],
"env": { "NUMERATICA_API_KEY": "nmr_sk_your_key_here" }
}
}
}
Restart, and the tools are live. Try: "Run a retirement Monte Carlo for a 40-year-old retiring at 65."
Configuration
| Variable | Required | Default | Notes |
|---|---|---|---|
NUMERATICA_API_KEY |
to run calculations | — | Your key. Get one free at docs.numeratica.com/get-key. Never logged. Omit it to browse the catalogue in discovery-only mode. |
NUMERATICA_BASE_URL |
no | https://api.numeratica.com |
Override the API base (e.g. for testing). |
You can also pass the key with --key <value> or --key=<value> instead of the env
var, but prefer NUMERATICA_API_KEY: a key on the command line is visible to
ps for every user on the machine, lands in shell history, and is stored verbatim
in MCP client config files that people routinely paste into issue reports. For a
non-env option that avoids all three, use --key-file <path>.
Links
- API docs & reference: https://docs.numeratica.com
- Get a free key: https://docs.numeratica.com/get-key
License
MIT © Numeratica / Francis Townsend-Merino
Preguntas sobre Numeratica MCP
¿Cómo agrego Numeratica MCP a Claude Code?
Ejecuta claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Numeratica MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Es segura mi clave de API?
Sí, la clave se envía únicamente en el encabezado Authorization y el bridge nunca la registra en los logs.