@realbase/mcp-server

RealBase MCP server for AI agents (Cursor, Claude Desktop, VS Code MCP, etc.).

Connects to RealBase Intra via MCP integration tokens and exposes tools for roadmap tasks, GitHub PR links, and note publishing.

Plan/document parsing lives in @realbase/mcp-core (shared with Cursor hooks).

Install

npm install -g @realbase/mcp-server
# or use npx (recommended for MCP clients)
npx -y @realbase/mcp-server

MCP client setup

1. Issue an MCP token in Intra: Account settings → MCP integration (rb_mcp_...).
2. Register the server in your MCP client:

{
  "mcpServers": {
    "realbase": {
      "command": "npx",
      "args": ["-y", "@realbase/mcp-server"],
      "env": {
        "REALBASE_INTRA_URL": "https://your-intra.example.com",
        "REALBASE_INTRA_TOKEN": "rb_mcp_..."
      }
    }
  }
}

3. Optional: add .realbase/config.json in your repo:

{
  "projectId": "",
  "planGlob": ".cursor/plans/**/*.plan.md",
  "defaultNoteFolderId": ""
}

Tools

• realbase_resolve_project, realbase_list_milestones, realbase_list_epics
• realbase_create_task, realbase_create_task_from_plan, realbase_sync_task_from_plan
• realbase_update_task, realbase_get_task, realbase_list_tasks, realbase_link_github_pr
• realbase_list_note_folders, realbase_get_note, realbase_search_notes
• realbase_publish_note, realbase_publish_note_from_document

Monorepo development

From the RealBase repo root:

pnpm --filter @realbase/mcp-server build
node packages/realbase-mcp-server/dist/index.js

License

Private / internal use — see repository license.