Quick Start Guide

Get Apogee MCP running with Cursor, Claude Code, and OpenAI Agents in minutes

Installation

Install the Apogee MCP server globally via npm:

npm install -g @apogee/mcp-server

Platform Setup

Cursor Setup (Implementer Role)

1. Create MCP configuration

Add this to your .cursor/mcp.json file:

{
  "mcpServers": {
    "apogee": {
      "command": "npx",
      "args": ["-y", "@apogee/mcp-server", "--stdio"],
      "env": {
        "APOGEE_ROLE": "implementer",
        "APOGEE_SESSION_ID": "my-project"
      }
    }
  }
}

2. Restart Cursor

Restart Cursor to load the MCP server. You should see Apogee tools in the available tools list.

Role: Implementer

Cursor acts as the implementer - building app code, APIs, tests, and UI components based on Claude's planning and database design.

Example Usage

Create Shared TODOs

await apogee.todo.update({
  diff: [{
    operation: "create",
    desc: "Implement user authentication API",
    assignee: "implementer",
    status: "pending"
  }]
});

Apply Code Patches

await apogee.patch.apply({
  diff: `--- a/src/auth.ts
+++ b/src/auth.ts
@@ -1,3 +1,8 @@
+export function validateToken(token: string) {
+  return jwt.verify(token, process.env.JWT_SECRET);
+}
+`,
  rationale: "Add JWT token validation function"
});

Database Migration (Claude Only)

await apogee.db.migrate({
  planId: "create_users_table",
  dryRun: false
});
// Result: Creates table with RLS policies

Ready to Start?

Check out our comprehensive documentation and start building with multi-agent AI coordination.

API ReferenceView Examples