Metadata-Version: 2.5
Name: colabhive-mcp
Version: 0.3.3
Summary: Model Context Protocol server for ColabHive — expose LLMs, specialists, tools, and your trained models to any MCP client.
Project-URL: Homepage, https://docs.colabhive.com/mcp
Project-URL: Documentation, https://docs.colabhive.com/mcp
Project-URL: Installation, https://docs.colabhive.com/mcp/installation
Author-email: ColabHive <engineering@colabhive.com>
License: MIT
Keywords: agent,ai,colabhive,llm,mcp,model-context-protocol
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: keyring>=24
Requires-Dist: mcp<2.0,>=0.9
Requires-Dist: pydantic>=2.6
Requires-Dist: tomli>=2.0.1; python_version < '3.11'
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: http
Requires-Dist: fastapi>=0.110; extra == 'http'
Requires-Dist: sse-starlette>=2.0; extra == 'http'
Requires-Dist: uvicorn[standard]>=0.27; extra == 'http'
Description-Content-Type: text/markdown

# colabhive-mcp

Model Context Protocol (MCP) server that exposes ColabHive models — LLMs, specialists, tools and your
trained models — to MCP-compatible clients such as Claude Desktop, Claude Code, Cursor and n8n.

User docs: <https://docs.colabhive.com/mcp>

## Install

```bash
# Recommended (no global Python needed)
uvx colabhive-mcp

# Or pipx
pipx install colabhive-mcp

# Or pip (Python 3.10+)
pip install colabhive-mcp
```

## Quickstart

Create an API key in the ColabHive Console (Settings → API Keys); keys start with `hive_`.

```bash
export COLABHIVE_API_KEY=hive_...
colabhive-mcp test
```

Then add the server to your MCP client:

```json
{
  "mcpServers": {
    "colabhive": {
      "command": "uvx",
      "args": ["colabhive-mcp"],
      "env": { "COLABHIVE_API_KEY": "hive_..." }
    }
  }
}
```

A hosted server is also available at `https://mcp.colabhive.com`. See the
[user docs](https://docs.colabhive.com/mcp) for per-client guides.

`colabhive-mcp sdk-stdio` and `colabhive-mcp sdk-serve` provide strict stdio and stateless
Streamable HTTP transports built on the official MCP Python SDK, alongside the default stdio and
HTTP/SSE transports.

## Built-in account tools

- `get_account_preferences` and `set_share_hive_opt_in` read and set the account-scoped Share Hive
  preference. The credential selects the account; only the account owner can write it.
- `get_effective_data_protection` and `preflight_data_protection` read the effective
  node-eligibility policy and preflight a placement. There is no policy-mutation tool.

## Experimental Cohort tools

Six opt-in tools (`cohort_capabilities`, `plan_cohort`, `run_cohort`, `get_cohort`,
`explain_cohort`, `cancel_cohort`) stay hidden unless `COLABHIVE_MCP_COHORT_TOOLS_ENABLED=true`,
MCP stability permits `experimental` tools, the account has Cohort capability, and the kind and
side-effect filters allow the operation.

## License

MIT — see `LICENSE`.

## Links

- Docs: <https://docs.colabhive.com/mcp>
- Security: `security@colabhive.com`
