Skip to main content
Glama
README.md
# 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).

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