io.github.eliaskress/flowcheck

Stripe payouts, Shopify orders, and bank transactions unified for reconciliation and cash flow

E-CommerceTypeScriptv0.2.3

@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

VariableRequiredDescription
FLOWCHECK_API_KEYYesYour FlowCheck API key (fc_live_... or fc_test_...)
FLOWCHECK_BASE_URLNoOverride the API base URL (default: https://developer.usepopup.com/api/v0)

Available tools

ToolParametersDescription
flowcheck_registeremailCreate account (no key needed)
flowcheck_get_registration_statustokenCheck registration / retrieve API key
flowcheck_get_balance—Stripe + bank balances
flowcheck_get_cashflowwindow? (7d, 30d, 90d)Revenue, expenses, net by day
flowcheck_list_payoutsstatus?, from?, to?, limit?, cursor?Stripe payouts with match status
flowcheck_get_payoutidSingle payout with bank match
flowcheck_list_transactionsfrom?, to?, limit?, cursor?Bank transactions from Plaid
flowcheck_list_discrepanciesstatus?, type?, limit?, cursor?Missing or mismatched amounts
flowcheck_get_reconciliation_summary—30-day financial health score
flowcheck_get_reconciliationpayout_idPer-payout reconciliation detail
flowcheck_get_position—Full financial snapshot for AI agents
flowcheck_get_alerts—Active issues and discrepancies
flowcheck_connect_striperestricted_keyConnect Stripe account
flowcheck_create_plaid_link_token—Start Plaid bank connection
flowcheck_exchange_plaid_tokenpublic_tokenComplete Plaid connection
flowcheck_list_webhooks—List webhook endpoints
flowcheck_create_webhookurl, eventsRegister webhook endpoint
flowcheck_delete_webhookidRemove 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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @flowcheck/mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-eliaskress-flowcheck": {
      "command": "npx",
      "args": [
        "-y",
        "@flowcheck/mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@flowcheck/mcp-servernpm

Compatible MCP Clients

io.github.eliaskress/flowcheck works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More