Metadata-Version: 2.4
Name: popkit-mcp
Version: 1.0.1
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
Provides-Extra: full
Requires-Dist: mcp (>=1.12.0,<2.0.0)
Requires-Dist: popkit-shared (>=1.0.0,<2.0.0) ; extra == "full"
Requires-Dist: pyyaml (>=6.0,<7.0)
Project-URL: Homepage, https://github.com/jrc1883/popkit-claude
Project-URL: Repository, https://github.com/jrc1883/popkit-claude
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`   | Orchestrate multi-agent workflows |
| `popkit/get_context`  | Retrieve project context          |
| `popkit/health_check` | System status and diagnostics     |

## Usage

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

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

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

## MCP Client Configuration

Add to your tool's MCP configuration:

```json
{
  "mcpServers": {
    "popkit": {
      "command": "python3",
      "args": ["-m", "popkit_mcp.server"]
    }
  }
}
```

## Requirements

- Python 3.11+
- `mcp` SDK (^1.12.0)
- PopKit packages installed

