Numeratica MCP server
✓ 인증됨은퇴 Monte Carlo 시뮬레이션, 세금, RMD, Social Security를 포함한 결정론적 미국 재무 계획 계산을 AI 클라이언트에서 수행할 수 있습니다.
다른 이름 numeratica/mcp, mcp, @numeratica/mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.1.5
- 마지막 커밋
- 2026년 7월 28일
- 라이선스
- MIT
Numeratica MCP란?
Numeratica은(는) MCP server입니다. 은퇴 Monte Carlo 시뮬레이션, 세금, RMD, Social Security를 포함한 결정론적 미국 재무 계획 계산을 AI 클라이언트에서 수행할 수 있습니다.
프로젝트 README에서 생성된 요약
Numeratica MCP server 정보
Numeratica는 Claude Desktop 및 Cursor와 같은 AI 클라이언트가 결정론적 미국 재무 계획 계산에 접근할 수 있도록 전문화된 브릿지를 제공합니다. 이 MCP server는 요청을 호스팅된 Numeratica API로 전달하는 전송 계층 역할을 하며, 모든 계산 로직이 중앙 집중화되고 정확하게 유지되도록 보장합니다. 사용자는 은퇴 Monte Carlo 시뮬레이션, 세금 계산, RMD 평가, Social Security 계획 및 Roth 전환과 같은 복잡한 작업을 수행할 수 있습니다.
사용자는 별도의 초기 설정 없이 npx를 사용하여 서버를 즉시 실행하고 discovery-only 모드에서 사용 가능한 도구 카탈로그를 탐색할 수 있습니다. 실제 재무 계산을 실행하려면 환경 변수를 통해 NUMERATICA_API_KEY를 제공해야 합니다. 이 서버는 런타임 종속성이 없도록 설계되었으며, 내장된 Node fetch 및 readline 기능을 활용하여 가벼운 상태를 유지합니다. 로컬 MCP 클라이언트와 원격 API 엔드포인트 사이를 연결하는 얇은 와이어 역할을 수행합니다.
활용 사례
- 1은퇴 시나리오 시뮬레이션AI에게 특정 은퇴 연령과 현재 연령에 대한 Monte Carlo 시뮬레이션을 수행하도록 요청합니다.
- 2사용 가능한 재무 도구 탐색discovery-only 모드를 사용하여 API key 없이도 사용 가능한 76개의 전체 도구 목록을 확인합니다.
- 3복잡한 세금 의무 계산AI 인터페이스를 통해 세금, RMD, Social Security를 포함한 특정 재무 계획 계산을 요청합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Numeratica MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Numeratica MCP 설치
$ claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcpCursor에 Numeratica MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}VS Code에 Numeratica MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}VS Code CLI에 Numeratica MCP 설치
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@numeratica/mcp"],"env":{"NUMERATICA_API_KEY":"<YOUR_NUMERATICA_API_KEY>"}}'Claude Desktop에 Numeratica MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}Codex에 Numeratica MCP 설치
$ codex mcp add mcp --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' -- npx -y @numeratica/mcpCodex config.toml에 Numeratica MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@numeratica/mcp"] [mcp_servers.mcp.env] NUMERATICA_API_KEY = "<YOUR_NUMERATICA_API_KEY>"
Gemini CLI에 Numeratica MCP 설치
$ gemini mcp add -s user -e 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp npx -- -y @numeratica/mcpGemini settings.json에 Numeratica MCP 설치
~/.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. |
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능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 ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스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통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize 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 헤더를 통해서만 전송되며 브릿지에서 로그로 남기지 않습니다.