Metadata-Version: 2.4
Name: cacodes-mcp-server
Version: 0.4.2
Summary: Model Context Protocol server for Cacodes (Plane fork) integration
Author-email: CaCodes <contato@cacodes.com.br>
License: MIT
Project-URL: Homepage, https://tarefas.cacodes.com.br/docs/developers/dev-tools/mcp
Project-URL: Repository, https://github.com/Caiocesar173/plane
Project-URL: Documentation, https://tarefas.cacodes.com.br/docs/developers/dev-tools/cacodes-mcp-install
Keywords: mcp,cacodes,plane,fastmcp,ai,automation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastmcp==3.2.0
Requires-Dist: plane-sdk==0.2.16
Requires-Dist: py-key-value-aio[redis]<0.5.0,>=0.4.4
Requires-Dist: mcp==1.26.0
Requires-Dist: PyJWT>=2.12.0
Requires-Dist: authlib>=1.6.9
Requires-Dist: boto3>=1.34.0
Requires-Dist: fakeredis[lua]<2.35.0,>=2.32.1
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"

# CaCodes MCP Server

Model Context Protocol server for **CaCodes** (Plane fork) — work items, pages, project memory (AgentMemory RAG), and templates.

**PyPI:** [cacodes-mcp-server](https://pypi.org/project/cacodes-mcp-server/)  
**Remote:** `https://mcp.cacodes.com.br/http/api-key/mcp`

## Quick install

```bash
uvx cacodes-mcp-server install --all
uvx cacodes-mcp-server doctor
uvx cacodes-mcp-server stdio
```

The install orchestrator configures MCP, runs the PAT wizard (or `--auth oauth`), validates connectivity, installs **GSD** and **Ponytail** from local vendor snapshots, and writes memory-first Cursor rules.

## Subcommands

| Command          | Description                                    |
| ---------------- | ---------------------------------------------- |
| `install`        | MCP + GSD + Ponytail + rules + optional doctor |
| `doctor`         | Validate PAT, workspace, MCP, `memory_recall`  |
| `auth`           | PAT wizard only (`127.0.0.1:8765/callback`)    |
| `stdio` / `http` | Run MCP server                                 |

## Cursor (HTTP remote, PAT)

```json
{
  "mcpServers": {
    "cacodes": {
      "url": "https://mcp.cacodes.com.br/http/api-key/mcp",
      "type": "http",
      "headers": {
        "x-api-key": "<cacodes-personal-access-token>",
        "x-workspace-slug": "cacodes"
      }
    }
  }
}
```

## Cursor (OAuth)

```json
{
  "mcpServers": {
    "cacodes": {
      "url": "https://mcp.cacodes.com.br/http/mcp",
      "type": "http"
    }
  }
}
```

## Environment variables

| CaCodes (docs)  | Env var                  | Legado (compat.)       | Description                        |
| --------------- | ------------------------ | ---------------------- | ---------------------------------- |
| CaCodes API Key | `CACODES_API_KEY`        | `PLANE_API_KEY`        | Personal access token from CaCodes |
| CaCodes URL     | `CACODES_BASE_URL`       | `PLANE_BASE_URL`       | `https://tarefas.cacodes.com.br`   |
| Workspace       | `CACODES_WORKSPACE_SLUG` | `PLANE_WORKSPACE_SLUG` | e.g. `cacodes`                     |
| AgentMemory     | `AGENTMEMORY_URL`        | —                      | Server-side memory (internal)      |

## Memory-first

GSD + Ponytail are always-on after install. Call `cacodes_get_project_context` and `memory_recall` before scanning the codebase. Map context into AgentMemory via `cacodes_trigger_reindex` — not local `.planning/` as source of truth.

## Release

Published via `.github/workflows/mcp-pypi-publish.yml` on GitHub Release. Ponytail vendor snapshot is bundled under `plane_mcp/bundled/ponytail`.
