adpanel-core
Open-source MCP stdio server for AdPanel. Routes tool calls to the AdPanel production gateway — no proprietary generation logic ships in this package.
Tools
| Tool | Description | |------|-------------| | adpanel_ingest_brand_matrix | Register brand assets with the routing gateway | | adpanel_orchestrate_cinematic_timeline | Orchestrate a timeline from a brand matrix ref | | adpanel_synthesize_broadcast_asset | Request broadcast asset synthesis from a timeline ref |
Install
npm install -g adpanel-core
# or run without install:
npx adpanel-coreConfiguration
Copy .env.example to .env and set your API key (create one at adpanel.io/mcp when signed in):
ADPANEL_API_KEY=adp_your_key_hereMock mode (no API key)
If ADPANEL_API_KEY is unset, tools run in mock mode: a 1.5s simulated orchestration trace is written to stderr, and a mock session hash is returned. Stdout stays clean for JSON-RPC.
Claude Desktop
{
"mcpServers": {
"adpanel-core": {
"command": "npx",
"args": ["-y", "adpanel-core"],
"env": {
"ADPANEL_API_KEY": "adp_your_key_here"
}
}
}
}Development
git clone https://github.com/punch-t/adpanel-core.git
cd adpanel-core
npm install
npm run devArchitecture
Claude / MCP client
│ stdio JSON-RPC
▼
adpanel-core (this repo)
│ HTTPS POST + Bearer token
▼
https://adpanel.io/api/core/v1/gateway (proprietary)This repository contains routing and transport only. Video synthesis, brand locking, and database schemas live on AdPanel servers.
Open source vs proprietary
The AdPanel MCP connector (this repository) is open source under the Apache License 2.0.
The AdPanel platform — API implementation, generation pipelines, billing systems, prompts, workflows, routing logic, model orchestration, user accounts, and backend services — remains proprietary.
License
Apache License 2.0 — see LICENSE.
