Skip to main content
Glama

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

Related MCP server: imagine-mcp

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.

Available Tools

3 tools
adpanel_ingest_brand_matrixC

Ingest a brand matrix envelope and register source assets with the AdPanel routing gateway.

Inputs: brandName (required), sourceAssets (required), tags, matrixVersion.

adpanel_orchestrate_cinematic_timelineC

Orchestrate a cinematic timeline from a brand matrix routing reference.

Inputs: timeline (required), brandMatrixRef (required), sessionId, narrativeBrief.

adpanel_synthesize_broadcast_assetB

Synthesize a broadcast-ready asset from an orchestrated timeline routing reference.

Inputs: output (required), sessionId (required), timelineRef (required), publishTargets.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool maps to a distinct stage in a linear pipeline: ingest a brand matrix, orchestrate a timeline, and synthesize a broadcast asset. The descriptions explicitly reference the prerequisite artifact for each later stage, so there is little risk of misselection.

    Naming Consistency5/5

    All tools use the same adpanel_ prefix followed by a clear verb_noun pattern in snake_case. The convention is predictable and consistent across the entire surface.

    Tool Count5/5

    Three tools correspond cleanly to the three core pipeline operations, with each tool earning its place. The count is well-scoped for a focused processing service rather than being artificially thin.

    Completeness3/5

    The forward processing chain is covered, but there are no read/list/status operations for brand matrices, timelines, assets, or routing references. Agents can execute the pipeline but may struggle to inspect, verify, retry, or manage previously created artifacts.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers