@flowcheck/mcp-server

MCP server for the FlowCheck API — give Claude, Cursor, or any MCP client access to your Stripe payouts and bank transactions.

Setup

Claude Code

Terminal

claude mcp add flowcheck \
  --transport stdio \
  --env FLOWCHECK_API_KEY=fc_live_... \
  -- npx -y @flowcheck/mcp-server

Claude Desktop

Add to your claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "flowcheck": {
      "command": "npx",
      "args": ["-y", "@flowcheck/mcp-server"],
      "env": {
        "FLOWCHECK_API_KEY": "fc_live_..."
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

config.json

{
  "mcpServers": {
    "flowcheck": {
      "command": "npx",
      "args": ["-y", "@flowcheck/mcp-server"],
      "env": {
        "FLOWCHECK_API_KEY": "fc_live_..."
      }
    }
  }
}

Environment variables

Variable	Required	Description
`FLOWCHECK_API_KEY`	Yes	Your FlowCheck API key (`fc_live_...` or `fc_test_...`)
`FLOWCHECK_BASE_URL`	No	Override the API base URL (default: `https://developer.usepopup.com/api/v0`)

Available tools

Tool	Parameters	Description
`flowcheck_register`	`email`	Create account (no key needed)
`flowcheck_get_registration_status`	`token`	Check registration / retrieve API key
`flowcheck_get_balance`	—	Stripe + bank balances
`flowcheck_get_cashflow`	`window?` (7d, 30d, 90d)	Revenue, expenses, net by day
`flowcheck_list_payouts`	`status?`, `from?`, `to?`, `limit?`, `cursor?`	Stripe payouts with match status
`flowcheck_get_payout`	`id`	Single payout with bank match
`flowcheck_list_transactions`	`from?`, `to?`, `limit?`, `cursor?`	Bank transactions from Plaid
`flowcheck_list_discrepancies`	`status?`, `type?`, `limit?`, `cursor?`	Missing or mismatched amounts
`flowcheck_get_reconciliation_summary`	—	30-day financial health score
`flowcheck_get_reconciliation`	`payout_id`	Per-payout reconciliation detail
`flowcheck_get_position`	—	Full financial snapshot for AI agents
`flowcheck_get_alerts`	—	Active issues and discrepancies
`flowcheck_connect_stripe`	`restricted_key`	Connect Stripe account
`flowcheck_create_plaid_link_token`	—	Start Plaid bank connection
`flowcheck_exchange_plaid_token`	`public_token`	Complete Plaid connection
`flowcheck_list_webhooks`	—	List webhook endpoints
`flowcheck_create_webhook`	`url`, `events`	Register webhook endpoint
`flowcheck_delete_webhook`	`id`	Remove webhook endpoint

Example prompts

After connecting the MCP server, try asking:

"What's my current balance across Stripe and my bank?"
"Show me last week's payouts and whether they all landed in my bank"
"Are there any missing deposits or discrepancies?"
"What did we make this month?"
"Give me a financial health summary"

Get an API key

License

MIT