Serveur MCP Numeratica
✓ VérifiéPermet aux clients IA d'effectuer des calculs déterministes de planification financière américaine, notamment des simulations de retraite Monte Carlo, la fiscalité, les RMD et la Sécurité sociale.
Aussi connu sous numeratica/mcp, mcp, @numeratica/mcp
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.5
- Dernier commit
- 28 juil. 2026
- Licence
- MIT
Qu'est-ce que Numeratica MCP ?
Numeratica est un serveur MCP. Permet aux clients IA d'effectuer des calculs déterministes de planification financière américaine, notamment des simulations de retraite Monte Carlo, la fiscalité, les RMD et la Sécurité sociale.
Résumé généré à partir du README du projet
À propos du MCP server Numeratica
Numeratica fournit un bridge spécialisé pour les clients IA tels que Claude Desktop et Cursor afin d'accéder à des calculs déterministes de planification financière américaine. Ce MCP server agit comme une couche de transport qui transmet les requêtes à l'API Numeratica hébergée, garantissant que toute la logique de calcul reste centralisée et précise. Il permet aux utilisateurs d'effectuer des tâches complexes telles que des simulations de retraite Monte Carlo, des calculs fiscaux, des évaluations de RMD, la planification de la Sécurité sociale et des conversions Roth.
Les utilisateurs peuvent lancer le serveur immédiatement via npx sans configuration initiale pour parcourir le catalogue d'outils disponibles en mode découverte uniquement. Pour exécuter de réels calculs financiers, une NUMERATICA_API_KEY doit être fournie via une variable d'environnement. Le serveur est conçu sans dépendances d'exécution, utilisant les capacités natives de Node fetch et readline pour maintenir une empreinte légère. Il fonctionne comme un lien direct entre votre client MCP local et l'endpoint de l'API distante.
Ce que vous pouvez faire avec
- 1Simuler des scénarios de retraiteDemandez à l'IA d'effectuer une simulation Monte Carlo pour un âge de retraite et un âge actuel spécifiques.
- 2Explorer les outils financiers disponiblesUtilisez le mode découverte uniquement pour consulter la liste complète des soixante-seize outils disponibles sans avoir besoin d'une clé API.
- 3Calculer des obligations fiscales complexesDemandez des calculs de planification financière spécifiques, incluant les impôts, les RMD et la Sécurité sociale, via l'interface IA.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Numeratica MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Numeratica MCP dans Claude Code
$ claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcpInstaller Numeratica MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Installer Numeratica MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Installer Numeratica MCP dans VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@numeratica/mcp"],"env":{"NUMERATICA_API_KEY":"<YOUR_NUMERATICA_API_KEY>"}}'Installer Numeratica MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Installer Numeratica MCP dans Codex
$ codex mcp add mcp --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' -- npx -y @numeratica/mcpInstaller Numeratica MCP dans 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>"
Installer Numeratica MCP dans Gemini CLI
$ gemini mcp add -s user -e 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp npx -- -y @numeratica/mcpInstaller Numeratica MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Configuration
NUMERATICA_API_KEYRequisSecretNumeratica 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.
| Nom | Description | Type |
|---|---|---|
| NUMERATICA_API_KEY | Numeratica API key (nmr_sk_...). Free self-serve key at https://docs.numeratica.com/get-key | RequisSecret |
| 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. |
Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblenumeratica/mcp is public and reachablegithub.com/numeratica/mcp ↗Réussi
- Le nom du package correspond au dépôt source@numeratica/mcp names numeratica/mcp as sourcenpmjs.com/package/@numeratica/mcp ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for @numeratica/mcpnpmjs.com/package/@numeratica/mcp/v/0.1.5#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-07-28github.com/numeratica/mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @numeratica/mcpRéussi
- Aucun avis critique dans le package ou ses dépendances1 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 100 msRéussi
README
Voir sur 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
Questions sur Numeratica MCP
Comment ajouter Numeratica MCP à Claude Code ?
Exécutez claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Numeratica MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Ma clé API est-elle sécurisée ?
Oui, la clé est envoyée uniquement dans l'en-tête Authorization et n'est jamais enregistrée par le bridge.