Metadata-Version: 2.4
Name: popkit-mcp
Version: 1.0.3
Summary: PopKit MCP Server - exposes skills, agents, and commands as MCP tools
License: LicenseRef-PolyForm-Noncommercial-1.0.0
Author: Joseph Cannon
Author-email: joseph@thehouseofdeals.com
Requires-Python: >=3.11,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary 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: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: jsonschema (>=4.20.0)
Requires-Dist: mcp (>=1.12.0,<2.0.0)
Requires-Dist: popkit-shared (>=1.0.2,<2.0.0)
Requires-Dist: pyyaml (>=6.0,<7.0)
Project-URL: Homepage, https://github.com/jrc1883/popkit-ai
Project-URL: Repository, https://github.com/jrc1883/popkit-ai
Description-Content-Type: text/markdown

# 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.

```bash
# 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:

```json
{
  "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`:

```powershell
%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`:

```json
{
  "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`)

