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/mcpClaude Code will open your browser for authentication. After logging in, the MCP server is connected and all 17 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:
- Discovers auth endpoints via
/.well-known/oauth-authorization-server - Opens your browser for Auth0 login
- Receives an access token automatically
- Uses the token for all subsequent requests
No manual token management required.
Available Tools (17)
Read
| Tool | Description |
|---|---|
search_rfcs | Search RFCs by query text |
get_rfc | Get full RFC by number or UUID |
list_rfcs | List RFCs with status/pagination filters |
get_active_decisions | Recently accepted/implementing RFCs |
list_projects | List projects in current org |
list_templates | List RFC templates |
Write
| Tool | Description |
|---|---|
create_rfc | Create a new RFC draft |
update_rfc | Update title, content, summary, tags |
transition_rfc | Change status (draft, in_review, accepted, etc.) |
update_rfc_visibility | Set public, org_only, or private |
delete_rfc | Delete an RFC |
create_project | Create a new project |
AI
| Tool | Description |
|---|---|
ask_decisions | Answer “why did we choose X?” from recorded decisions, with numbered citations. Counts against the monthly question limit. |
get_ai_findings | List AI pre-review findings for an RFC (open, dismissed or all). Not metered. |
Organization
| Tool | Description |
|---|---|
get_current_org | Show which org is active |
list_orgs | List all your organizations |
switch_org | Change 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”
- “Why did we choose NATS over Kafka?”
- “What will reviewers flag on RFC-12?”
Ask your decisions
ask_decisionsanswers a question such as “why did we choose NATS over Kafka?” using only your recorded decisions, and lists the RFC number, status and section behind each numbered citation. Pass rfc to focus on one decision and its related ones. If nothing on record answers the question, the tool says so and suggests search_rfcs. get_ai_findings returns the pre-review findings for a decision. A read-only API key can call both. When the monthly question limit is reached the tool reports the limit and its reset date; fall back to search_rfcs and get_rfc. See AI review and Ask.