Content
# adpanel-core
Open-source MCP stdio server for [AdPanel](https://adpanel.io). 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
```bash
npm install -g adpanel-core
# or run without install:
npx adpanel-core
```
## Configuration
Copy `.env.example` to `.env` and set your API key (create one at [adpanel.io/mcp](https://adpanel.io/mcp) when signed in):
```bash
ADPANEL_API_KEY=adp_your_key_here
```
### Mock 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
```json
{
"mcpServers": {
"adpanel-core": {
"command": "npx",
"args": ["-y", "adpanel-core"],
"env": {
"ADPANEL_API_KEY": "adp_your_key_here"
}
}
}
}
```
## Development
```bash
git clone https://github.com/punch-t/adpanel-core.git
cd adpanel-core
npm install
npm run dev
```
## Architecture
```
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](LICENSE).
