Agent access · MCP

Connect your AI agent to ChannelFuel

ChannelFuel is an MCP server: every step of the pipeline — niche research, teardowns, scripting, packaging — is a tool your own AI agent can call. Agent calls spend the same credits and face the same gates and verdicts as the buttons in the app, so an agent can't produce slop through ChannelFuel any more than a human can.

Endpoint · streamable HTTP

https://channelfuel.app/api/mcp

Authentication

Standard MCP OAuth: your client opens this site, you approve once. Prefer a key for scripts? Create one in Settings → Agent access. Revoke either anytime.

Set up your client

Add the endpoint with no credentials — your client opens the browser and you click Approve. Every block below works that way; the API-key variant is at the end for scripts and CI.

claude.ai + Claude Desktop

Settings → Connectors → Add custom connector → paste the URL. Claude opens the sign-in page; approve and the tools appear in every chat.

https://channelfuel.app/api/mcp

Claude Code

One command, then run /mcp inside a session to trigger the browser sign-in.

claude mcp add --transport http channelfuel https://channelfuel.app/api/mcp

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global). Cursor shows 'Needs login' next to the server — click it and approve in the browser.

{
  "mcpServers": {
    "channelfuel": { "url": "https://channelfuel.app/api/mcp" }
  }
}

OpenAI Codex CLI

Add to ~/.codex/config.toml, then run `codex mcp login channelfuel` to open the browser sign-in.

[mcp_servers.channelfuel]
url = "https://channelfuel.app/api/mcp"

VS Code (Copilot agent mode)

Add to .vscode/mcp.json and start the server from the MCP view — VS Code walks you through the browser sign-in.

{
  "servers": {
    "channelfuel": { "type": "http", "url": "https://channelfuel.app/api/mcp" }
  }
}

Anything else (generic bridge)

Any stdio-only client can bridge with mcp-remote — it handles the browser sign-in itself:

npx -y mcp-remote https://channelfuel.app/api/mcp

Scripts, CI & the Claude API — use an API key

Headless callers can't click Approve. Create a key in Settings → Agent access and send it as a bearer token; on the Claude Messages API pass it as authorization_token.

# any HTTP client
Authorization: Bearer cf_live_…

# Claude API
"mcp_servers": [{
  "type": "url",
  "url": "https://channelfuel.app/api/mcp",
  "name": "channelfuel",
  "authorization_token": "cf_live_…"
}]

Under the hood: the endpoint implements standard MCP OAuth — discovery via /.well-known, dynamic client registration, PKCE, refresh-token rotation. Any client that follows the MCP auth spec connects with zero manual credentials, and every connection shows up (and can be revoked) in Settings → Agent access.

The tools

Credited tools debit your workspace balance exactly like the UI — and refund automatically if the job fails. Gates are enforced server-side: no script without a torn-down comparable, no thumbnail before a chosen title, and cover-test overrides are logged against your own results.

Tool	What it does	Cost
get_workspace	Workspace, plan, credit balance + price list	free
list_channels / list_styles	Channels with locked style + format; the style catalog	free
list_projects / get_project	Pipeline status; full gate state, script, packaging, publishes	free
list_teardowns / get_teardown	Your comparables; one full teardown blueprint	free
get_niche_report	A finished scan with EV ranking + evidence grades	free
run_niche_scan	Sweep YouTube for outliers in a niche, rank by EV, grade the evidence	25 cr
run_teardown	Reverse-engineer a viral video into a blueprint (comparable)	40 cr
create_video_project	Start a video on a channel (long-form or Short)	free
prefill_worksheet	Attention-architecture worksheet from the comparable	10 cr ×model
generate_script	Retention-engineered script + scorecard	150 cr ×model ×length
generate_titles	6-8 cover-tested title + hook concepts	15 cr ×model
generate_thumbnails	3 thumbnail variants for the chosen title	60 cr
generate_metadata	Spam-safe description + tags	10 cr ×model
choose_packaging	Pick title/thumbnail — cover-test verdict, overrides logged	free

Publishing to YouTube isn't exposed over MCP yet — connect the channel and schedule from the app. Agents also can't bypass plan limits: publishing needs a paid plan either way.

Ready to hand your agent the keys?

Add the endpoint, click Approve in the browser, and your agent is in. New workspaces start with 200 free credits — enough for a scan, a teardown and a script.

Start free