Metadata-Version: 2.4
Name: prime-mcp-server
Version: 0.1.2
Summary: Prime Intellect MCP Server
Project-URL: Homepage, https://github.com/PrimeIntellect-ai/prime
Project-URL: Documentation, https://github.com/PrimeIntellect-ai/prime/tree/main/packages/prime-mcp-server
Project-URL: Repository, https://github.com/PrimeIntellect-ai/prime.git
Author-email: Prime Intellect <contact@primeintellect.ai>
License: MIT
Keywords: mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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 :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: fastmcp>=0.2.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.13.1; extra == 'dev'
Description-Content-Type: text/markdown

# Prime MCP Server

Model Context Protocol (MCP) server for Prime Intellect - manage GPU pods, check availability, and control compute resources through MCP.

## Features

- **GPU Availability Checking** - Search for available GPU instances across providers
- **Pod Management** - Create, list, monitor, and delete GPU pods
- **Cluster Support** - Check multi-node cluster availability
- **SSH Key Management** - Manage SSH keys for pod access

## Demo

![Prime MCP Demo](https://raw.githubusercontent.com/PrimeIntellect-ai/prime/main/packages/prime-mcp-server/mcp-demo.gif)

## Installation

```bash
pip install prime-mcp-server
```

Or with uv:
```bash
uv pip install prime-mcp-server
```

## Configuration

Prime MCP uses `prime-core` for configuration, which supports multiple authentication methods:

### Option 1: Environment Variable
```bash
export PRIME_API_KEY="your-api-key"
```

### Option 2: Prime CLI Login (Recommended)
```bash
prime login
```
This stores your API key in `~/.prime/config.json` and is shared across all Prime tools.

### Option 3: Config File
Manually edit `~/.prime/config.json`:
```json
{
  "api_key": "your-api-key",
  "base_url": "https://api.primeintellect.ai"
}
```

## Quick Start

### Running the MCP Server

```bash
python -m prime_mcp.mcp
```

The server runs over stdio and can be integrated with MCP clients (like Claude Desktop, IDEs, or other MCP-compatible tools).

## Available Tools

For complete documentation of all available tools and their parameters, see [docs.primeintellect.ai](https://docs.primeintellect.ai/api-reference/introduction).

## Development

```bash
# Clone the repo
git clone https://github.com/PrimeIntellect-ai/prime.git
cd prime/packages/prime-mcp-server

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run linter
uv run ruff check .
```

## Related Packages

- **`prime`** - Full CLI + SDK with pods, sandboxes, inference, and more
- **`prime-sandboxes`** - SDK for managing remote code execution environments
- **`prime-evals`** - SDK for managing model evaluations
