Firma App MCP Server

by evan-moonio.github.evan-moon/firmav0.4.2

Local-first portfolio tracker for overseas investors. Claude reads and writes your finances via MCP.

Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing6mo ago

Install Firma App MCP server

claude mcp add firma-app -e FINNHUB_API_KEY='<finnhub-api-key>' -- npx -y firma-app

{
  "mcpServers": {
    "firma-app": {
      "command": "npx",
      "args": [
        "-y",
        "firma-app"
      ],
      "env": {
        "FINNHUB_API_KEY": "<finnhub-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "firma-app": {
      "command": "npx",
      "args": [
        "-y",
        "firma-app"
      ],
      "env": {
        "FINNHUB_API_KEY": "<finnhub-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "firma-app": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "firma-app"
      ],
      "env": {
        "FINNHUB_API_KEY": "<finnhub-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "firma-app": {
      "command": "npx",
      "args": [
        "-y",
        "firma-app"
      ],
      "env": {
        "FINNHUB_API_KEY": "<finnhub-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
FINNHUB_API_KEY	—	yes	Finnhub API key for stock price sync and market data. Get a free key at finnhub.io. Alternatively set via: firma config set finnhub-key <key>

Freshness

Slowing — last maintenance signal 6mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-04-25 · 6mo ago · official registry · v0.4.2

FAQ

›How do I install the Firma App MCP server in Claude Code?

Run: claude mcp add firma-app -e FINNHUB_API_KEY='<finnhub-api-key>' -- npx -y firma-app. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Firma App require an API key?

Yes. It expects FINNHUB_API_KEY, of which 1 is a secret.

›Can I use Firma App as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Firma App in the official MCP registry?

Yes, as io.github.evan-moon/firma.