AI-Powered Flame Engine Documentation Assistant

Flame MCP Server is a free, unofficial Model Context Protocol (MCP) server that supercharges your AI coding assistants with comprehensive Flame Engine documentation.

Build Flutter games faster with instant AI-powered answers about:

Flame Components - Game objects, sprites, and entities
Collision Detection - Hitboxes and physics interactions
Rendering & Animation - Sprites, particles, and visual effects
Audio Integration - Sound effects and background music
Game Physics - Forge2D integration and movement
Input Handling - Touch, gestures, and keyboard controls

Why Use Flame MCP Server?

🔍 Natural Language Search

Ask questions in plain English and get instant answers from Flame Engine documentation with relevant code examples

📚 Complete Documentation Access

Access full markdown documentation directly from GitHub with code examples, tutorials, and best practices

🚀 Works Everywhere

Compatible with Claude Desktop, Claude Code, Continue, Windsurf, Cursor, and any MCP-compatible AI assistant

⚡ Instant Setup

No local installation required - just add the URL to your IDE and start coding with AI assistance

🆓 Free Forever

Open access for all developers building Flutter games with Flame Engine

📖 Always Up-to-Date

Documentation fetched directly from Flame's GitHub repository ensures you get the latest information

How to Install Flame MCP Server in Your AI Assistant

Quick 2-Minute Setup: This is a hosted MCP server - no local installation, no Docker, no dependencies. Just copy the configuration for your favorite AI coding assistant below!

Claude Desktop

Add to your Claude Desktop config file:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "flame-docs": {
      "url": "https://flame-mcp.base.al/mcp",
      "transport": "http"
    }
  }
}

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

Claude Code (VS Code Extension)

Use the Claude Code CLI to add the MCP server:

Using CLI (Recommended)

claude mcp add --transport http flame-docs https://flame-mcp.base.al/mcp

Or manually edit settings

Open VS Code Command Palette (Cmd/Ctrl + Shift + P) and search for "Preferences: Open User Settings (JSON)":

{
  "claudeCode.mcpServers": {
    "flame-docs": {
      "url": "https://flame-mcp.base.al/mcp",
      "transport": "http"
    }
  }
}

Or add to project config

Create or edit .claude/config.json in your project:

{
  "mcpServers": {
    "flame-docs": {
      "url": "https://flame-mcp.base.al/mcp",
      "transport": "http"
    }
  }
}

VS Code with Continue Extension

Add to your Continue configuration:

~/.continue/config.json

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "http",
          "url": "https://flame-mcp.base.al/mcp"
        }
      }
    ]
  }
}

Windsurf IDE

Windsurf has built-in MCP support for Flutter/Dart development:

Open Windsurf Settings
Navigate to AI Assistant > MCP Servers
Add new server with HTTP transport:

{
  "name": "flame-docs",
  "transport": "http",
  "url": "https://flame-mcp.base.al/mcp"
}

Or edit ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "flame-docs": {
      "url": "https://flame-mcp.base.al/mcp",
      "transport": "http"
    }
  }
}

Cursor IDE

Configure MCP in Cursor settings:

Open Cursor Settings (Cmd/Ctrl + ,)
Search for "MCP Servers"
Add new server configuration:

{
  "mcp": {
    "servers": {
      "flame-docs": {
        "url": "https://flame-mcp.base.al/mcp",
        "transport": "http"
      }
    }
  }
}

After Installation

Save the configuration file
Restart your IDE or reload the window
Look for MCP indicators or tools in your AI assistant
Try asking: "Show me Flame documentation sections"

Available Tools

search_flame_docs - Search through Flame documentation with keywords
get_flame_doc_page - Retrieve a specific documentation page by path
list_flame_doc_sections - List all available documentation sections

Documentation Coverage

Flame Core: Game structure, Components, Input, Camera, Effects, Collision, Rendering
Bridge Packages: Audio, Physics (Forge2D), Animations (Rive, Lottie), State Management (Bloc, Riverpod)
Tutorials: Bare Flame Game, Klondike, Space Shooter, and more

Example Queries

Try asking your AI assistant:

"How do I implement collision detection in Flame?"
"Show me Flame documentation about sprite animations"
"What components are available in Flame?"
"How do I add audio to my Flame game?"
"Explain the Flame Component System"
"Show me a tutorial for building a Flame game"

API Endpoints

GET / - This landing page
GET /health - Server health check
POST /mcp - MCP Streamable HTTP transport endpoint