The Agency MCP Server

stdio MCP server for The Agency. Connect Cursor (or any MCP client) to your assigned projects, pull client context, and perform agent actions on the backlog.

Prerequisites

1. A The Agency account with role developer, tester, or platform_admin
2. A personal access token (wa_...) from Profile → Access tokens in the app
3. A platform admin must add you to the project team on the project page

Install in Cursor

Published as @wolfgang-sfi/agency-mcp on npm. New versions are released automatically when packages/mcp-server changes on main.

Add to .cursor/mcp.json (project) or Cursor Settings → MCP:

{
  "mcpServers": {
    "the-agency": {
      "command": "npx",
      "args": ["-y", "@wolfgang-sfi/agency-mcp"],
      "env": {
        "THE_AGENCY_API_URL": "https://your-app.example.com",
        "THE_AGENCY_TOKEN": "wa_..."
      }
    }
  }
}

For local development against bun dev:

{
  "mcpServers": {
    "the-agency": {
      "command": "node",
      "args": ["/absolute/path/to/the-agency/packages/mcp-server/dist/index.js"],
      "env": {
        "THE_AGENCY_API_URL": "http://localhost:3000",
        "THE_AGENCY_TOKEN": "wa_..."
      }
    }
  }
}

Build the package first:

cd packages/mcp-server
npm install
npm run build

Environment variables

| Variable | Description | |----------|-------------| | THE_AGENCY_API_URL | Base URL of the deployed app (no trailing slash) | | THE_AGENCY_TOKEN | Personal access token starting with wa_ |

Recommended agent flow

1. list_assigned_projects — discover projects you can access
2. get_project_context — load brief + contextMarkdown into the session
3. get_backlog_item / list_backlog_items — work on a specific task
4. After implementation: log_backlog_effort and move_backlog_item

If list_assigned_projects is empty, ask a platform admin to add you to the project team.

Tools

| Tool | Description | |------|-------------| | list_assigned_projects | Cross-org list of assigned projects | | get_project_context | Brief, stack, requirements markdown | | list_backlog_items | Kanban backlog with optional filters | | get_backlog_item | Full task detail | | list_backlog_comments | Comment threads | | add_backlog_comment | Post a comment | | log_backlog_effort | Record dev minutes / AI tokens | | move_backlog_item | Change kanban column |

Resources

• agency://project/{orgSlug}/{projectId}/context — project markdown
• agency://backlog-item/{orgSlug}/{projectId}/{itemId} — task JSON

API

This package calls The Agency REST API at /api/v1/* on the same domain as the web app. No separate MCP host is required.