flutter-stripe-mcp

An MCP server that diagnoses Flutter + Stripe (flutter_stripe) setup issues — so Claude can check your project automatically.

What it does

Three tools: one diagnoses your local project setup, and two search GitHub for known issues and their fixes.

diagnose_setup takes the path to your Flutter project root and runs every check:

The result lists passing checks by name and returns a fix instruction for each problem found. Platforms without an android/ or ios/ directory are skipped.

Checking for known issues

Two more tools let Claude check whether a problem is already a documented issue in the flutter_stripe GitHub repo, and read the fix straight from the discussion:

These use GitHub's public search API, which is limited to 60 requests/hour unauthenticated. If you hit the rate limit, the tool returns a clear error instead of failing silently. Optionally, set a GITHUB_TOKEN (or GH_TOKEN) environment variable to raise this to 5,000 requests/hour — no other configuration needed.

Install

pip install flutter-stripe-mcp

Or with uv:

uv tool install flutter-stripe-mcp

Add to Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "flutter-stripe-mcp": {
      "command": "flutter-stripe-mcp"
    }
  }
}

Restart Claude Desktop. Claude will now have access to the diagnostic tool.

Add to Claude Code

claude mcp add flutter-stripe-mcp -- flutter-stripe-mcp

Usage

Ask Claude:

"Check if my Flutter project at /path/to/myapp is set up correctly for flutter_stripe."

Claude calls diagnose_setup with the project root and tells you exactly what to fix.

Development

uv sync
uv run pytest

See DEVELOPMENT.md for running the server locally with MCP Inspector.