finpilot-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@finpilot-mcp optimize my loan portfolio for refinancing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.jsonWindows:
%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 |
|
| Auth Service URL |
| (none) | API key ( |
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 8002CLI Options:
--mode— Transport mode:stdio(default) orhttp--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 reportsget_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 pytestSecurity
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 toolsanalyze_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
Scored across 5 tools
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).
All tool names follow a consistent verb_noun pattern (get_, analyze_, optimize_, create_), using present tense verbs and clear nouns.
With 5 tools, the server is well-scoped for a personal finance assistant, covering key areas without being bloated or too sparse.
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
Related MCP Connectors
Your investing research inside Claude: watchlists, financial ratios, reverse-DCF valuations, investment theses, notes, portfolio, earnings calendar and news for the companies you follow. 70 read and write tools; ask what's on your morning desk, rank a watchlist by ROE, log a trade or save a thesis. OAuth sign-in. Free to start.
Connect AI agents to financial institution origination, analytics, and compliance workflows.
Not another dashboard. A wealth analyst for every asset a bank can't sync, inside Claude.
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAI-powered personal finance analysis through Claude AI using Plaid integration, enabling natural language queries about transactions, subscriptions, budgets, and spending trends.1MIT
- AlicenseBqualityBmaintenanceProvides 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.36412MIT
- AlicenseNot gradedqualityDmaintenanceProvides live commercial real estate data (rates, demographics) and analysis tools (DCF, rent roll parsing, lease abstraction, IC memo generation) within Claude Desktop.1MIT
- FlicenseBqualityDmaintenanceEnables comprehensive financial analysis including structured products, portfolio optimization, risk analytics, and backtesting through Claude Desktop integration.181-