{
  "markdown": "<div align=\"center\">\n\n<img src=\"./assets/logo.png\" alt=\"Stable Baseline\" width=\"120\" />\n\n# Stable Baseline — MCP Server\n\n**The simplest, most complete, end-to-end agent-managed company brain.**\n\n[Website](https://stablebaseline.io) · [Sign up free](https://app.stablebaseline.io/signup) · [Docs](https://stablebaseline.io/docs/mcp) · [Tool catalogue](https://stablebaseline.io/docs/mcp/tools) · [llms.txt](https://stablebaseline.io/llms.txt)\n\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.stablebaseline%2Fsb-orange)](https://registry.modelcontextprotocol.io/v0/servers?search=io.stablebaseline)\n[![Smithery](https://img.shields.io/badge/Smithery-stablebaseline%2Fsb--mcp-orange)](https://smithery.ai/servers/stablebaseline/sb-mcp)\n[![Tools](https://img.shields.io/badge/MCP%20tools-196-orange)](https://stablebaseline.io/docs/mcp/tools)\n[![npm CLI](https://img.shields.io/npm/v/@stablebaseline/cli?label=%40stablebaseline%2Fcli&color=orange)](https://www.npmjs.com/package/@stablebaseline/cli)\n[![npm SDK](https://img.shields.io/npm/v/@stablebaseline/sdk?label=%40stablebaseline%2Fsdk&color=orange)](https://www.npmjs.com/package/@stablebaseline/sdk)\n[![PyPI](https://img.shields.io/pypi/v/stablebaseline?label=stablebaseline&color=orange)](https://pypi.org/project/stablebaseline/)\n\n</div>\n\n---\n\n## How to use Stable Baseline\n\nPick the surface that matches how you work — every option talks to the same handlers, the same auth, the same data:\n\n| Surface | What it's for | Install |\n|---|---|---|\n| **MCP server** | AI agents (Claude Code, Cursor, Windsurf, ChatGPT, Gemini, Smithery, …). Native protocol with prompts and resources. | Endpoint: [`api.stablebaseline.io/functions/v1/cloud-serve/mcp`](https://api.stablebaseline.io/functions/v1/cloud-serve/mcp). See [Quick start](#quick-start) below. |\n| **REST API** | Any HTTP client, Postman, OpenAPI codegen, Zapier-style integrators. Tool-RPC + idiomatic resource routes. | Live spec: [`/api/v1/openapi.json`](https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1/openapi.json) · Interactive docs: [`/api/v1/docs`](https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1/docs) |\n| **TypeScript SDK** | Node, browsers, Deno, Bun. Typed `client.tools.<toolName>(...)` surface. | `npm i @stablebaseline/sdk` — see [`packages/sdk-typescript`](packages/sdk-typescript/) |\n| **CLI (`sb`)** | Shells, scripts, CI/CD. `sb tool call <name> --json '{...}'`. | `npm i -g @stablebaseline/cli` — see [`packages/cli`](packages/cli/) |\n| **Python SDK** | Python apps, data work. Sync + async clients. | `pip install stablebaseline` — see [`packages/sdk-python`](packages/sdk-python/) |\n\n196 tools across 18 categories. Same brain, same Knowledge Graph, same RBAC — every surface.\n\n---\n\nOne workspace where humans and any MCP-compatible AI agent — Claude Code, Cursor, Windsurf, VS Code, Warp, OpenCode, Antigravity, OpenAI Codex, ChatGPT Developer Mode, Gemini CLI/Extensions, and more — co-author **living documents** (Markdown-native with a rich superset on top), **40+ visual diagrams** (Mermaid, BPMN 2.0, D2, PlantUML, GraphViz, ELK architecture, sequence, state, ERD, Gantt, Excalidraw freehand), plans, timelines, tasks, improvements, and a self-learning **Knowledge Graph that IS the company brain**.\n\n**Lean, fast, secure, and affordable** — flexible enough for one person organising a personal mind, through to small businesses, growing businesses, and enterprise.\n\n196 MCP tools across 18 categories let an agent drive **end-to-end**: sign-up → billing → org/workspace/project → members → teams → permissions → brain scope → docs → diagrams → whiteboards → plans, all without a human touching the UI.\n\n## Endpoint\n\n```\nhttps://api.stablebaseline.io/functions/v1/cloud-serve/mcp\n```\n\n**Transport:** Streamable HTTP (with SSE fallback)\n**Auth:** OAuth 2.1 with Dynamic Client Registration, **or** Bearer API key (`sta_*`)\n**Discovery manifest:** [`https://stablebaseline.io/.well-known/mcp.json`](https://stablebaseline.io/.well-known/mcp.json)\n\n## Quick start\n\n### Mint an API key (skip OAuth)\n\n1. [Sign up free](https://app.stablebaseline.io/signup) — no credit card\n2. Go to **Settings → MCP keys** and click **Generate**\n3. Copy the `sta_...` key\n\n(Or skip this — every client below also supports interactive OAuth on first call.)\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"stable-baseline\": {\n      \"url\": \"https://api.stablebaseline.io/functions/v1/cloud-serve/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer sta_YOUR_KEY\"\n      }\n    }\n  }\n}\n```\n\nOr use the Claude Desktop OAuth flow — set just `url` and Claude will prompt you to authorize on first call.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http stable-baseline \\\n  https://api.stablebaseline.io/functions/v1/cloud-serve/mcp \\\n  --header \"Authorization: Bearer sta_YOUR_KEY\"\n```\n\nOr via OAuth:\n\n```bash\nclaude mcp add --transport http stable-baseline \\\n  https://api.stablebaseline.io/functions/v1/cloud-serve/mcp\n```\n\n### Cursor\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"stable-baseline\": {\n      \"url\": \"https://api.stablebaseline.io/functions/v1/cloud-serve/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer sta_YOUR_KEY\" }\n    }\n  }\n}\n```\n\n### Windsurf\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"stable-baseline\": {\n      \"serverUrl\": \"https://api.stablebaseline.io/functions/v1/cloud-serve/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer sta_YOUR_KEY\" }\n    }\n  }\n}\n```\n\n### VS Code (Copilot Chat)\n\n`.vscode/mcp.json` (workspace) or user settings:\n\n```json\n{\n  \"servers\": {\n    \"stable-baseline\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.stablebaseline.io/functions/v1/cloud-serve/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer ${input:sta_key}\" }\n    }\n  }\n}\n```\n\n### Other clients\n\nRecipes for Warp, OpenCode, Antigravity, OpenAI Codex, ChatGPT Developer Mode, Gemini CLI/Extensions, and a generic recipe are at [stablebaseline.io/docs/mcp/setup](https://stablebaseline.io/docs/mcp/setup).\n\n## What you get\n\n| Category | Sample tools | Docs |\n|---|---|---|\n| **navigation** | `listOrganisations`, `getProjectHierarchy`, `searchTools` | [→](https://stablebaseline.io/docs/mcp/tools/navigation) |\n| **folders** | `createFolder`, `listFolders`, `setPlanItemParent` | [→](https://stablebaseline.io/docs/mcp/tools/folders) |\n| **documents** | `createDocument`, `editDocument`, `findAndReplaceTextInDocument` | [→](https://stablebaseline.io/docs/mcp/tools/documents) |\n| **diagrams** | `insertDiagramInDocument`, `listDiagramTypes`, `getCdmdLanguageGuide` | [→](https://stablebaseline.io/docs/mcp/tools/diagrams) |\n| **whiteboards** | `createWhiteboard`, `addWhiteboardElements`, `designDeckInWhiteboard` | [→](https://stablebaseline.io/docs/mcp/tools/whiteboards) |\n| **images** | `createImageUploadSession`, `insertImageInDocument` | [→](https://stablebaseline.io/docs/mcp/tools/images) |\n| **data** | `createVegaDataUploadSession` (CSV/JSON/TSV → Vega charts) | [→](https://stablebaseline.io/docs/mcp/tools/data) |\n| **improvements** | `createImprovement`, `searchImprovements`, `addImprovementEvidence` | [→](https://stablebaseline.io/docs/mcp/tools/improvements) |\n| **plans** | `createPlan`, `createPlanPhase`, `previewTaskDependencyCascade` | [→](https://stablebaseline.io/docs/mcp/tools/plans) |\n| **knowledge_graph** | `kg_search`, `kg_get_entity`, `kg_related_documents` | [→](https://stablebaseline.io/docs/mcp/tools/knowledge_graph) |\n| **organization** | `createOrganisation`, `createWorkspace`, `createProject` | [→](https://stablebaseline.io/docs/mcp/tools/organization) |\n| **members** | `inviteMember`, `updateMemberRole`, `setMemberActive` | [→](https://stablebaseline.io/docs/mcp/tools/members) |\n| **teams** | `createTeam`, `grantTeamWorkspaceAccess` | [→](https://stablebaseline.io/docs/mcp/tools/teams) |\n| **permissions** | `upsertResourcePermission`, `setResourcePermissionOverride` | [→](https://stablebaseline.io/docs/mcp/tools/permissions) |\n| **billing** | `previewSubscriptionChange`, `applySubscriptionChange`, `purchaseCreditPackage` | [→](https://stablebaseline.io/docs/mcp/tools/billing) |\n| **kg_admin** | `setKgWorkspaceScope`, `triggerKgRebuild`, `previewKgRebuild` | [→](https://stablebaseline.io/docs/mcp/tools/kg_admin) |\n| **settings** | `getOrgSettings`, `updateOrgFeatureFlags`, `createBrandKit` | [→](https://stablebaseline.io/docs/mcp/tools/settings) |\n| **signup** | `startSignup`, `pollSignupStatus` | [→](https://stablebaseline.io/docs/mcp/tools/signup) |\n\nFull live catalogue: [stablebaseline.io/docs/mcp/tools](https://stablebaseline.io/docs/mcp/tools)\n\n## Highlights\n\n- **End-to-end agent-managed**: agents drive sign-up → billing → org/workspace/project lifecycle → members → teams → permissions → Knowledge Graph scope. No human touching the UI.\n- **Living documents**: AI-native rich-text editor (CDMD = Markdown + inline diagrams, data tables, media, version history, real-time multi-author edits).\n- **Visual diagram creation & editing**: 40+ types — AI-generated, diagram-as-code, or freehand.\n- **Plans, timelines, tasks, improvements & bugs**: Day/Week/Month/Quarter/Year zoom Gantt, drag-to-reschedule, dependency cascades.\n- **Self-learning Knowledge Graph (Enterprise)**: auto-built from every doc/plan/improvement; read by every connected agent. Stops hallucinations around gaps. Run one brain workspace-wide, one per department, or one per project — RBAC end-to-end.\n- **Compliance Readiness (Enterprise)**: scans against OWASP ASVS, NIST SSDF, CIS Controls, ISO 27001, SOC 2, TISAX. *Readiness only — not legal advice, not an attestation.*\n- **Bring-your-own-agent — no lock-in**: any MCP-compatible client.\n- **Credit-cost preview ritual** for every spending operation: `previewX` → confirm token → `applyX`.\n\n## Auth\n\n| Method | When to use |\n|---|---|\n| **OAuth 2.1 + Dynamic Client Registration** | Default for desktop apps and IDE extensions. Smithery handles it automatically. |\n| **Bearer API key** (`sta_...`) | CI/CD, headless agents, server-to-server. Mint at [app.stablebaseline.io/settings/mcp-setup](https://app.stablebaseline.io/settings/mcp-setup). Project-scoped or global. |\n\nOAuth endpoints:\n- `authorize`: `https://api.stablebaseline.io/functions/v1/cloud-serve/oauth/authorize`\n- `token`: `https://api.stablebaseline.io/functions/v1/cloud-serve/oauth/token`\n- `register` (DCR): `https://api.stablebaseline.io/functions/v1/cloud-serve/oauth/register`\n- Scopes: `openid`, `profile`, `email`, `phone`. These identify the signed-in user and do NOT decide what an agent may do: authorisation comes from the read/write/delete permissions per content type and the organisation capability toggles chosen on the consent screen.\n- Authoritative metadata (always prefer this over the list above): `https://api.stablebaseline.io/functions/v1/cloud-serve/.well-known/oauth-authorization-server`\n\n## Discovery\n\n| Surface | URL |\n|---|---|\n| `.well-known/mcp.json` (manifest) | https://stablebaseline.io/.well-known/mcp.json |\n| Official MCP Registry | https://registry.modelcontextprotocol.io/v0/servers?search=io.stablebaseline |\n| Smithery | https://smithery.ai/servers/stablebaseline/sb-mcp |\n| `llms.txt` | https://stablebaseline.io/llms.txt |\n| `robots.txt` | https://stablebaseline.io/robots.txt |\n| `sitemap.xml` | https://stablebaseline.io/sitemap.xml |\n| `security.txt` | https://stablebaseline.io/.well-known/security.txt |\n\n## Pricing\n\n- **Free**: 100 one-off credits, no credit card.\n- **Pro**: A$79 / user / month, 500 credits / user / month.\n- **Enterprise**: custom — Knowledge Graph, Compliance Readiness, audit logs, SSO. [Contact](https://stablebaseline.io/contact).\n\n## Status\n\n- 🟢 **MCP Registry**: `io.stablebaseline/sb` — `active`, `isLatest`. Listed.\n- 🟢 **Smithery**: published with `configSchema` (Quick Setup). 196 tools / 11 prompts / 8 resources discovered.\n- 🟢 **`.well-known/mcp.json`**: live, schema 2024-11-05.\n- 🟢 **Endpoint**: `api.stablebaseline.io/functions/v1/cloud-serve/mcp` — accepts POST with `mcp-protocol-version: 2025-06-18`.\n\n## Issues & support\n\n- **Bug or feature request**: open an issue here.\n- **Security report**: see [`.well-known/security.txt`](https://stablebaseline.io/.well-known/security.txt) — RFC 9116 contact.\n- **General support**: https://stablebaseline.io/contact\n\n## License\n\nThis repository (README, `llms-install.md`, brand assets, and any documentation) is licensed under the **MIT License** — see [LICENSE](./LICENSE). You can copy, fork, and adapt these docs freely.\n\nThe Stable Baseline product itself — the SaaS application, the MCP server implementation, and the company brain Knowledge Graph — is proprietary, closed-source, and provided as a service at https://stablebaseline.io under the Stable Baseline [Terms of Service](https://stablebaseline.io/terms).\n\n---\n\nBuilt by [Orixian Solutions Pty Ltd](https://stablebaseline.io), Sydney, Australia.\n",
  "bytes": 13074,
  "sha": "d0fcb83bc72134d21e7bec4d82fe8377519f981fb37333a324dc4c575c0576f5",
  "repo_slug": "stablebaseline/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_stablebaseline_sb_3e182aa1/readme"
}