io.github.eliaskress/flowcheck
Stripe payouts, Shopify orders, and bank transactions unified for reconciliation and cash flow
Open source Open in the app JSON README (API)
About
Stripe payouts, Shopify orders, and bank transactions unified for reconciliation and cash flow
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- eliaskress
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.2.3
- Last push
- 2026-03-07T20:56:03Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:45
- Updated
- 2026-08-29 03:02:45
- Origin id
io.github.eliaskress/flowcheck
README
# @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