# @flowcheck/mcp-server

MCP server for the [FlowCheck API](https://developer.usepopup.com) — give Claude, Cursor, or any MCP client access to your Stripe payouts and bank transactions.

## Setup

### Claude Code

```bash
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`:

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

### Cursor

Add to your `.cursor/mcp.json`:

```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](https://developer.usepopup.com) to get your API key. 7-day free trial with 100 credits included.

## License

MIT