Agent Setup
Domscribe works with any MCP-compatible coding agent. It exposes 12 tools and 4 prompts via the Model Context Protocol (MCP). Agent plugins bundle the MCP server configuration and a skill file that teaches the agent how to use Domscribe tools effectively.
The fastest way to connect your agent is through the setup wizard:
npx domscribe init
The wizard detects your agent and installs the plugin automatically. If you prefer manual setup, pick your agent below.
Supported Agents
| Agent | Setup |
|---|---|
| Claude Code | Plugin marketplace install |
| GitHub Copilot | CLI plugin install |
| Gemini CLI | Extensions install |
| Amazon Kiro | Powers panel |
| Cursor | Cursor Directory |
| Any MCP-compatible agent | Manual MCP config + skills |
What Gets Installed
Each agent plugin installs two things:
- MCP server configuration -- tells the agent how to launch the
@domscribe/mcpserver process via stdio. - Skill file -- a set of instructions that teaches the agent how to use the 12 Domscribe tools effectively, including when to query runtime state, how to process annotations, and how to interpret the responses.
MCP Tools
Domscribe exposes the following tools to your agent:
| Tool | Description |
|---|---|
domscribe.query.bySource | Query a source file + line and get live runtime context (props, state, DOM snapshot) |
domscribe.manifest.query | Find manifest entries by file path, component name, or element ID |
domscribe.manifest.stats | Manifest coverage statistics |
domscribe.resolve | Resolve a data-ds element ID to its source location |
domscribe.resolve.batch | Resolve multiple element IDs in one call |
domscribe.annotation.process | Atomically claim the next queued annotation |
domscribe.annotation.respond | Attach agent response and transition to PROCESSED |
domscribe.annotation.updateStatus | Manually transition annotation status |
domscribe.annotation.get | Retrieve annotation by ID |
domscribe.annotation.list | List annotations with status/filter options |
domscribe.annotation.search | Full-text search across annotation content |
domscribe.status | Relay daemon health, manifest stats, queue counts |