finpy-mcp

Finpy MCP Server — Manage cap tables, deals, holdings, and financials through AI conversation.

Connect your favorite AI tool (Claude Desktop, Cursor, VS Code, Claude Code) to the Finpy platform and work with your financial data through natural language.

Features

• 76 asset management tools plus 13 Factor Markets tools (89 total)
• Cap table management — stakeholders, funding rounds, securities, transactions
• Deal flow — create deals, express interest, execute fundraising rounds
• Portfolio tracking — holdings, valuations, performance metrics (IRR, MOIC, TVPI)
• Financial reporting — income statements, balance sheets, cash flow statements
• Secure — OAuth device flow login, credentials stored locally, no passwords sent to AI

Quick Start

1. Install

pip install finpy-mcp

Or with uv:

# Install uv (if not already installed)
brew install uv

# Add uv tools to PATH (one-time setup)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Install finpy-mcp
uv tool install finpy-mcp

Already installed? Update:

pip install --upgrade finpy-mcp
# or
uv tool upgrade finpy-mcp

2. Login

finpy-cli login

Opens your browser automatically. Sign in on the Finpy web app, then return to your terminal.

3. Configure your AI client

Claude Desktop — Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "finpy": {
      "command": "finpy-mcp"
    }
  }
}

Cursor — Edit .cursor/mcp.json:

{
  "mcpServers": {
    "finpy": {
      "command": "finpy-mcp"
    }
  }
}

Claude Code:

claude mcp add finpy -- finpy-mcp

Restart your AI client after configuring.

4. Start talking

Open a new conversation and say:

• "List my entities"
• "Show me the cap table for Nexotype"
• "Create a stakeholder John Doe as limited partner with 8% preferred return"
• "Create an income statement for 2026 with $1M revenue"

Available Tools (89)

Asset Manager tools are stateless: discover IDs with list_organizations() / list_entities(), then pass entity_id (and organization_id for create_entity) explicitly to each tool. There is no set_context — scope is an argument on every call. Every write tool also accepts an optional organization_id, the organization you are acting as: pass it when you belong to more than one, since a shared entity can grant you a different role per organization. For the full per model capability map (which operations are exposed, and why some are web only), see documentation/capability-matrix.md.

CLI Commands

finpy-cli login          # Login via browser (OAuth device flow)
finpy-cli login --basic  # Login with email/password (headless fallback)
finpy-cli logout         # Delete stored credentials
finpy-cli status         # Show auth status

Security

• Passwords never reach the AI — login happens in your browser
• Credentials stored locally in ~/.finpy/credentials.json (chmod 600)
• Automatic token refresh on expiry
• Delete is a soft delete only: the row is kept and can be restored from the web Trash page. MCP exposes delete on 8 leaf records without side effects (destructiveHint set); ledgers are reversed, never deleted. See documentation/capability-matrix.md.
• All API validations, permissions, and audit logging apply

Requirements

• Python 3.12+
• A Finpy account

Links

• Finpy Platform
• PyPI Package