@flarelink/mcp

An MCP server that teaches your AI coding tool to build correctly on the Flarelink stack — Cloudflare auth (better-auth + KV sessions), D1, and R2 — from inside Cursor, Claude Code, Windsurf, and anything else that speaks MCP.

It hands the agent the security and cost rules up front (user-scoping, identifier-safe SQL, KV sessions, presigned R2) so the generated code is right the first time, instead of the agent guessing and you debugging.

Install

No install needed — run it with npx. Add it to your tool's MCP config:

Claude Code

claude mcp add flarelink -- npx -y @flarelink/mcp

Cursor / Windsurf / Claude Desktop (mcp.json / config):

{
  "mcpServers": {
    "flarelink": {
      "command": "npx",
      "args": ["-y", "@flarelink/mcp"],
      "env": { "FLARELINK_API_KEY": "flk_…" }
    }
  }
}

The FLARELINK_API_KEY is optional. Without it you still get all the knowledge + scaffolding tools. With it, the management tools (below) can drive your actual Flarelink projects. Mint a key at dash.flarelink.dev → API keys.

Tools

| Tool | What it gives the agent | | --- | --- | | flarelink_stack_overview | The stack, cardinal rules, and deployment shapes. Read first. | | flarelink_scaffold | How to bootstrap a complete working app (clone / one-click deploy) + file map. | | flarelink_list_patterns | The catalog of canonical code patterns. | | flarelink_get_pattern | Copy-pasteable code for one recipe (auth setup, route guards, identifier-safe D1, R2 upload/presign, wrangler bindings, SDK usage). | | flarelink_sdk_reference | @flarelink/client signatures + return shapes (auth / storage / db). | | flarelink_cost_patterns | Cloudflare cost-optimization guidance, with targeted hints for the feature you describe. |

It also exposes the stack guide as a resource (flarelink://stack-guide) you can attach as context.

Management tools (need FLARELINK_API_KEY)

Drive your actual Flarelink projects from the editor. These route through the Flarelink dashboard API and act exactly as you would in the UI.

| Tool | What it does | | --- | --- | | flarelink_whoami | Verify the key; show the user + active connection/project. | | flarelink_list_projects | List projects on the active Cloudflare connection. | | flarelink_list_databases | List the project's D1 databases. | | flarelink_query_database | Run a (parameterized) SQL statement against a project D1. | | flarelink_list_buckets | List the project's R2 buckets. |

Without a key they return a clear "set FLARELINK_API_KEY" message. The key has the same access as your Flarelink login — treat it like a password.

License

MIT. Part of Flarelink — the dashboard for the Cloudflare developer stack.