Back to Docs

MCP Server

Give AI agents (Claude Code, Cursor, Windsurf) read and write access to your RFCs.

Quick Setup (Claude Code)

Add the remote MCP server — no install needed:

claude mcp add --transport http designdoc https://mcp.designdoc.tech/mcp

Claude Code will open your browser for authentication. After logging in, the MCP server is connected and all 15 tools are available.

Alternative: Settings File

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "designdoc": {
      "type": "http",
      "url": "https://mcp.designdoc.tech/mcp"
    }
  }
}

Authentication

The MCP server implements OAuth 2.1 with PKCE. When your MCP client first connects, it:

  1. Discovers auth endpoints via /.well-known/oauth-authorization-server
  2. Opens your browser for Auth0 login
  3. Receives an access token automatically
  4. Uses the token for all subsequent requests

No manual token management required.

Available Tools (15)

Read

ToolDescription
search_rfcsSearch RFCs by query text
get_rfcGet full RFC by number or UUID
list_rfcsList RFCs with status/pagination filters
get_active_decisionsRecently accepted/implementing RFCs
list_projectsList projects in current org
list_templatesList RFC templates

Write

ToolDescription
create_rfcCreate a new RFC draft
update_rfcUpdate title, content, summary, tags
transition_rfcChange status (draft, in_review, accepted, etc.)
update_rfc_visibilitySet public, org_only, or private
delete_rfcDelete an RFC
create_projectCreate a new project

Organization

ToolDescription
get_current_orgShow which org is active
list_orgsList all your organizations
switch_orgChange active org

Example Usage

Once connected, you can ask Claude Code things like:

  • “List all RFCs in draft status”
  • “Create an RFC about adding rate limiting to the API”
  • “Show me RFC-003”
  • “Move RFC-005 to in_review”
  • “Search for RFCs about authentication”
  • “Switch to the outfii org and list projects”