MCP server Numeratica
✓ ПровереноПозволяет ИИ-клиентам выполнять детерминированные расчеты для финансового планирования в США, включая симуляции Монте-Карло для выхода на пенсию, налоги, RMD и социальное обеспечение.
Также известен как numeratica/mcp, mcp, @numeratica/mcp
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.5
- Последний коммит
- 28 июл. 2026 г.
- Лицензия
- MIT
Что такое Numeratica MCP?
Numeratica — это MCP server. Позволяет ИИ-клиентам выполнять детерминированные расчеты для финансового планирования в США, включая симуляции Монте-Карло для выхода на пенсию, налоги, RMD и социальное обеспечение.
Сводка сгенерирована из README проекта
О Numeratica MCP server
Numeratica предоставляет специализированный мост для таких ИИ-клиентов, как Claude Desktop и Cursor, обеспечивающий доступ к детерминированным расчетам для финансового планирования в США. Этот MCP server выступает в роли транспортного уровня, который перенаправляет запросы к хостинговому Numeratica API, гарантируя, что вся логика вычислений остается централизованной и точной. Он позволяет пользователям выполнять сложные задачи, такие как симуляции Монте-Карло для пенсионных накоплений, расчет налогов, оценку RMD, планирование социального обеспечения и конвертацию Roth.
Пользователи могут запустить сервер немедленно через npx без предварительной настройки, чтобы просмотреть каталог доступных инструментов в режиме только для ознакомления (discovery-only mode). Для выполнения реальных финансовых расчетов необходимо передать NUMERATICA_API_KEY через переменную окружения. Сервер спроектирован без зависимостей во время выполнения, используя встроенные возможности Node fetch и readline для обеспечения минимального веса. Он функционирует как тонкая связующая нить между вашим локальным MCP клиентом и удаленным эндпоинтом API.
Что вы можете с ним делать
- 1Симуляция пенсионных сценариевПопросите ИИ провести симуляцию Монте-Карло для конкретного пенсионного возраста и текущего возраста.
- 2Изучение доступных финансовых инструментовИспользуйте режим только для ознакомления, чтобы увидеть полный список из семидесяти шести доступных инструментов без необходимости использования API key.
- 3Расчет сложных налоговых обязательствЗапрашивайте специфические расчеты для финансового планирования, включая налоги, RMD и социальное обеспечение, через интерфейс ИИ.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Numeratica MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Numeratica MCP в Claude Code
$ claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcpУстановка Numeratica MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Установка Numeratica MCP в VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Установка Numeratica MCP в VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@numeratica/mcp"],"env":{"NUMERATICA_API_KEY":"<YOUR_NUMERATICA_API_KEY>"}}'Установка Numeratica MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Установка Numeratica MCP в Codex
$ codex mcp add mcp --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' -- npx -y @numeratica/mcpУстановка Numeratica MCP в 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>"
Установка Numeratica MCP в Gemini CLI
$ gemini mcp add -s user -e 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp npx -- -y @numeratica/mcpУстановка Numeratica MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Конфигурация
NUMERATICA_API_KEYОбязательноСекретNumeratica 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.
| Название | Описание | Тип |
|---|---|---|
| NUMERATICA_API_KEY | Numeratica API key (nmr_sk_...). Free self-serve key at https://docs.numeratica.com/get-key | ОбязательноСекрет |
| 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. |
Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийnumeratica/mcp is public and reachablegithub.com/numeratica/mcp ↗Пройдено
- Пакет указывает этот репозиторий как источник@numeratica/mcp names numeratica/mcp as sourcenpmjs.com/package/@numeratica/mcp ↗Пройдено
- Происхождение сборки (аттестация Sigstore)Sigstore attestation for @numeratica/mcpnpmjs.com/package/@numeratica/mcp/v/0.1.5#provenance ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-07-28github.com/numeratica/mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @numeratica/mcpПройдено
- Нет критических предупреждений в пакете или его зависимостях1 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPinitialize answered with protocol 2025-06-18 in 100 msПройдено
README
Открыть на 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
Вопросы о Numeratica MCP
Как добавить Numeratica MCP в Claude Code?
Выполните claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Numeratica MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Безопасен ли мой API key?
Да, ключ передается только в заголовке Authorization и никогда не логируется мостом.