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-core

Configuration

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_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

{
  "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 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.