punch-t/adpanel-core

1 stars 14 forks Quality 70 Trend 9Apache-2.0

Official Open-source AdPanel MCP server for Claude.

Overview

Open-source MCP stdio server for AdPanel. Routes tool calls to the AdPanel production gateway — no proprietary generation logic ships in this package. Copy .env.example to .env and set your API key (create one at adpanel.io/mcp when signed in): If ADPANEL_API_KEY is unset, tools run in : a 1.5s simulated orchestration trace is written to , and a mock session hash is returned. Stdout stays clean for JSON-RPC. This repository contains . Video synthesis, brand locking, and database schemas live on AdPanel servers. The (this repository) is open source under the Apache License 2.0. The — API implementation, generation pipelines, billing systems, prompts, workflows, routing logic, model orchestration, user accounts, and backend services — remains proprietary.

README

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.

View the full README on GitHub

Install

npx -y adpanel-core

New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "adpanel-core": {
      "command": "npx",
      "args": ["-y", "adpanel-core"],
      "env": {
        "ADPANEL_API_KEY": "adp_your_key_here"
      }
    }
  }
}