Scope MCP Server

A stdio-based MCP server that connects AI coding tools (Claude Code, Cursor, etc.) to your Scope project context.

Installation

npm install -g scope-mcp

Or use directly with npx:

npx scope-mcp

Usage

Claude Code

claude mcp add scope \
  -e SCOPE_API_KEY=scope_sk_YOUR_API_KEY \
  -e SCOPE_PROJECT_ID=prj_YOUR_PROJECT_ID \
  -- npx scope-mcp

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "scope": {
      "command": "npx",
      "args": ["scope-mcp"],
      "env": {
        "SCOPE_API_KEY": "scope_sk_YOUR_API_KEY",
        "SCOPE_PROJECT_ID": "prj_YOUR_PROJECT_ID"
      }
    }
  }
}

Generic MCP Config

For any MCP-compatible tool, use this config:

{
  "mcpServers": {
    "scope": {
      "command": "npx",
      "args": ["scope-mcp"],
      "env": {
        "SCOPE_API_KEY": "scope_sk_YOUR_API_KEY",
        "SCOPE_PROJECT_ID": "prj_YOUR_PROJECT_ID"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SCOPE_API_KEY | Yes | Your Scope API key (starts with scope_sk_) | | SCOPE_PROJECT_ID | No | Project ID to use as default (starts with prj_) | | SCOPE_API_URL | No | API URL (default: https://api.within-scope.com) |

Available Tools

Once connected, you'll have access to 55+ MCP tools including:

• get_next_ticket - Get the next ticket to work on
• complete_ticket - Mark a ticket as done
• get_project_summary - Get project overview
• get_implementation_context - Get full context for implementation
• save_learning - Save patterns and decisions
• And many more...

Getting Your API Key

1. Go to within-scope.com
2. Navigate to Settings → API Keys
3. Create a new API key
4. Copy the key (starts with scope_sk_)

License

MIT