DistributionOS
Get API Now
API/MCP docs

Connect your coding agent to DistributionOS.

These docs cover the current setup path: app-scoped API keys, Brain Doc context, SEO brief handoffs, shipped URL reporting, and analytics setup.

Getting started

  1. 1. Join now and create or select an app.
  2. 2. Create or improve the Brain Doc so your agent has positioning and product context.
  3. 3. Create a write-scoped API key from the dashboard.
  4. 4. Add the key and app ID to your coding agent or MCP config.
  5. 5. Ask the agent to read context, create a brief or handoff artifact, ship the work, and report what shipped.

Authentication

API keys use bearer authentication and are scoped to a single app. The full key is shown once, then only the last four characters are visible in the dashboard.

Authorization: Bearer dos_live_...
Content-Type: application/json

read

Use for context-only agent workflows.

write

Use for normal artifact creation and reporting.

admin

Use sparingly for automation that manages access.

MCP setup

The intended MCP shape is simple: your agent receives an app ID and API key, then reads DistributionOS context before creating or reporting marketing work. Confirm the exact server package/config in your setup instructions before treating this as production setup.

# Agent environment
DISTRIBUTION_OS_API_KEY=dos_live_...
DISTRIBUTION_OS_APP_ID=app_...

# MCP server name
distribution-os

Plans and credits

Builder

$29/mo/app

Per subscribed app: 30 brief handoffs, 20 included media credits, and 25 fresh research runs per month.

Distributor

$69/mo/app

Per subscribed app: 100 brief handoffs, 75 included media credits, and 100 fresh research runs per month.

Hosted article generation is disabled. DistributionOS provides context, research, briefs, media credits, and reporting; your agent writes, edits, publishes, and reports the shipped URL. Hosted images for social, landing, launch, blog/page, and video reference assets can use included media credits first, then account-shared top-up credits.

Current resources

Brain Doc

GET /api/v1/apps/{appId}/brain

Read positioning and marketing memory.

Brain patch

POST /api/v1/apps/{appId}/brain/patch

Update structured Brain Doc context.

Brief handoff

POST /api/v1/apps/{appId}/artifacts

Create a content_brief or distribution handoff for your agent.

Report implementation

POST /api/v1/apps/{appId}/artifacts/{artifactId}/report-implementation

Attach the shipped URL and verification details.

API keys

Dashboard API Keys page

Create, reveal once, list, and revoke keys.

Troubleshooting

  • Invalid key: revoke it, create a new one, and update your local agent config.
  • App mismatch: make sure the API key and app ID belong to the same app.
  • Payment or access paused: API/MCP usage should stop until account access is restored.
  • No useful output: improve the Brain Doc before asking the agent to create briefs or distribution work.

Need a key?

Create an app-scoped key in the dashboard, then come back here with your app ID.

Get API Now