# AVCodex MCP Server

Connect any MCP client to manage your AVCodex agents programmatically.

---

The AVCodex MCP Server lets AI assistants like Claude Code, Cursor, and other Model Context Protocol (MCP) clients read, create, and manage your AVCodex agents programmatically. For an integrator, that means scaffolding a fleet of agents (one per client, one per product line, one per service tier) without clicking through the UI for each.

> **Note:** MCP server access requires a Builder plan or higher. [Upgrade to Builder](https://app.avcodex.com/plans)

## Why use the MCP server?

| Use case | Without MCP | With MCP |
|----------|-------------|----------|
| Spin up 10 client-specific support agents | Click through the UI 10 times | One conversation with your AI |
| Update prompts across agents | Open each agent, edit, save | "Update all my agents to use GPT-4o" |
| Bulk-add knowledge sources | Upload files one by one | "Add these 50 Crestron and Biamp PDFs to my design agent" |
| Monitor analytics | Check the dashboard daily | "Show me agents with low CSAT this week" |
| Run evaluations | Manual testing | "Run evals on all tier-1 support agents" |

## Comparison: MCP vs API vs Pro Actions

| Feature | MCP Server | REST API | Pro Actions |
|---------|------------|----------|-------------|
| **Best for** | AI-assisted workflows | Custom integrations | Connecting external services |
| **Authentication** | OAuth 2.0 + PKCE, or API Keys | API Keys | OAuth per service |
| **Rate limits** | Tier-based | Tier-based | Per service limits |
| **Scope** | Full AVCodex platform | Full AVCodex platform | External services only |
| **Typical user** | Programmers using AI tools | Backend developers | No-code builders |

## What you can do

Once connected, your AI assistant can manage agents, knowledge sources, custom actions, deployments, evaluations, and analytics across your AVCodex workspace.

## Quick start

### 1. Add to your MCP client

Add the AVCodex server to your configuration.

**Claude Code** (`~/.claude.json`):
```json
{
  "mcpServers": {
    "avcodex": {
      "url": "https://app.avcodex.com/mcp",
      "transport": "streamable-http"
    }
  }
}
```

**Cursor** (Settings, MCP):
```json
{
  "avcodex": {
    "url": "https://app.avcodex.com/mcp",
    "transport": "streamable-http"
  }
}
```

### 2. Authenticate

When you first use an AVCodex tool, your client will open a browser window. Log in with your AVCodex account to authorize access.

Alternatively, use an API key for non-interactive authentication. See API Keys.

### 3. Start building

```
"List all my AVCodex agents"
"Create a tier-1 support agent called RoomMedic for Acme AV's portfolio"
"Add https://docs.biamp.com/tesira to my design agent's knowledge base"
"Show me conversation analytics for my Crestron support bot for the past week"
```

## Server details

| Property | Value |
|----------|-------|
| **Server URL** | `https://app.avcodex.com/mcp` |
| **Discovery** | `https://app.avcodex.com/.well-known/oauth-authorization-server` |
| **Protocol** | JSON-RPC 2.0 over Streamable HTTP |
| **Authentication** | OAuth 2.0 with PKCE, or API Keys |

## Guides

- Setup
- Authentication
- Rate limits
- Tools reference
- Workflows

## Need help?

- Troubleshooting Guide.
- Email support@avcodex.com.
- Join the AVCodex community for peer help.

*AVCodex · Your AV expertise. Amplified by AI.*