---
title: "MCP Reference — AVCodex Docs"
description: "MCP Reference — AVCodex documentation for AV integrators, programmers, and ops teams."
lang: en
json-ld:
---

[](/)

Solutions

[Pricing](/pricing)[The Signal](/blog)[Resources](/resources)

Learn

[Free AI Assessment](/scorecard)[Get Started →](/pricing)

[Documentation Home](/docs)

Guides 

Getting Started

-   [The Alchemist Copilot](/docs/guides/the-alchemist-copilot)
-   [Choosing a Model](/docs/guides/choosing-a-model)
-   [Skills & Templates](/docs/guides/skills-and-templates)
-   [Pricing & Usage](/docs/guides/pricing-and-usage)
-   [Understanding Tokens](/docs/guides/understanding-tokens)
-   [Maximize AVCodex Capabilities](/docs/guides/maximize-avcodex-capabilities)

Knowledge & Memory

-   [How Knowledge Sources Work](/docs/guides/how-knowledge-sources-work)
-   [Knowledge Retrieval Settings](/docs/guides/knowledge-retrieval-settings)
-   [User Memory](/docs/guides/user-memory)
-   [Consumer Brain](/docs/guides/consumer-brain)

Agent Capabilities

-   [Image Recognition](/docs/guides/image-recognition)
-   [Image Generation](/docs/guides/image-generation)
-   [Video Generation](/docs/guides/video-generation)
-   [Deep Research and Deep Thinking](/docs/guides/deep-research-and-deep-thinking)
-   [Heartbeat (Proactive AI Outreach)](/docs/guides/heartbeat-proactive-ai-outreach)
-   [Database Connections](/docs/guides/database-connections)
-   [Agent-to-Agent Links](/docs/guides/agent-to-agent-links)
-   [Message Tagging](/docs/guides/message-tagging)
-   [Lead Generation Forms](/docs/guides/lead-generation-forms)
-   [Multilingual Apps](/docs/guides/multilingual-apps)
-   [Understanding Evaluations](/docs/guides/understanding-evaluations)

Design & Experience

-   [Style Studio](/docs/guides/style-studio)
-   [Component Studio](/docs/guides/component-studio)
-   [HQ Profile](/docs/guides/hq-profile)
-   [Multiplayer Chat](/docs/guides/multiplayer-chat)
-   [Circles](/docs/guides/circles)
-   [Desktop Agent](/docs/guides/desktop-agent)

Voice & Phone

-   [Phone Numbers](/docs/guides/phone-numbers)
-   [Outbound Calling](/docs/guides/outbound-calling)
-   [Voice Cloning](/docs/guides/voice-cloning)

Publish & Share

-   [Embed Chat Widget](/docs/guides/embed-chat-widget)
-   [Custom Domains](/docs/guides/custom-domains)
-   [PWA Installation](/docs/guides/pwa-installation)
-   [AVCodex Sites](/docs/guides/avcodex-sites)
-   [Embed on Kajabi](/docs/guides/embed-on-kajabi)
-   [How to Use AVCodex with Claude Code](/docs/guides/how-to-use-avcodex-with-claude-code)

Monetization & Access

-   [Selling Access](/docs/guides/selling-access)
-   [Consumer Monetization](/docs/guides/consumer-monetization)
-   [Access Control](/docs/guides/access-control)
-   [Bring Your Own Auth](/docs/guides/bring-your-own-auth)
-   [Clever SSO for Schools](/docs/guides/clever-sso-for-schools)

Analytics & Operations

-   [Analytics & Chat History](/docs/guides/analytics-and-chat-history)
-   [Performance Dashboard](/docs/guides/performance-dashboard)
-   [Programmatic Usage Stats](/docs/guides/programmatic-usage-stats)
-   [Session Lifecycle Webhooks](/docs/guides/session-lifecycle-webhooks)
-   [Audit Logs](/docs/guides/audit-logs)

Teams & White-Label

-   [Team Management](/docs/guides/team-management)
-   [Enterprise Whitelabel](/docs/guides/enterprise-whitelabel)

Alchemist Platform

-   [Alchemist Tickets](/docs/guides/alchemist-tickets)
-   [Alchemist Getting Started](/docs/guides/alchemist-getting-started)
-   [Alchemist Working with Tickets](/docs/guides/alchemist-working-with-tickets)
-   [Alchemist Local Development](/docs/guides/alchemist-local-development)

Alchemist Operations

-   [Alchemist Environment Variables](/docs/guides/alchemist-environment-variables)
-   [Alchemist Deploys and Domains](/docs/guides/alchemist-deploys-and-domains)
-   [Alchemist Self-Healing](/docs/guides/alchemist-self-healing)

Alchemist API & Automation

-   [Alchemist API Keys](/docs/guides/alchemist-api-keys)
-   [Alchemist MCP Server](/docs/guides/alchemist-mcp-server)
-   [Alchemist Pipeline Configuration](/docs/guides/alchemist-pipeline-configuration)
-   [Alchemist Pipeline Permutations](/docs/guides/alchemist-pipeline-permutations)

Developer Platform

-   [Building Custom MCP Servers](/docs/guides/building-custom-mcp-servers)
-   [Consumer OAuth for Custom MCP Servers](/docs/guides/consumer-oauth-for-custom-mcp-servers)

AVCodex MCP Server

-   [Overview](/docs/guides/overview)
-   [MCP Reference](/docs/guides/mcp-reference)
-   [Setup & Installation](/docs/guides/setup-and-installation)
-   [Authentication](/docs/guides/authentication)
-   [Tools Reference](/docs/guides/tools-reference)
-   [Common Workflows](/docs/guides/common-workflows)
-   [Rate Limits](/docs/guides/rate-limits)

Custom Actions 

Pro Actions 

API 

Builder API 

Agentic Commerce (ACP) 

Integrations 

[Docs](/docs)/ Guides / AVCodex MCP Server 

# MCP Reference

Last updated · MAR 2026 · [Read as Markdown](/docs/guides/mcp-reference.md)

# 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?# ](#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# ](#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# ](#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# ](#quick-start)

### [1\. Add to your MCP client# ](#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# ](#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# ](#3-start-building)

code 

```
"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# ](#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# ](#guides)

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

## [Need help?# ](#need-help)

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

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

Was this helpful? 

[Edit this page →](#)

[

Previous

Overview

](/docs/guides/overview)[

Next

Setup & Installation

](/docs/guides/setup-and-installation)

On this page

-   [Why use the MCP server?](#why-use-the-mcp-server)
-   [Comparison: MCP vs API vs Pro Actions](#comparison-mcp-vs-api-vs-pro-actions)
-   [What you can do](#what-you-can-do)
-   [Quick start](#quick-start)
-   [1\. Add to your MCP client](#1-add-to-your-mcp-client)
-   [2\. Authenticate](#2-authenticate)
-   [3\. Start building](#3-start-building)
-   [Server details](#server-details)
-   [Guides](#guides)
-   [Need help?](#need-help)

[](/)

The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry.

### Platform

-   What You Can Build
-   Templates
-   [Pricing](/pricing)

### Services

-   [Done-For-You](/pricing)
-   [Academy](/academy)
-   [Contact](/contact)

### Company

-   About
-   [The Signal](/blog)
-   [Docs](/docs)
-   [LinkedIn](#)

© 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant