popkit-mcp 1.0.3

PopKit MCP Server - exposes skills, agents, and commands as MCP tools

PopKit MCP Server

Standalone MCP server that exposes PopKit skills, agents, and commands as MCP tools, resources, and prompts. Any MCP-compatible tool (Cursor, Codex CLI, Copilot, etc.) can connect to this server to use PopKit.

MCP Tools

Tool	Description
popkit/run_skill	Invoke any PopKit skill by name
popkit/spawn_agent	Start an agent with a task
popkit/power_mode	Legacy multi-agent compatibility workflow
popkit/create_handoff	Build a coordination handoff packet
popkit/validate_handoff	Validate a coordination handoff packet
popkit/get_context	Retrieve project context
popkit/health_check	System status and diagnostics

Usage

The primary console script is popkit-mcp. The package also installs popkit-mcp-server as a longer compatibility alias.

# stdio transport (default, for MCP clients)
popkit-mcp

# SSE transport
popkit-mcp --transport sse --port 8080

# Streamable HTTP transport
popkit-mcp --transport streamable-http --port 8080

MCP Client Configuration

Add to your tool's MCP configuration:

{
  "mcpServers": {
    "popkit": {
      "command": "popkit-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

On Windows, pip install popkit-mcp may install popkit-mcp.exe in your user Scripts directory instead of on PATH:

%APPDATA%\Python\Python3xx\Scripts\

Use %APPDATA% instead of copying another user's absolute path. Replace Python3xx with your installed Python folder. Run python --version to check the version.

If you cannot edit PATH, configure your MCP client with the absolute path to popkit-mcp.exe:

{
  "mcpServers": {
    "popkit": {
      "command": "C:\\Users\\YOUR-USERNAME\\AppData\\Roaming\\Python\\Python313\\Scripts\\popkit-mcp.exe",
      "args": ["--transport", "stdio"]
    }
  }
}

Replace YOUR-USERNAME with your Windows username and Python313 with your installed Python version. Run python --version to check the version.

Requirements

• Python 3.11+
• mcp SDK (^1.12.0)
• popkit-shared (installed automatically by pip install popkit-mcp)