Skip to main content
Glama
finpilot-mcp

finpilot-mcp

by coolksrini

FinPilot MCP Server

AI Financial Co-Pilot for Claude Desktop and VS Code

MCP server providing financial analysis capabilities through the Model Context Protocol. Requests flow through the FinPilot Auth Service, which validates credentials and routes to the private orchestrator.

Features

  • Native integration with Claude Desktop and VS Code

  • Zero-config guest mode — stateless calculation tools work without an account

  • Authenticated mode — full personal finance tools (credit reports, portfolio, LAMF)

  • Cloud-powered analysis (no local computation required)

Related MCP server: trading-skills

Claude Desktop Setup

Edit Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Zero-config (guest mode — stateless tools only)

No account or API key needed. Stateless calculation tools (loan optimizer, APR calculator, etc.) work out of the box. Personal finance tools (credit report analysis, portfolio) require sign-in.

{
  "mcpServers": {
    "finpilot": {
      "command": "uv",
      "args": ["run", "finpilot-mcp"]
    }
  }
}

Authenticated (full access)

Generate an fp_ API key from myfinpilot.io → Settings → API Tokens, then add it here:

{
  "mcpServers": {
    "finpilot": {
      "command": "uv",
      "args": ["run", "finpilot-mcp"],
      "env": {
        "FINPILOT_GATEWAY_URL": "https://<auth-service>.run.app",
        "FINPILOT_API_KEY": "fp_your_token_here"
      }
    }
  }
}

Restart Claude Desktop after editing.

Environment Variables

Variable

Default

Description

FINPILOT_GATEWAY_URL

http://localhost:8080

Auth Service URL

FINPILOT_API_KEY

(none)

API key (fp_...). Omit for guest mode.

Command Line Usage

# Guest mode (zero-config)
uv run finpilot-mcp

# Authenticated mode
FINPILOT_GATEWAY_URL=https://<auth-service>.run.app \
FINPILOT_API_KEY=fp_your_token_here \
uv run finpilot-mcp

# HTTP mode (for local testing)
uv run finpilot-mcp --mode http --port 8002

CLI Options:

  • --mode — Transport mode: stdio (default) or http

  • --host — HTTP server host (default: 0.0.0.0)

  • --port — HTTP server port (default: 8002)

  • --reload — Enable auto-reload for development

Available Tools

Credit Analysis

  • analyze_credit_report — Analyze CIBIL/Experian/Equifax reports

  • get_credit_health — Credit health summary

Portfolio Analysis

  • analyze_portfolio — Analyze CAS statements or portfolio data

Loan Optimization

  • optimize_loans — LAMF and refinancing recommendations

Financial Planning

  • create_financial_plan — Goal-based financial planning

Architecture

┌─────────────────────────────────────┐
│  Claude Desktop / VS Code           │
└────────────┬────────────────────────┘
             │ MCP Protocol (STDIO)
             ▼
┌─────────────────────────────────────┐
│  finpilot-mcp (This Package)        │
│  - Lightweight MCP wrapper          │
│  - Optional FINPILOT_API_KEY auth   │
│  - No business logic                │
└────────────┬────────────────────────┘
             │ HTTPS + optional Bearer token
             ▼
┌─────────────────────────────────────┐
│  Auth Service (Public entry point)  │
│  - Token validation / guest assign  │
│  - In-process rate limiting         │
│  - Injects X-User-* headers         │
└────────────┬────────────────────────┘
             │ SA identity token (private)
             ▼
┌─────────────────────────────────────┐
│  Orchestrator (Private Cloud Run)   │
│  - Multi-agent ADK orchestration    │
│  - Business logic & algorithms      │
└─────────────────────────────────────┘

Development

# Install dependencies
cd backend/finpilot-mcp
uv sync

# Run in HTTP mode for local testing
FINPILOT_GATEWAY_URL=http://localhost:8080 \
uv run finpilot-mcp --mode http --port 8002

# Run tests
uv run pytest

Security

  • All API communication over HTTPS

  • API keys via environment variables only

  • No sensitive data stored locally

  • Secrets never in CLI arguments or code

License

MIT License

Available Tools

5 tools
analyze_credit_reportB

Analyze credit report from CIBIL, Experian, or Equifax.

Inputs: file_path (required), dob, name, bureau, +2 more. Returns: object

analyze_portfolioB

Analyze investment portfolio from a CAS PDF or direct data.

Inputs: dob, pan, password, file_path, +1 more. Returns: object

create_financial_planB

Create comprehensive financial plan based on goals and current situation.

Inputs: goals (required), current_situation (required), user_id. Returns: object

get_credit_healthC

Get current credit health summary.

Inputs: user_id. Returns: object

optimize_loansC

Get loan optimization recommendations.

Inputs: loans, user_id, portfolio_data. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 5 tools

    Disambiguation4/5

    Tools cover distinct financial domains: credit health, credit report analysis, portfolio analysis, loan optimization, and financial planning. The pair get_credit_health and analyze_credit_report have slight overlap but are differentiated by scope (summary vs. detailed report).

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (get_, analyze_, optimize_, create_), using present tense verbs and clear nouns.

    Tool Count5/5

    With 5 tools, the server is well-scoped for a personal finance assistant, covering key areas without being bloated or too sparse.

    Completeness3/5

    Core personal finance areas are covered (credit, portfolio, loans, planning), but missing potentially important features like budgeting, expense tracking, or tax planning, which are common in financial tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-powered personal finance analysis through Claude AI using Plaid integration, enabling natural language queries about transactions, subscriptions, budgets, and spending trends.
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Provides 32 trading analysis tools for AI-powered market analysis, including real-time data, technical indicators, options Greeks, scanners, and Interactive Brokers portfolio management, all accessible via natural language in Claude Desktop.
      36
      412
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides live commercial real estate data (rates, demographics) and analysis tools (DCF, rent roll parsing, lease abstraction, IC memo generation) within Claude Desktop.
      1
      MIT