Mint an API key
Create a key in the Brandplio dashboard. Keys are enterprise-scoped, prefixed bvp_, rotate with one click, and scope per brand.
# app.brandplio.com → API keys → New key $ export BRANDPLIO_API_KEY="bvp_live_7f2a…"
Three ways to deliver brand: a public REST API for custom code, a Model Context Protocol server for agents, and a drop-in skill that content creators load into Claude, ChatGPT, or Slack.
# Fetch channel-aware brand context for a combination curl "https://api.brandplio.com/api/acme/context?\ persona=ops-director&product=platform&tone=reassuring&channel=email" \ -H "Authorization: Bearer $BRANDPLIO_API_KEY" \ -H "X-Brand-Id: prod" # ─► 200 OK { "prompt": "You are writing as the Brandplio voice for Ops Directors…", "tensions": [], "version": "rev_2024_11_14.07" }
// Node 18+ or the browser — no SDK, just fetch const params = new URLSearchParams({ persona: "ops-director", product: "platform", tone: "reassuring", channel: "email", }); const res = await fetch( `https://api.brandplio.com/api/acme/context?${params}`, { headers: { "Authorization": `Bearer ${process.env.BRANDPLIO_API_KEY}`, "X-Brand-Id": "prod", } }, ); const { prompt, tensions } = await res.json(); if (tensions.length) reviewQueue.flag(tensions);
# pip install requests — no SDK needed import os, requests res = requests.get( "https://api.brandplio.com/api/acme/context", params={ "persona": "ops-director", "product": "platform", "tone": "reassuring", "channel": "email", }, headers={ "Authorization": f"Bearer {os.environ['BRANDPLIO_API_KEY']}", "X-Brand-Id": "prod", }, ) ctx = res.json() if ctx["tensions"]: review_queue.flag(ctx["tensions"])
Create a key in the Brandplio dashboard. Keys are enterprise-scoped, prefixed bvp_, rotate with one click, and scope per brand.
# app.brandplio.com → API keys → New key $ export BRANDPLIO_API_KEY="bvp_live_7f2a…"
Ask for a persona × product × tone bundle, optionally shaped for a channel. You get a ready-to-use prompt block back.
GET /api/acme/context
?persona=ops-director
&product=platform
&tone=reassuring
Drop the prompt block into your system prompt, or connect your MCP client to our hosted server and let agents consume brand natively.
$ claude mcp add --transport http brandplio \ https://mcp.brandplio.com \ --header "Authorization: Bearer $KEY"
Four endpoints, one auth header, predictable JSON.
/api/:enterprise/context
Assemble a brand-aligned prompt block for a persona, product, and tone. Optionally shape it for a channel (email, web, linkedin, x, instagram).
curl "…/api/acme/context?\ persona=ops-director&product=platform&\ tone=reassuring&channel=email" \ -H "Authorization: Bearer $KEY" \ -H "X-Brand-Id: prod"
{ "prompt": "You are writing as Brandplio…", "tensions": [ { "kind": "tone_persona_conflict", "severity": "warn" } ], "version": "rev_2024_11_14.07" }
/api/:enterprise/combinations
List all pre-built persona × product × tone combinations for a brand. Useful for agent catalogs and LLM tool discovery.
curl "…/api/acme/combinations" \ -H "Authorization: Bearer $KEY"
[ { "id": "cmb_9jV1…", "slug": "ops-director-platform-reassuring", "label": "Ops Director · Platform · Reassuring", "channels": ["email", "linkedin", "web_copy"] } ]
/api/:enterprise/prompts/:combination_id
Fetch the stored, pre-assembled prompt for a specific combination.
Channel-aware via ?channel=, returns plain text or JSON.
curl "…/api/acme/prompts/cmb_9jV1?channel=email" \ -H "Authorization: Bearer $KEY" \ -H "Accept: text/plain"
You are writing as Brandplio, the brand voice platform.
Audience: Operations Directors managing multiple brands.
Tone: Reassuring. Acknowledge risk, lead with control.
Channel: Email. Subject under 60 chars, one clear ask…
/api/:enterprise/prompts
Enumerate every stored prompt across the brand, with metadata for combination, channel, version, and last-updated timestamp. Useful for syncing a read-through cache in your own infrastructure.
curl "…/api/acme/prompts?limit=50" \ -H "Authorization: Bearer $KEY"
{ "data": [ { "combination_id": "cmb_9jV1", "channel": "email", "version": "rev_2024_11_14.07", "updated_at": "2024-11-14T10:18:22Z" } ], "next": "/api/acme/prompts?cursor=…" }
Point any MCP-compatible client at Brandplio and your brand becomes a first-class tool. Agents can list combinations, resolve catalog items, and pull context without a single line of glue code.
http—connect a URL, nothing to install or run.
// ~/Library/Application Support/Claude/claude_desktop_config.json { "mcpServers": { "brandplio": { "url": "https://mcp.brandplio.com", "headers": { "Authorization": "Bearer bvp_live_7f2a…", "X-Brand-Id": "prod" } } } }
// ~/.cursor/mcp.json { "mcpServers": { "brandplio": { "url": "https://mcp.brandplio.com", "headers": { "Authorization": "Bearer bvp_live_7f2a…" } } } }
Ship a pre-built skill that content creators paste into Claude, ChatGPT, or Slack. The skill asks the right questions, pulls context through the MCP server or REST API, and returns on-brand output with a short summary of the decisions it made.
Keys belong to your account, not a single user. Scope them per brand, rotate them in place, and revoke with immediate effect across every agent that was using them.
X-Brand-Id or ?brand=, otherwise falls back to your default brand.
Built on a modern stack
Grab a sandbox API key, ship the first integration in an afternoon, and let us show you the MCP story on a 30-minute call.