codens-mcp 0.1.0__tar.gz

codens_mcp-0.1.0/.gitignore

@@ -0,0 +1,93 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.hypothesis/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+logs/
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Next.js
+.next/
+out/
+
+# Production
+/build
+/dist
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+
+# Terraform
+*.tfstate
+*.tfstate.*
+.terraform/
+.terraform.lock.hcl
+tfplan
+
+# AWS
+.aws-sam/
+
+# serena memories (keep but optional)
+# .serena/

codens_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to `codens-mcp` are documented here.
+
+## [0.1.0] - 2026-05-06
+
+### Added
+
+- Initial release of `codens-mcp` — the unified MCP server for the Codens family.
+- **Purple tools (16)**: All tools re-exported from `purple-codens-mcp>=0.2.0`.
+  - Auth: `purple_login`, `purple_whoami`
+  - Project: `purple_analyze_repo`, `purple_list_projects`, `purple_init_project`
+  - Repository: `purple_add_repository`, `purple_list_repositories`
+  - Instructions: `purple_import_instructions`, `purple_list_instructions`, `purple_sync_instructions`
+  - Workflow: `purple_create_workflow`, `purple_get_run_status`, `purple_list_runs`, `purple_cancel_run`, `purple_inject_message`
+  - SSE: `purple_subscribe_run_events`
+- **Red tools (4)**: Red Codens bug-report and auto-fix integration.
+  - `red_create_bug_report` — POST `/api/v1/agent/create-bug-report`
+  - `red_get_bug_report` — GET `/api/v1/organizations/{org}/bug-reports/{id}`
+  - `red_analyze_bug_report` — POST `/api/v1/organizations/{org}/bug-reports/{id}/analyze`
+  - `red_submit_bug_fix_plan_to_purple` — POST `/api/v1/organizations/{org}/bug-fix-plans/{id}/submit`
+- **Blue tools (4)**: Blue Codens QA/E2E automation.
+  - `blue_list_e2e_tests`
+  - `blue_generate_e2e_test`
+  - `blue_run_e2e_test`
+  - `blue_get_e2e_test_results`
+- **Green tools (4)**: Green Codens PRD consultation and kickoff.
+  - `green_create_consultation_with_message`
+  - `green_send_consultation_message`
+  - `green_convert_consultation_to_prd`
+  - `green_create_kickoff`
+- **Auth tools (2)**: Auth Codens agent signup and public pricing.
+  - `auth_agent_signup`
+  - `auth_get_pricing`

codens_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright 2026 Corevice Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codens_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: codens-mcp
+Version: 0.1.0
+Summary: Unified MCP server for Codens family — Red (auto-fix), Blue (QA), Green (PRD), Auth, plus all Purple tools via purple-codens-mcp.
+Project-URL: Homepage, https://github.com/Corevice/purple-codens/tree/main/codens-mcp
+Project-URL: Repository, https://github.com/Corevice/purple-codens
+Project-URL: Issues, https://github.com/Corevice/purple-codens/issues
+Project-URL: Changelog, https://github.com/Corevice/purple-codens/blob/main/codens-mcp/CHANGELOG.md
+Author-email: Corevice <engineering@corevice.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,auto-fix,automation,claude,codens,mcp,prd,qa,workflow
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: anyio>=4.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: purple-codens-mcp>=0.2.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# codens-mcp
+
+[![PyPI version](https://img.shields.io/pypi/v/codens-mcp)](https://pypi.org/project/codens-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/codens-mcp)](https://pypi.org/project/codens-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Unified MCP server for the **Codens family** — lets Claude Code and other AI agents operate all Codens services through a single package.
+
+Includes all 16 **Purple** tools (re-exported from `purple-codens-mcp`) plus new tools for **Red** (auto-fix), **Blue** (QA), **Green** (PRD), and **Auth Codens**.
+
+## Installation
+
+```bash
+pip install codens-mcp
+```
+
+## Quick Start (Claude Code)
+
+Add to your `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "codens": {
+      "command": "codens-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+Then log in once via `purple_login` — the JWT issued by Auth Codens is accepted by all family backends.
+
+## Available Tools (30 total)
+
+### Auth / Session (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_login` | Log in via browser OAuth, device code, or email+password |
+| `purple_whoami` | Show current authenticated user and organization |
+
+### Project Setup (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_analyze_repo` | Scan local repo and return structured analysis |
+| `purple_list_projects` | List all projects in the organization |
+| `purple_init_project` | Full project setup: create → link repo → import instructions |
+
+### Repository (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_add_repository` | Link a GitHub repository to a project |
+| `purple_list_repositories` | List repositories linked to a project |
+
+### Instruction Files (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_import_instructions` | Import CLAUDE.md + .claude/rules/ from GitHub |
+| `purple_list_instructions` | List instruction files for a project |
+| `purple_sync_instructions` | Diff local vs remote, update changed files |
+
+### Workflow & Runs (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_create_workflow` | Create a new workflow |
+| `purple_get_run_status` | Get current status of a workflow run |
+| `purple_list_runs` | List workflow runs (filter by project/status) |
+| `purple_cancel_run` | Cancel a running workflow |
+| `purple_inject_message` | Inject a message into a heartbeat run |
+| `purple_subscribe_run_events` | Stream SSE events for a workflow run |
+
+### Red Codens — Auto-Fix
+| Tool | Description |
+|------|-------------|
+| `red_create_bug_report` | Create a bug report (agent endpoint) |
+| `red_get_bug_report` | Get a bug report by ID |
+| `red_analyze_bug_report` | Trigger AI analysis for a bug report |
+| `red_submit_bug_fix_plan_to_purple` | Submit a fix plan to Purple for execution |
+
+### Blue Codens — QA Automation
+| Tool | Description |
+|------|-------------|
+| `blue_list_e2e_tests` | List E2E tests |
+| `blue_generate_e2e_test` | Generate an E2E test from a natural-language requirement |
+| `blue_run_e2e_test` | Trigger a run for an existing E2E test |
+| `blue_get_e2e_test_results` | Get results for an E2E test (latest run) |
+
+### Green Codens — PRD Management
+| Tool | Description |
+|------|-------------|
+| `green_create_consultation_with_message` | Start a consultation and send the first message |
+| `green_send_consultation_message` | Send a message in an existing consultation |
+| `green_convert_consultation_to_prd` | Convert a consultation into a PRD |
+| `green_create_kickoff` | Create a Kickoff in Green Codens |
+
+### Auth Codens
+| Tool | Description |
+|------|-------------|
+| `auth_agent_signup` | Issue capability_token via existing user's API key |
+| `auth_get_pricing` | Public pricing.json (no auth required) |
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT — Copyright 2026 Corevice Inc.

codens_mcp-0.1.0/README.md

@@ -0,0 +1,108 @@
+# codens-mcp
+
+[![PyPI version](https://img.shields.io/pypi/v/codens-mcp)](https://pypi.org/project/codens-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/codens-mcp)](https://pypi.org/project/codens-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Unified MCP server for the **Codens family** — lets Claude Code and other AI agents operate all Codens services through a single package.
+
+Includes all 16 **Purple** tools (re-exported from `purple-codens-mcp`) plus new tools for **Red** (auto-fix), **Blue** (QA), **Green** (PRD), and **Auth Codens**.
+
+## Installation
+
+```bash
+pip install codens-mcp
+```
+
+## Quick Start (Claude Code)
+
+Add to your `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "codens": {
+      "command": "codens-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+Then log in once via `purple_login` — the JWT issued by Auth Codens is accepted by all family backends.
+
+## Available Tools (30 total)
+
+### Auth / Session (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_login` | Log in via browser OAuth, device code, or email+password |
+| `purple_whoami` | Show current authenticated user and organization |
+
+### Project Setup (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_analyze_repo` | Scan local repo and return structured analysis |
+| `purple_list_projects` | List all projects in the organization |
+| `purple_init_project` | Full project setup: create → link repo → import instructions |
+
+### Repository (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_add_repository` | Link a GitHub repository to a project |
+| `purple_list_repositories` | List repositories linked to a project |
+
+### Instruction Files (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_import_instructions` | Import CLAUDE.md + .claude/rules/ from GitHub |
+| `purple_list_instructions` | List instruction files for a project |
+| `purple_sync_instructions` | Diff local vs remote, update changed files |
+
+### Workflow & Runs (Purple)
+| Tool | Description |
+|------|-------------|
+| `purple_create_workflow` | Create a new workflow |
+| `purple_get_run_status` | Get current status of a workflow run |
+| `purple_list_runs` | List workflow runs (filter by project/status) |
+| `purple_cancel_run` | Cancel a running workflow |
+| `purple_inject_message` | Inject a message into a heartbeat run |
+| `purple_subscribe_run_events` | Stream SSE events for a workflow run |
+
+### Red Codens — Auto-Fix
+| Tool | Description |
+|------|-------------|
+| `red_create_bug_report` | Create a bug report (agent endpoint) |
+| `red_get_bug_report` | Get a bug report by ID |
+| `red_analyze_bug_report` | Trigger AI analysis for a bug report |
+| `red_submit_bug_fix_plan_to_purple` | Submit a fix plan to Purple for execution |
+
+### Blue Codens — QA Automation
+| Tool | Description |
+|------|-------------|
+| `blue_list_e2e_tests` | List E2E tests |
+| `blue_generate_e2e_test` | Generate an E2E test from a natural-language requirement |
+| `blue_run_e2e_test` | Trigger a run for an existing E2E test |
+| `blue_get_e2e_test_results` | Get results for an E2E test (latest run) |
+
+### Green Codens — PRD Management
+| Tool | Description |
+|------|-------------|
+| `green_create_consultation_with_message` | Start a consultation and send the first message |
+| `green_send_consultation_message` | Send a message in an existing consultation |
+| `green_convert_consultation_to_prd` | Convert a consultation into a PRD |
+| `green_create_kickoff` | Create a Kickoff in Green Codens |
+
+### Auth Codens
+| Tool | Description |
+|------|-------------|
+| `auth_agent_signup` | Issue capability_token via existing user's API key |
+| `auth_get_pricing` | Public pricing.json (no auth required) |
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT — Copyright 2026 Corevice Inc.

codens_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "codens-mcp"
+version = "0.1.0"
+description = "Unified MCP server for Codens family — Red (auto-fix), Blue (QA), Green (PRD), Auth, plus all Purple tools via purple-codens-mcp."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Corevice", email = "engineering@corevice.com" }]
+keywords = ["mcp", "claude", "agent", "codens", "workflow", "automation", "qa", "prd", "auto-fix"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "mcp>=1.0.0",
+  "httpx>=0.27.0",
+  "pydantic>=2.0.0",
+  "anyio>=4.0.0",
+  "purple-codens-mcp>=0.2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Corevice/purple-codens/tree/main/codens-mcp"
+Repository = "https://github.com/Corevice/purple-codens"
+Issues = "https://github.com/Corevice/purple-codens/issues"
+Changelog = "https://github.com/Corevice/purple-codens/blob/main/codens-mcp/CHANGELOG.md"
+
+[project.scripts]
+codens-mcp = "codens_mcp.server:main"
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0.0",
+  "pytest-asyncio>=0.23.0",
+  "pytest-cov>=4.1.0",
+  "build>=1.0.0",
+]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/codens_mcp", "README.md", "CHANGELOG.md", "LICENSE"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codens_mcp"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+
+[tool.mypy]
+python_version = "3.11"
+strict = false

codens_mcp-0.1.0/src/codens_mcp/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "0.1.0"
+__all__ = ["__version__"]

codens_mcp-0.1.0/src/codens_mcp/__main__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+main()

codens_mcp-0.1.0/src/codens_mcp/client/__init__.py

@@ -0,0 +1,15 @@
+from .auth_helper import AuthenticationError, Credentials, load_codens_credentials
+from .red import RedClient
+from .blue import BlueClient
+from .green import GreenClient
+from .auth import AuthClient
+
+__all__ = [
+    "AuthenticationError",
+    "Credentials",
+    "load_codens_credentials",
+    "RedClient",
+    "BlueClient",
+    "GreenClient",
+    "AuthClient",
+]

codens_mcp-0.1.0/src/codens_mcp/client/auth.py

@@ -0,0 +1,23 @@
+"""HTTP client for Auth Codens (agent-signup and public endpoints)."""
+
+from typing import Optional
+
+import httpx
+
+
+class AuthClient:
+    def __init__(self, api_url: str, token: Optional[str] = None) -> None:
+        self.api_url = api_url.rstrip("/")
+        self.token = token
+
+    def get_no_auth(self, path: str) -> dict:
+        with httpx.Client(timeout=10.0) as c:
+            r = c.get(f"{self.api_url}{path}")
+            r.raise_for_status()
+            return r.json()
+
+    def post(self, path: str, json: dict) -> dict:
+        with httpx.Client(timeout=10.0) as c:
+            r = c.post(f"{self.api_url}{path}", json=json)
+            r.raise_for_status()
+            return r.json()

codens_mcp-0.1.0/src/codens_mcp/client/auth_helper.py

@@ -0,0 +1,33 @@
+"""Shared credential helper for Codens family clients.
+
+Reuses the credential store written by purple_login (~/.purple-codens/credentials.json).
+Auth Codens is the single OIDC issuer for the family, so the same JWT is accepted
+by Red, Blue, and Green backends.
+"""
+
+from dataclasses import dataclass
+
+from purple_codens_mcp.auth import get_credentials
+
+
+class AuthenticationError(Exception):
+    """Raised when credentials are missing or invalid."""
+
+
+@dataclass
+class Credentials:
+    token: str
+
+
+def load_codens_credentials(api_url: str, service: str) -> Credentials:
+    """Load JWT from the purple-codens-mcp credential store.
+
+    For v0.1.0 all Codens backends share the JWT issued by Auth Codens via
+    purple_login. Future versions may use per-service capability_tokens.
+    """
+    creds = get_credentials(api_url)
+    if creds is None:
+        raise AuthenticationError(
+            f"Not logged in for {api_url}. Run purple_login first."
+        )
+    return Credentials(token=creds["token"])

codens_mcp-0.1.0/src/codens_mcp/client/blue.py

@@ -0,0 +1,32 @@
+"""HTTP client for Blue Codens (QA automation service)."""
+
+from typing import Optional
+
+import httpx
+
+from .auth_helper import AuthenticationError
+
+
+class BlueClient:
+    def __init__(self, api_url: str, token: str) -> None:
+        self.api_url = api_url.rstrip("/")
+        self.token = token
+
+    def _headers(self) -> dict:
+        return {"Authorization": f"Bearer {self.token}", "Content-Type": "application/json"}
+
+    def get(self, path: str, params: Optional[dict] = None) -> dict:
+        with httpx.Client(timeout=30.0) as c:
+            r = c.get(f"{self.api_url}{path}", headers=self._headers(), params=params)
+            if r.status_code == 401:
+                raise AuthenticationError("401 from Blue Codens — token may be expired")
+            r.raise_for_status()
+            return r.json()
+
+    def post(self, path: str, json: Optional[dict] = None) -> dict:
+        with httpx.Client(timeout=30.0) as c:
+            r = c.post(f"{self.api_url}{path}", headers=self._headers(), json=json or {})
+            if r.status_code == 401:
+                raise AuthenticationError("401 from Blue Codens — token may be expired")
+            r.raise_for_status()
+            return r.json()

codens_mcp-0.1.0/src/codens_mcp/client/green.py

@@ -0,0 +1,32 @@
+"""HTTP client for Green Codens (PRD management service)."""
+
+from typing import Optional
+
+import httpx
+
+from .auth_helper import AuthenticationError
+
+
+class GreenClient:
+    def __init__(self, api_url: str, token: str) -> None:
+        self.api_url = api_url.rstrip("/")
+        self.token = token
+
+    def _headers(self) -> dict:
+        return {"Authorization": f"Bearer {self.token}", "Content-Type": "application/json"}
+
+    def get(self, path: str, params: Optional[dict] = None) -> dict:
+        with httpx.Client(timeout=30.0) as c:
+            r = c.get(f"{self.api_url}{path}", headers=self._headers(), params=params)
+            if r.status_code == 401:
+                raise AuthenticationError("401 from Green Codens — token may be expired")
+            r.raise_for_status()
+            return r.json()
+
+    def post(self, path: str, json: Optional[dict] = None) -> dict:
+        with httpx.Client(timeout=30.0) as c:
+            r = c.post(f"{self.api_url}{path}", headers=self._headers(), json=json or {})
+            if r.status_code == 401:
+                raise AuthenticationError("401 from Green Codens — token may be expired")
+            r.raise_for_status()
+            return r.json()

codens_mcp-0.1.0/src/codens_mcp/client/red.py

@@ -0,0 +1,32 @@
+"""HTTP client for Red Codens (auto-fix service)."""
+
+from typing import Optional
+
+import httpx
+
+from .auth_helper import AuthenticationError
+
+
+class RedClient:
+    def __init__(self, api_url: str, token: str) -> None:
+        self.api_url = api_url.rstrip("/")
+        self.token = token
+
+    def _headers(self) -> dict:
+        return {"Authorization": f"Bearer {self.token}", "Content-Type": "application/json"}
+
+    def get(self, path: str, params: Optional[dict] = None) -> dict:
+        with httpx.Client(timeout=30.0) as c:
+            r = c.get(f"{self.api_url}{path}", headers=self._headers(), params=params)
+            if r.status_code == 401:
+                raise AuthenticationError("401 from Red Codens — token may be expired")
+            r.raise_for_status()
+            return r.json()
+
+    def post(self, path: str, json: Optional[dict] = None) -> dict:
+        with httpx.Client(timeout=30.0) as c:
+            r = c.post(f"{self.api_url}{path}", headers=self._headers(), json=json or {})
+            if r.status_code == 401:
+                raise AuthenticationError("401 from Red Codens — token may be expired")
+            r.raise_for_status()
+            return r.json()

codens_mcp-0.1.0/src/codens_mcp/server.py

@@ -0,0 +1,30 @@
+"""Unified MCP server entry point for the Codens family."""
+
+from mcp.server.fastmcp import FastMCP
+
+from .tools.auth_tools import register_auth_tools
+from .tools.blue_tools import register_blue_tools
+from .tools.green_tools import register_green_tools
+from .tools.purple_tools import register_purple_tools
+from .tools.red_tools import register_red_tools
+
+
+def main() -> None:
+    mcp = FastMCP(
+        "codens",
+        instructions=(
+            "Codens unified MCP server. "
+            "Use purple_login first, then use Red/Blue/Green/Auth tools as needed. "
+            "All tools that call Codens APIs require the api_url parameter."
+        ),
+    )
+    register_purple_tools(mcp)
+    register_red_tools(mcp)
+    register_blue_tools(mcp)
+    register_green_tools(mcp)
+    register_auth_tools(mcp)
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

codens_mcp-0.1.0/src/codens_mcp/tools/auth_tools.py

@@ -0,0 +1,47 @@
+"""Auth Codens MCP tools: agent signup and public pricing."""
+
+from mcp.server.fastmcp import FastMCP
+
+from ..client.auth import AuthClient
+
+
+def register_auth_tools(mcp: FastMCP) -> None:
+
+    @mcp.tool()
+    async def auth_agent_signup(
+        api_url: str,
+        existing_api_key: str,
+        agent_identity_token: str,
+        agent_identity_provider: str = "anthropic",
+    ) -> dict:
+        """
+        Issue a capability_token and register an agent member via the existing user's API key.
+
+        Path: POST /api/v1/auth/agent-signup
+
+        Args:
+            api_url: Auth Codens API base URL
+            existing_api_key: The user's existing API key (used to authorize agent registration)
+            agent_identity_token: Identity token issued by the agent provider
+            agent_identity_provider: Provider name (default: anthropic)
+        """
+        return AuthClient(api_url).post(
+            "/api/v1/auth/agent-signup",
+            json={
+                "existing_api_key": existing_api_key,
+                "agent_identity_token": agent_identity_token,
+                "agent_identity_provider": agent_identity_provider,
+            },
+        )
+
+    @mcp.tool()
+    async def auth_get_pricing(api_url: str) -> dict:
+        """
+        Return the public pricing.json (proxied from BCP, 5-min cache + fallback). No auth required.
+
+        Path: GET /.well-known/pricing.json
+
+        Args:
+            api_url: Auth Codens API base URL
+        """
+        return AuthClient(api_url).get_no_auth("/.well-known/pricing.json")

codens_mcp-0.1.0/src/codens_mcp/tools/blue_tools.py

@@ -0,0 +1,94 @@
+"""Blue Codens MCP tools: E2E test generation and execution."""
+
+from mcp.server.fastmcp import FastMCP
+
+from ..client.auth_helper import load_codens_credentials
+from ..client.blue import BlueClient
+
+
+def _client(api_url: str) -> BlueClient:
+    creds = load_codens_credentials(api_url, service="blue")
+    return BlueClient(api_url, creds.token)
+
+
+def register_blue_tools(mcp: FastMCP) -> None:
+
+    @mcp.tool()
+    async def blue_list_e2e_tests(
+        api_url: str,
+        page: int = 1,
+        page_size: int = 20,
+    ) -> dict:
+        """
+        List E2E tests.
+
+        Path: GET /api/v1/e2e-tests
+
+        Args:
+            api_url: Blue Codens API base URL
+            page: Page number (default: 1)
+            page_size: Results per page (default: 20)
+        """
+        return _client(api_url).get(
+            "/api/v1/e2e-tests",
+            params={"page": page, "page_size": page_size},
+        )
+
+    @mcp.tool()
+    async def blue_generate_e2e_test(
+        api_url: str,
+        project_id: str,
+        requirement: str,
+        language: str = "playwright",
+    ) -> dict:
+        """
+        Generate an E2E test from a natural-language requirement.
+
+        Path: POST /api/v1/ai/generate/e2e-test
+
+        Args:
+            api_url: Blue Codens API base URL
+            project_id: Project ID
+            requirement: Natural-language description of the test scenario
+            language: Test framework (default: playwright)
+        """
+        return _client(api_url).post(
+            "/api/v1/ai/generate/e2e-test",
+            json={
+                "project_id": project_id,
+                "requirement": requirement,
+                "language": language,
+            },
+        )
+
+    @mcp.tool()
+    async def blue_run_e2e_test(
+        api_url: str,
+        e2e_test_id: str,
+    ) -> dict:
+        """
+        Trigger a run for an existing E2E test.
+
+        Path: POST /api/v1/e2e-tests/{e2e_test_id}/run
+
+        Args:
+            api_url: Blue Codens API base URL
+            e2e_test_id: E2E test ID
+        """
+        return _client(api_url).post(f"/api/v1/e2e-tests/{e2e_test_id}/run", json={})
+
+    @mcp.tool()
+    async def blue_get_e2e_test_results(
+        api_url: str,
+        e2e_test_id: str,
+    ) -> dict:
+        """
+        Get results for an E2E test (latest run).
+
+        Path: GET /api/v1/e2e-tests/{e2e_test_id}/results
+
+        Args:
+            api_url: Blue Codens API base URL
+            e2e_test_id: E2E test ID
+        """
+        return _client(api_url).get(f"/api/v1/e2e-tests/{e2e_test_id}/results")

codens_mcp-0.1.0/src/codens_mcp/tools/green_tools.py

@@ -0,0 +1,115 @@
+"""Green Codens MCP tools: PRD consultations and kickoffs."""
+
+from typing import Optional
+
+from mcp.server.fastmcp import FastMCP
+
+from ..client.auth_helper import load_codens_credentials
+from ..client.green import GreenClient
+
+
+def _client(api_url: str) -> GreenClient:
+    creds = load_codens_credentials(api_url, service="green")
+    return GreenClient(api_url, creds.token)
+
+
+def register_green_tools(mcp: FastMCP) -> None:
+
+    @mcp.tool()
+    async def green_create_consultation_with_message(
+        api_url: str,
+        organization_id: str,
+        project_id: str,
+        message: str,
+    ) -> dict:
+        """
+        Create a new consultation session and send the first message in one call (lazy creation).
+
+        Path: POST /api/v1/organizations/{organization_id}/consultations/with-message
+
+        Args:
+            api_url: Green Codens API base URL
+            organization_id: Organization ID
+            project_id: Project ID
+            message: First message to send in the consultation
+        """
+        return _client(api_url).post(
+            f"/api/v1/organizations/{organization_id}/consultations/with-message",
+            json={"project_id": project_id, "message": message},
+        )
+
+    @mcp.tool()
+    async def green_send_consultation_message(
+        api_url: str,
+        organization_id: str,
+        consultation_id: str,
+        message: str,
+    ) -> dict:
+        """
+        Send a message in an existing consultation and get the AI reply.
+
+        Path: POST /api/v1/organizations/{organization_id}/consultations/{consultation_id}/messages
+
+        Args:
+            api_url: Green Codens API base URL
+            organization_id: Organization ID
+            consultation_id: Consultation session ID
+            message: Message to send
+        """
+        return _client(api_url).post(
+            f"/api/v1/organizations/{organization_id}/consultations/{consultation_id}/messages",
+            json={"message": message},
+        )
+
+    @mcp.tool()
+    async def green_convert_consultation_to_prd(
+        api_url: str,
+        organization_id: str,
+        consultation_id: str,
+        title: Optional[str] = None,
+    ) -> dict:
+        """
+        Convert a consultation session into a PRD.
+
+        Path: POST /api/v1/organizations/{organization_id}/consultations/{consultation_id}/convert-to-prd
+
+        Args:
+            api_url: Green Codens API base URL
+            organization_id: Organization ID
+            consultation_id: Consultation session ID
+            title: Optional PRD title (auto-generated if omitted)
+        """
+        body = {"title": title} if title else {}
+        return _client(api_url).post(
+            f"/api/v1/organizations/{organization_id}/consultations/{consultation_id}/convert-to-prd",
+            json=body,
+        )
+
+    @mcp.tool()
+    async def green_create_kickoff(
+        api_url: str,
+        organization_id: str,
+        project_id: str,
+        title: str,
+        description: str,
+    ) -> dict:
+        """
+        Create a Kickoff in Green Codens.
+
+        Path: POST /api/v1/organizations/{organization_id}/kickoffs
+
+        Args:
+            api_url: Green Codens API base URL
+            organization_id: Organization ID
+            project_id: Project ID
+            title: Kickoff title
+            description: Kickoff description
+        """
+        return _client(api_url).post(
+            f"/api/v1/organizations/{organization_id}/kickoffs",
+            json={
+                "project_id": project_id,
+                "title": title,
+                "description": description,
+            },
+        )

codens_mcp-0.1.0/src/codens_mcp/tools/purple_tools.py

@@ -0,0 +1,28 @@
+"""Re-export all 16 Purple tools from purple-codens-mcp dependency."""
+
+from mcp.server.fastmcp import FastMCP
+from purple_codens_mcp.client import PurpleCodensClient
+from purple_codens_mcp.tools.auth_tools import register_auth_tools as _register_purple_auth
+from purple_codens_mcp.tools.instruction_tools import register_instruction_tools as _register_instructions
+from purple_codens_mcp.tools.project_tools import register_project_tools as _register_projects
+from purple_codens_mcp.tools.repo_tools import register_repo_tools as _register_repos
+from purple_codens_mcp.tools.sse_tools import register_sse_tools as _register_sse
+from purple_codens_mcp.tools.workflow_tools import register_workflow_tools as _register_workflows
+
+_purple_clients: dict[str, PurpleCodensClient] = {}
+
+
+def _purple_get_client(api_url: str, force_reload: bool = False) -> PurpleCodensClient:
+    if force_reload or api_url not in _purple_clients:
+        _purple_clients[api_url] = PurpleCodensClient(api_url)
+    return _purple_clients[api_url]
+
+
+def register_purple_tools(mcp: FastMCP) -> None:
+    """Register all 16 Purple tools (auth/project/repo/instruction/workflow/sse)."""
+    _register_purple_auth(mcp, _purple_get_client)
+    _register_projects(mcp, _purple_get_client)
+    _register_repos(mcp, _purple_get_client)
+    _register_instructions(mcp, _purple_get_client)
+    _register_workflows(mcp, _purple_get_client)
+    _register_sse(mcp, _purple_get_client)

codens_mcp-0.1.0/src/codens_mcp/tools/red_tools.py

@@ -0,0 +1,110 @@
+"""Red Codens MCP tools: bug reports and auto-fix plan submission."""
+
+from typing import Optional
+
+from mcp.server.fastmcp import FastMCP
+
+from ..client.auth_helper import load_codens_credentials
+from ..client.red import RedClient
+
+
+def _client(api_url: str) -> RedClient:
+    creds = load_codens_credentials(api_url, service="red")
+    return RedClient(api_url, creds.token)
+
+
+def register_red_tools(mcp: FastMCP) -> None:
+
+    @mcp.tool()
+    async def red_create_bug_report(
+        api_url: str,
+        organization_id: str,
+        project_id: str,
+        title: str,
+        description: str,
+        attachment_urls: Optional[list[str]] = None,
+    ) -> dict:
+        """
+        Create a bug report via Red Codens agent endpoint.
+
+        Path: POST /api/v1/agent/create-bug-report
+
+        Args:
+            api_url: Red Codens API base URL
+            organization_id: Organization ID
+            project_id: Project ID
+            title: Bug report title
+            description: Bug description
+            attachment_urls: Optional list of attachment URLs (screenshots, logs)
+        """
+        body: dict = {
+            "organization_id": organization_id,
+            "project_id": project_id,
+            "title": title,
+            "description": description,
+        }
+        if attachment_urls:
+            body["attachment_urls"] = attachment_urls
+        return _client(api_url).post("/api/v1/agent/create-bug-report", json=body)
+
+    @mcp.tool()
+    async def red_get_bug_report(
+        api_url: str,
+        organization_id: str,
+        bug_id: str,
+    ) -> dict:
+        """
+        Get a bug report by ID.
+
+        Path: GET /api/v1/organizations/{organization_id}/bug-reports/{bug_id}
+
+        Args:
+            api_url: Red Codens API base URL
+            organization_id: Organization ID
+            bug_id: Bug report ID
+        """
+        return _client(api_url).get(
+            f"/api/v1/organizations/{organization_id}/bug-reports/{bug_id}"
+        )
+
+    @mcp.tool()
+    async def red_analyze_bug_report(
+        api_url: str,
+        organization_id: str,
+        bug_id: str,
+    ) -> dict:
+        """
+        Trigger AI analysis for a bug report.
+
+        Path: POST /api/v1/organizations/{organization_id}/bug-reports/{bug_id}/analyze
+
+        Args:
+            api_url: Red Codens API base URL
+            organization_id: Organization ID
+            bug_id: Bug report ID
+        """
+        return _client(api_url).post(
+            f"/api/v1/organizations/{organization_id}/bug-reports/{bug_id}/analyze",
+            json={},
+        )
+
+    @mcp.tool()
+    async def red_submit_bug_fix_plan_to_purple(
+        api_url: str,
+        organization_id: str,
+        plan_id: str,
+    ) -> dict:
+        """
+        Submit DRAFT BugFixTasks of a plan to Purple Codens for execution.
+
+        Path: POST /api/v1/organizations/{organization_id}/bug-fix-plans/{plan_id}/submit
+
+        Args:
+            api_url: Red Codens API base URL
+            organization_id: Organization ID
+            plan_id: Bug fix plan ID
+        """
+        return _client(api_url).post(
+            f"/api/v1/organizations/{organization_id}/bug-fix-plans/{plan_id}/submit",
+            json={},
+        )