README.md
Access your Stripe payouts and bank transactions via MCP
@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
Tools (18)
flowcheck_registerCreate accountflowcheck_get_registration_statusCheck registration / retrieve API keyflowcheck_get_balanceStripe + bank balancesflowcheck_get_cashflowRevenue, expenses, net by dayflowcheck_list_payoutsStripe payouts with match statusflowcheck_get_payoutSingle payout with bank matchflowcheck_list_transactionsBank transactions from Plaidflowcheck_list_discrepanciesMissing or mismatched amountsflowcheck_get_reconciliation_summary30-day financial health scoreflowcheck_get_reconciliationPer-payout reconciliation detailflowcheck_get_positionFull financial snapshot for AI agentsflowcheck_get_alertsActive issues and discrepanciesflowcheck_connect_stripeConnect Stripe accountflowcheck_create_plaid_link_tokenStart Plaid bank connectionflowcheck_exchange_plaid_tokenComplete Plaid connectionflowcheck_list_webhooksList webhook endpointsflowcheck_create_webhookRegister webhook endpointflowcheck_delete_webhookRemove webhook endpointEnvironment Variables
FLOWCHECK_API_KEYrequiredYour FlowCheck API keyFLOWCHECK_BASE_URLOverride the API base URLConfiguration
claude_desktop_config.json
{"mcpServers": {"flowcheck": {"command": "npx", "args": ["-y", "@flowcheck/mcp-server"], "env": {"FLOWCHECK_API_KEY": "fc_live_..."}}}}Try it
→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