Workflows
Any MCP-Compatible IDE
Set up Stable Baseline's MCP server in any IDE or AI agent that supports the Model Context Protocol to automatically generate and maintain living documentation for your codebase.
Have a specific IDE? We have dedicated setup guides for Cursor, VS Code, Windsurf, OpenCode, Claude Code, Warp, OpenAI Codex, and Antigravity.
What You'll Get
MCP Tools
Full access to Stable Baseline's documentation tools directly in your IDE's AI agent
Bespoke Documentation
AI-generated docs tailored to your specific codebase and architecture
AGENTS.md Integration
Auto-sync rules injected into your AGENTS.md so your AI agent keeps docs updated
Project Configuration
Workspace, project, and folder structure created in Stable Baseline automatically
Step 1: Add the MCP Server
Before you begin, you'll need a Stable Baseline API key. Visit the MCP Setup Guide to create one from your workspace settings.
MCP Server Details
| Server Name | stablebaseline-mcp |
| Transport | Streamable HTTP |
| Endpoint URL | https://api.stablebaseline.io/functions/v1/cloud-serve/mcp |
| Auth Header | Authorization: Bearer YOUR_API_KEY |
Choose the configuration format that matches your IDE:
Format A: JSON with mcpServers
(Cursor, Warp, Antigravity, Claude Desktop)
{
"mcpServers": {
"stablebaseline-mcp": {
"url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Format B: JSON with servers
(VS Code GitHub Copilot)
{
"servers": {
"stablebaseline-mcp": {
"type": "http",
"url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Format C: JSON with serverUrl
(Windsurf)
{
"mcpServers": {
"stablebaseline-mcp": {
"serverUrl": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Format D: TOML
(OpenAI Codex)
[mcp_servers.stablebaseline-mcp]
url = "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp"
bearer_token_env_var = "STABLE_BASELINE_API_KEY"
http_headers = {}
enabled = trueFormat E: Claude Code (CLI)
claude mcp add stablebaseline-mcp \ --transport http \ --url "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp" \ --header "Authorization: Bearer YOUR_API_KEY"
Format F: OpenCode (YAML)
mcp:
stablebaseline-mcp:
type: remote
url: https://api.stablebaseline.io/functions/v1/cloud-serve/mcp
headers:
Authorization: Bearer YOUR_API_KEYFormat G: Stdio Bridge Fallback (Any IDE)
If your IDE only supports stdio MCP servers, use the mcp-remote npm package as a bridge:
{
"mcpServers": {
"stablebaseline-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}Note: The stdio bridge requires Node.js. The mcp-remote package is downloaded automatically via npx. Replace YOUR_API_KEY with your actual Stable Baseline API key.
Step 2: Generate Your Documentation
Once the MCP server is connected, open your IDE's AI chat/agent and type:
Run the sb-setup prompt from the stablebaseline-mcp server
The AI agent will walk you through an interactive setup process to generate documentation for your project.
What it does
The sb-setup prompt runs a 9-step process:
- Verifies MCP Connection — Confirms the Stable Baseline server is reachable and authenticated
- Resolves Workspace & Project — Finds or creates your Stable Baseline workspace and project
- Scans Your Codebase — Analyzes project structure, tech stack, dependencies, and architecture
- Checks for Existing Docs — Detects if documentation already exists in Stable Baseline and offers to augment, replace, or cancel
- Creates Folder Structure — Organizes documentation into logical folders matching your codebase
- Generates Documents — Writes comprehensive docs for each area of your codebase
- Adds Diagrams — Creates architecture and flow diagrams using Mermaid, PlantUML, or other supported formats
- Configures AGENTS.md — Adds auto-sync rules to your project's AGENTS.md file (augments existing content — never removes what's already there)
- Summary & Next Steps — Provides a summary of everything created with links to view in Stable Baseline
What Gets Documented
Architecture
High-level system design, component relationships, data flow
API & Integrations
Endpoints, external services, authentication flows
Data Model
Database schemas, relationships, migrations
Frontend
Component hierarchy, state management, routing
Backend
Server logic, middleware, business rules
DevOps
Build pipeline, deployment, environment configuration
Auth & Identity
Authentication, authorization, user management
The exact documentation structure is determined dynamically based on your codebase. No two projects get the same output.
How Auto-Sync Works
After setup, your AGENTS.md file will contain rules that tell your AI agent when to update documentation.
| File Pattern | Documentation Impact | Action |
|---|---|---|
| src/components/** | UI components and patterns | Update "Frontend Patterns" |
| src/lib/api/** | API client and integrations | Update "API & Integrations" |
| supabase/migrations/** | Database schema changes | Update "Data Model" |
| src/hooks/** | Custom hooks and state logic | Update "Frontend Patterns" |
Whenever your AI agent modifies files matching these patterns, it will automatically update the corresponding Stable Baseline documentation using the sb-sync prompt.
File Structure
Your Stable Baseline Project
├── Architecture/
│ ├── High Level Overview
│ └── System Architecture Diagram
├── Frontend/
│ ├── Component Hierarchy
│ ├── State Management
│ └── Routing & Navigation
├── Backend/
│ ├── API Endpoints
│ ├── Business Logic
│ └── Middleware & Auth
├── Data Model/
│ ├── Database Schema
│ └── Entity Relationships
└── DevOps/
├── Build & Deploy
└── Environment ConfigThis is an example. Your actual structure will be tailored to your specific project.
Keep Docs Updated Mid-Conversation
After making significant changes during a coding session — architectural decisions, new features, schema changes, key refactors — your agent will typically automatically propose updates to your documentation via the sb-update prompt based on the rules in your AGENTS.md file. Wait for the agent to finish its current coding step, and it will often follow up by running sb-update.
However, you can also manually capture everything in your documentation without leaving the conversation:
Run the sb-update prompt
The sb-update prompt scans the current conversation context, identifies what changed, maps changes to existing documents, and applies targeted patches.
Tip: You don't need to describe what changed when running manually — sb-update infers it from your conversation history.
Try It
Once setup is complete, try these example prompts in your IDE's AI agent:
"Document the authentication flow in our API"
"Add a sequence diagram showing the checkout process"
"Update the database schema docs after the latest migration"
"Create a new doc explaining our caching strategy"
Regenerate Documentation
To regenerate your entire documentation from scratch:
Run the sb-setup prompt from the stablebaseline-mcp server
The setup process will detect existing documentation and ask whether you want to augment (add to existing), replace (start fresh), or cancel.
MCP Compatibility
Stable Baseline's MCP server uses the Streamable HTTP transport and supports:
| Feature | Supported |
|---|---|
| Tools | ✅ Full tool suite for documents, diagrams, images, data files |
| Prompts | ✅ 8 built-in prompts (sb-setup, sb-update, etc.) |
| Resources | ✅ Server info, CDMD guide, diagram types, project hierarchy |
| Auth | ✅ API key (Bearer token) or OAuth 2.1 |
| Transport | ✅ Streamable HTTP (with SSE fallback) |
Other Prompts Available
| Prompt | Description |
|---|---|
| sb-setup | Full project onboarding — scans codebase, creates docs, configures auto-sync |
| sb-sync | Sync AGENTS.md rules — augments existing content, never removes |
| sb-update | Update documentation mid-conversation — captures decisions, changes, and knowledge |
| sb-create-doc | Create a new document in Stable Baseline |
| sb-create-diagram | Create a diagram (Mermaid, PlantUML, BPMN, GraphViz, etc.) |
| sb-edit-doc | Edit an existing document with targeted patches |
| sb-manage-images | Upload, update, or delete images in documents |
| sb-manage-data | Manage data files for Vega/Vega-Lite statistical visualizations |