Numeratica MCP server
✓ VerifiedMemungkinkan AI client untuk melakukan kalkulasi perencanaan keuangan AS yang deterministik, termasuk simulasi Monte Carlo untuk pensiun, pajak, RMD, dan Social Security.
Juga dikenal sebagai numeratica/mcp, mcp, @numeratica/mcp
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.5
- Commit terakhir
- 28 Jul 2026
- Lisensi
- MIT
Apa itu Numeratica MCP?
Numeratica adalah MCP server. Memungkinkan AI client untuk melakukan kalkulasi perencanaan keuangan AS yang deterministik, termasuk simulasi Monte Carlo untuk pensiun, pajak, RMD, dan Social Security.
Ringkasan dibuat dari README proyek
Tentang Numeratica MCP server
Numeratica menyediakan bridge khusus bagi AI client seperti Claude Desktop dan Cursor untuk mengakses kalkulasi perencanaan keuangan AS yang deterministik. MCP server ini bertindak sebagai transport layer yang meneruskan request ke hosted Numeratica API, memastikan semua logika kalkulasi tetap terpusat dan akurat. Ini memungkinkan pengguna untuk melakukan tugas kompleks seperti simulasi Monte Carlo untuk pensiun, kalkulasi pajak, asesmen RMD, perencanaan Social Security, dan konversi Roth.
Pengguna dapat menjalankan server secara langsung menggunakan npx tanpa setup awal untuk menjelajahi katalog tool yang tersedia dalam mode discovery-only. Untuk mengeksekusi kalkulasi keuangan yang sebenarnya, NUMERATICA_API_KEY harus disediakan melalui environment variable. Server ini dirancang dengan zero runtime dependencies, memanfaatkan kemampuan bawaan Node fetch dan readline untuk menjaga footprint yang ringan. Server ini berfungsi sebagai penghubung tipis antara MCP client lokal Anda dan remote API endpoint.
Apa yang bisa Anda lakukan dengannya
- 1Simulasikan skenario pensiunMinta AI untuk melakukan simulasi Monte Carlo untuk usia pensiun dan usia saat ini yang spesifik.
- 2Eksplorasi financial tools yang tersediaGunakan mode discovery-only untuk melihat daftar lengkap dari tujuh puluh enam tool yang tersedia tanpa memerlukan API key.
- 3Hitung kewajiban pajak yang kompleksMinta kalkulasi perencanaan keuangan spesifik termasuk pajak, RMD, dan Social Security melalui interface AI.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Numeratica MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Numeratica MCP di Claude Code
$ claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcpInstal Numeratica MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Instal Numeratica MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Instal Numeratica MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@numeratica/mcp"],"env":{"NUMERATICA_API_KEY":"<YOUR_NUMERATICA_API_KEY>"}}'Instal Numeratica MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Instal Numeratica MCP di Codex
$ codex mcp add mcp --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' -- npx -y @numeratica/mcpInstal Numeratica MCP di 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>"
Instal Numeratica MCP di Gemini CLI
$ gemini mcp add -s user -e 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp npx -- -y @numeratica/mcpInstal Numeratica MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Konfigurasi
NUMERATICA_API_KEYWajibRahasiaNumeratica 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.
| Nama | Deskripsi | Tipe |
|---|---|---|
| NUMERATICA_API_KEY | Numeratica API key (nmr_sk_...). Free self-serve key at https://docs.numeratica.com/get-key | WajibRahasia |
| 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. |
Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaunumeratica/mcp is public and reachablegithub.com/numeratica/mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@numeratica/mcp names numeratica/mcp as sourcenpmjs.com/package/@numeratica/mcp ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for @numeratica/mcpnpmjs.com/package/@numeratica/mcp/v/0.1.5#provenance ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-07-28github.com/numeratica/mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @numeratica/mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 100 msLolos
README
Lihat di 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
Pertanyaan tentang Numeratica MCP
Bagaimana cara menambahkan Numeratica MCP ke Claude Code?
Jalankan claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Numeratica MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah API key saya aman?
Ya, key hanya dikirimkan melalui header Authorization dan tidak pernah dicatat oleh bridge.