# AVCodex MCP Server Overview

Connect Claude Code, Cursor, or any MCP client to your AVCodex agents to build, configure, and run them from your editor.

---

The AVCodex MCP Server connects Claude Code, Cursor, or any Model Context Protocol (MCP) client directly to your AVCodex agents. Your AI assistant can read, create, and manage your AVCodex agents programmatically. For an AV programmer, that means you can scaffold a tier-1 support agent, load a Crestron module library, and test prompts without ever leaving your editor.

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

## What you can do

Once connected, your AI assistant can:

- **List and read agents.** See every AVCodex agent and its configuration.
- **Create new agents.** Spin up a new AI agent with a custom persona, model, and settings (a Crestron tier-1 support agent, an RFP responder, a commissioning checklist agent).
- **Chat with agents.** Test your agents by sending messages and getting responses.
- **Update agents.** Modify configurations, system prompts, and capabilities.
- **Manage knowledge sources.** Upload and organize knowledge bases for RAG (Biamp Tesira PDFs, AS-built drawings, internal SOPs).
- **Manage custom actions.** Create, update, and test API integrations (open a service ticket, query a control system from the field).
- **View analytics.** Access usage data, conversation metrics, and engagement stats.
- **Run evaluations.** Test agent quality with automated evals before you put them in front of techs or clients.
- **Manage tags.** Configure intent detection and message tagging.
- **AI prompt engineering.** Generate and improve system prompts with AI assistance.
- **Model recommendations.** Get AI-powered model selection advice.
- **Manage deployments.** Configure Slack, WhatsApp, Email, and Voice channels.

## Quick start

Add AVCodex to your Claude Code configuration (`~/.claude.json`):

```json
{
  "mcpServers": {
    "avcodex": {
      "url": "https://app.avcodex.com/mcp",
      "transport": "streamable-http"
    }
  }
}
```

Then authenticate and start building:

```
"List all my AVCodex agents"
"Create a new tier-1 Crestron support agent called RoomMedic"
"Update the system prompt for my RFP responder"
"Chat with my RoomMedic: TSW-1070 shows offline, how do I check the Cresnet bus?"
```

## Detailed guides

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

## Quick reference

| Property | Value |
|----------|-------|
| **Server URL** | `https://app.avcodex.com/mcp` |
| **Protocol** | JSON-RPC 2.0 over Streamable HTTP |
| **Authentication** | OAuth 2.0 with PKCE, or API Keys (`avcodex_sk_*`) |
| **Access Token Format** | `avcodex_at_xxx` (1 hour expiry) |
| **Refresh Token Format** | `avcodex_rt_xxx` (30 day expiry) |
| **API Key Format** | `avcodex_sk_xxx` (configurable expiry) |

## Rate limits

| Tier | Requests/minute |
|------|-----------------|
| FREE | Not available |
| BUILDER | 30 |
| STUDIO | 60 |
| STUDIO PRO | 120 |
| ENTERPRISE | Unlimited |

## Related

- Building Custom MCP Servers. Create your own MCP integrations.
- Consumer OAuth for MCP. Per-user OAuth for end-users.
- MCP Pro Actions Overview. Connect to 20+ enterprise services.
- API Reference. Direct API access without MCP.

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