auto_fix_high AI-First · Skill + MCP

Telescope for AI Coding Assistants

Name: Telescope
Author: FlutterSDK

Skill teaches your agent which `telescope_*` tool answers which question. MCP server lets it read the live ring buffers from your running app. One marketplace command in Claude Code wires it all up.

Works with

paste in Claude · other editor ↓

claude · ~/your-flutter-app

connected

verified Skills + MCP server live. Your agent can read your app at runtime.

Read your app at runtime

Local MCP for live telemetry

Telescope ships 9 stdio MCP tools registered into your project's artisan dispatcher. The telescope_* tools (requests, exceptions, queries, dumps, events, gates, caches, tail, clear) stream the live ring buffers from the VM Service of your running Flutter app. Debug-only; release builds tree-shake everything.

build 9 telescope_* tools · folder_open Writes .mcp.json · bolt ./bin/fsa fastcli wrapper, ~110ms warm

chevron_right Or paste the canonical .mcp.json by hand JSON

{
  "mcpServers": {
    "fluttersdk": {
      "command": "./bin/fsa",
      "args": ["mcp:serve"],
      "cwd": "."
    }
  }
}

After edit: /mcp reconnect fluttersdk in Claude Code · Cursor auto-reloads · VS Code reload window. If ./bin/fsa is not scaffolded yet, swap the command for dart run fluttersdk_artisan mcp:serve.

Full per-client matrix (Cursor · VS Code · Continue · Windsurf · Claude Desktop) at telescope/mcp/setup.

Three pieces, one outcome.

Skill at edit time. MCP at runtime. llms.txt on demand.

menu_book

01 · Skill

9 MCP tools, 9 watchers, 9 ring buffers covering HTTP, logs, exceptions, debugPrint, DB queries, and Magic events. Loaded into context before the first run.

hub

02 · MCP server

Streamable HTTP at mcp.fluttersdk.com. One search-docs tool. Public, no auth.

description

03 · llms.txt

Static markdown inventory at /telescope/llms.txt. Some agents auto-fetch and cache it on first contact.

Install Telescope for Claude Code, Cursor, and Codex

Three paths. Pick the one closest to your editor.

Claude Code plugin Recommended

Marketplace install. Skills surface as /fluttersdk:fluttersdk-telescope, etc.

/plugin marketplace add fluttersdk/ai

/plugin install fluttersdk@fluttersdk-marketplace

terminal

npx skills

Universal CLI. Works with 40+ AI coding agents via the Vercel Labs skills package.

npx skills add fluttersdk/ai --skill fluttersdk-telescope

npx skills add fluttersdk/ai -g

install_desktop

Universal installer

Auto-detects every supported tool and registers the MCP server in one pass.

git clone https://github.com/fluttersdk/ai.git && cd ai && bash scripts/install.sh --global --with-mcp

Connect the MCP Server at mcp.fluttersdk.com

One Streamable HTTP endpoint at mcp.fluttersdk.com serves every client. Public, no auth.

Claude Code

claude mcp add --transport http fluttersdk https://mcp.fluttersdk.com

chevron_right stdio fallback

claude mcp add --transport stdio fluttersdk npx @@fluttersdk/mcp

Cursor

{
  "mcpServers": {
    "fluttersdk": { "url": "https://mcp.fluttersdk.com" }
  }
}

Save to .cursor/mcp.json

OpenCode

{
  "mcp": {
    "fluttersdk": {
      "type": "remote",
      "url": "https://mcp.fluttersdk.com",
      "enabled": true
    }
  }
}

Save to opencode.json

VS Code Copilot

{
  "servers": {
    "fluttersdk": { "type": "http", "url": "https://mcp.fluttersdk.com" }
  }
}

Save to .vscode/mcp.json

Codex CLI

[mcp_servers.fluttersdk]
url = "https://mcp.fluttersdk.com"

Add to ~/.codex/config.toml

chevron_right stdio fallback

[mcp_servers.fluttersdk]
command = "npx"
args = ["-y", "@@fluttersdk/mcp"]

Antigravity CLI

{
  "mcpServers": {
    "fluttersdk": {
      "url": "https://mcp.fluttersdk.com"
    }
  }
}

Save to ~/.gemini/config/mcp_config.json

Different client? Cline, Gemini CLI, Roo Code configs at fluttersdk/ai · docs/MCP.md.

description

LLM Inventory Files

Some agents auto-fetch llms.txt at the project URL and load it once into context. Complement to the skill+MCP combo.

open_in_new /telescope/llms.txt open_in_new /telescope/llms-full.txt

Frequently Asked

Do I need both the skill and the MCP server? expand_more

The skill teaches your agent which of the 9 telescope_* tools to reach for at edit time. The MCP server lets it actually query the live ring buffers in your running app at runtime. Install both.

Which AI coding assistants are supported? expand_more

The skill works with 40+ agents via the Vercel Labs skills CLI. The MCP server speaks Streamable HTTP, supported natively by Claude Code, Cursor, OpenCode, VS Code Copilot, and Codex CLI. For stdio-only clients use the npx @fluttersdk/mcp bridge.

Does Telescope run in production? expand_more

No, by design. Every install hook is wrapped in `if (kDebugMode)`; release builds tree-shake the entire telescope branch. The MCP surface only exists when a Flutter debug VM is reachable.

Where do I report a hallucination? expand_more

Open an issue at github.com/fluttersdk/ai with the prompt, the agent, and the model. The skill ships with anti-pattern reminders that get tightened from real reports.

hub