@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

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:

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

Cursor

Add to your .cursor/mcp.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

Sign up at developer.usepopup.com to get your API key. 7-day free trial with 100 credits included.

License

MIT