Metadata-Version: 2.4
Name: bonito-mcp
Version: 1.0.0
Summary: MCP server for the Bonito AI Platform – manage providers, models, agents, and gateway routing.
Project-URL: Homepage, https://getbonito.com
Project-URL: Documentation, https://getbonito.com/docs
Project-URL: Repository, https://github.com/ShabariRepo/bonito
Author-email: Bonito AI <hello@getbonito.com>
License-Expression: MIT
Keywords: ai,bonito,gateway,llm,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
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
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# Bonito MCP Server

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that wraps the **Bonito AI Platform** REST API. Use it from Claude Desktop, Cursor, or any MCP-compatible client to manage your multi-provider AI infrastructure.

## Features

- **Provider Management** – Connect and verify AWS Bedrock, Azure OpenAI, GCP Vertex AI, OpenAI, Anthropic, and Groq
- **Model Management** – List, sync, and activate models across providers
- **Unified Gateway** – Send chat completions through Bonito's OpenAI-compatible gateway
- **Agent Management** – Create and execute BonBon and Bonobot agents
- **Knowledge Bases** – Create and manage knowledge bases
- **Cost & Observability** – Track costs per provider and view gateway logs

## Quick Start

### Install from source

```bash
git clone https://github.com/ShabariRepo/bonito.git
cd bonito/mcp-server
pip install -e .
```

### Set your API key

```bash
export BONITO_API_KEY="your-bonito-api-key"
```

### Run (stdio – for Claude Desktop)

```bash
bonito-mcp
```

### Run (SSE – for network clients)

```bash
bonito-mcp --transport sse --port 8080
```

## Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "bonito": {
      "command": "bonito-mcp",
      "env": {
        "BONITO_API_KEY": "your-bonito-api-key"
      }
    }
  }
}
```

## Docker

```bash
docker build -t bonito-mcp .
docker run -e BONITO_API_KEY="your-key" -p 8080:8080 bonito-mcp
```

## Available Tools

| Tool | Description |
|------|-------------|
| `list_providers` | List connected AI providers |
| `connect_provider` | Connect a new provider |
| `verify_provider` | Verify provider credentials |
| `list_models` | List models (with filters) |
| `sync_models` | Sync models from providers |
| `activate_model` | Activate a model for the gateway |
| `chat_completion` | Send a chat completion request |
| `list_gateway_keys` | List gateway API keys |
| `create_gateway_key` | Create a new gateway key |
| `gateway_usage` | View usage statistics |
| `list_agents` | List agents in a project |
| `create_agent` | Create a BonBon or Bonobot agent |
| `execute_agent` | Execute an agent |
| `get_agent` | Get agent details |
| `list_knowledge_bases` | List knowledge bases |
| `create_knowledge_base` | Create a knowledge base |
| `get_costs` | Get cost breakdown by provider |
| `get_gateway_logs` | View gateway request logs |

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `BONITO_API_KEY` | Yes | – | Your Bonito API key |
| `BONITO_API_URL` | No | `https://api.getbonito.com` | API base URL |

## License

MIT
