Skip to Content

MCP Server

DriftGrid includes a Model Context Protocol (MCP) server that lets AI agents interact with the grid programmatically.

Starting the Server

npm run mcp

The MCP server connects to http://localhost:3000 by default. Set DRIFTGRID_URL to override.

Available Tools

ToolPurpose
get_current_viewWhat the designer is currently viewing (client, project, concept, version)
get_manifestFull project manifest (concepts, versions, rounds)
create_versionDrift up — create a new version slot
branch_conceptDrift right — create a new concept column
create_projectScaffold a new project
get_feedbackRead prompts/annotations on a version
add_feedbackReply to a prompt (threaded conversation)
close_roundFinalize a round with selected versions
create_roundStart a new round from selections
get_round_baselineRead approved versions from a closed round

Connecting to Claude Code

The MCP server is designed to work with Claude Code’s MCP protocol. When running, Claude can:

  1. See what you’re viewing in the grid
  2. Create new versions and concepts
  3. Read and reply to your prompts
  4. Manage rounds

Without MCP

DriftGrid works fully without MCP. You can:

  • Copy prompts to clipboard and paste them into your agent
  • Have your agent write HTML files directly
  • Use Claude Code’s built-in file editing (it reads CLAUDE.md for conventions)

MCP adds real-time awareness — the agent knows what you’re looking at and can respond to prompts automatically.

Last updated on