SpecThis

MCP Setup

Connect SpecThis to your AI agent using the Model Context Protocol

What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and tools.

The SpecThis MCP server gives your AI agent the ability to create, read, update, and manage engineering plans, work items, and file changes directly from your conversations. Authentication uses Clerk OAuth — you authenticate through your browser when the MCP server first connects.

Endpoint: https://app.specthis.ai/api/mcp

Available Tools (16)

The MCP server exposes 16 tools organized into five groups:

Plans

Create and manage structured specifications for features, bugs, or refactoring work.

read_plansList and filter plans by status, repository, or search query
upsert_planCreate a new plan or update an existing one
delete_planPermanently delete a plan and its contents

Work Items

Individual tasks within a plan, with descriptions, acceptance criteria, and status.

read_work_itemsList work items for a plan, optionally filtered by status
upsert_work_itemCreate or update a work item within a plan
delete_work_itemRemove a work item from a plan

Changes

File-level changes attached to work items — specify which files to create, modify, or delete.

read_changesList file changes for a work item
upsert_changeCreate or update a file change specification
delete_changeRemove a file change from a work item

Repositories

Link GitHub repositories to plans for context-aware development.

read_repositoriesList repositories available to your organization
read_plan_repositoriesList repositories linked to a specific plan
link_plan_repositoryAssociate a repository with a plan
unlink_plan_repositoryRemove a repository association from a plan

Plan Structure

Organize work items into a hierarchical structure for complex features.

read_plan_structureGet the hierarchical structure of a plan
upsert_plan_structure_itemAdd or update a node in the plan structure
delete_plan_structure_itemRemove a node from the plan structure

Configuration Requirements

All MCP server configurations require:

  • API URL: https://app.specthis.ai/api/mcp
  • Authentication: Clerk OAuth — you must be logged into your SpecThis account in your browser. The MCP server opens a browser window for authentication on first connection.

Choose Your AI Agent

Select your AI agent to view setup instructions:

Claude Code

Anthropic's CLI tool for AI-powered coding

Setup Guide →

Cursor

AI-powered code editor with integrated MCP support

Setup Guide →

Codex

OpenAI's code generation tool with MCP integration

Setup Guide →

Next Steps

After setting up the MCP server:

  • Ask your AI agent to create a plan — for example, "Create a plan for adding user authentication to my app"
  • Visit My Work to view and manage your plans in the dashboard
  • Link your GitHub repositories to enable repository-aware planning
  • Email us at support@specthis.ai if you need help