Pink Sundew MCP Server

Model Context Protocol server for Pink Sundew's Kanban bridge API.

This package now acts as a launcher for the native Rust runtime binary.

Install (preferred on macOS)

brew install pinksundew/tap/pinksundew-mcp

Upgrade:

brew upgrade pinksundew/tap/pinksundew-mcp

Install (direct binary fallback)

Install the native binary from GitHub Releases and put it on PATH as pinksundew-mcp.

Install (compatibility npm wrapper)

npm install -g @pinksundew/mcp

The wrapper downloads and executes the matching native binary.

Required environment variables

• AGENTPLANNER_API_KEY: API key created in the Pink Sundew dashboard.
• AGENTPLANNER_PROJECT_ID: Single project UUID the agent can access. Strict mode: Only one project ID is allowed per workspace to prevent context drift.
• AGENTPLANNER_CLIENT_ENV: Optional. Comma-separated client environment list for instruction sync targeting. Valid values: cursor, claude, windsurf, vscode, codex, antigravity. Example: vscode,codex.
• AGENTPLANNER_TARGET_FILES: Optional. Comma-separated workspace-relative output files. When set, this overrides AGENTPLANNER_CLIENT_ENV mapping. Example: AGENTS.md,.github/copilot-instructions.md.
• AGENTPLANNER_URL: Optional. Defaults to https://pinksundew.com.

Optional launcher variables

• PINKSUNDEW_MCP_BINARY_PATH: Absolute path to an already-installed binary. When set, download is skipped.
• PINKSUNDEW_MCP_RELEASE_BASE_URL: Override release asset base URL used by the launcher.

Client Environment Output Files

| CLIENT_ENV | Output File | |--------------|----------------------------------| | cursor | .cursorrules | | claude | CLAUDE.md | | windsurf | .windsurfrules | | vscode | .github/copilot-instructions.md | | codex | AGENTS.md | | antigravity | antigravity.md | | (default) | .agentrules |

codex maps to AGENTS.md so Codex CLI and the Codex extension (VS Code/Cursor) ingest the same synced instructions.

Output Resolution Precedence

1. AGENTPLANNER_TARGET_FILES (explicit target file list)
2. AGENTPLANNER_CLIENT_ENV (mapped from env values above)
3. Default fallback: .agentrules

Non-Destructive Sync

The instruction sync uses an Injection Block pattern to preserve user-defined content. Cloud instructions are wrapped in HTML comment markers:

<!-- BEGIN:pinksundew-sync -->
// AUTO-GENERATED BY PINK SUNDEW - DO NOT EDIT THIS BLOCK
// Last synced: 2024-01-15T10:30:00.000Z
// Project: My Project

Your cloud instructions here...
<!-- END:pinksundew-sync -->

• New files: Creates the file with the sync block
• Existing files with sync block: Updates only the content between markers
• Existing files without sync block: Appends the sync block to the end

Your custom instructions outside the markers are always preserved.

Run

AGENTPLANNER_API_KEY=your_api_key \
AGENTPLANNER_PROJECT_ID=project-uuid \
AGENTPLANNER_CLIENT_ENV=vscode,codex \
pinksundew-mcp

Example MCP client configuration (native binary)

{
  "mcpServers": {
    "pinksundew": {
      "command": "pinksundew-mcp",
      "env": {
        "AGENTPLANNER_API_KEY": "your_api_key",
        "AGENTPLANNER_PROJECT_ID": "your_project_id",
        "AGENTPLANNER_CLIENT_ENV": "vscode,codex"
      }
    }
  }
}

Example MCP client configuration (npm wrapper)

{
  "mcpServers": {
    "pinksundew": {
      "command": "npx",
      "args": ["-y", "@pinksundew/mcp"],
      "env": {
        "AGENTPLANNER_API_KEY": "your_api_key",
        "AGENTPLANNER_PROJECT_ID": "your_project_id",
        "AGENTPLANNER_CLIENT_ENV": "vscode,codex"
      }
    }
  }
}