Skip to main content

MCP Server

What is MCP?​

MCP (Model Context Protocol) lets AI assistants like Claude, ChatGPT, and Cursor connect directly to your Hiro account. Your AI assistant gets read-only access to your accounts, transactions, balances, holdings, subscriptions, and securities.

Server URL: https://mcp.hirofinance.com

Connecting​

Claude Code​

claude mcp add --transport http hiro https://mcp.hirofinance.com

After running this command, start a new Claude Code session, then run /mcp to connect and authenticate Hiro.

Codex​

codex mcp add hiro --url https://mcp.hirofinance.com

Claude Desktop or Claude.ai​

Settings → Connectors → Add custom connector → enter https://mcp.hirofinance.com → authenticate.

Cursor, Windsurf​

Add to your MCP config file:

{
  "mcpServers": {
    "hiro": {
      "type": "http",
      "url": "https://mcp.hirofinance.com"
    }
  }
}

Config file locations:

  • Cursor: .cursor/mcp.json or ~/.cursor/mcp.json
  • Windsurf: ~/.codeium/windsurf/mcp_config.json

Restart the app after saving, then authenticate when prompted.

ChatGPT (Plus/Pro)​

Settings → Apps → Advanced → enable Developer Mode → Create app → enter https://mcp.hirofinance.com. Then select Developer Mode from the + menu in any conversation.

Authentication​

Log in with your existing Hiro credentials via OAuth. No API keys needed. Your session refreshes automatically.

Things to try​

  • "Pull my last 6 months of spending and build a spreadsheet breaking it down by tax-deductible vs. non-deductible"
  • "Build me an interactive HTML app to explore my spending trends by category and month"
  • "Create a PDF report of my net worth, portfolio allocation, and top spending categories with charts"
  • "Write a script that flags any subscription that's increased in price since I first started paying for it"

Troubleshooting​

  • Session expired: Re-authenticate through your MCP client. In Claude Code, type /mcp.
  • No data: Make sure you have accounts connected in Hiro at app.hirofinance.com.
  • Connection issues: Verify the URL is exactly https://mcp.hirofinance.com — no trailing path.
  • Other issues: Email help@hirofinance.com or use Contact Support in Settings.