Overview & Quickstart
Drive your Borker workspace from any AI agent or script — a stable REST API plus a hosted MCP endpoint, authenticated with workspace agent keys.
Borker isn't just a web app. Everything an agent needs to run your social pipeline — reading your brand voice, creating and approving drafts, scheduling posts, checking channel balance — is available programmatically, two ways:
- REST API at
https://borker.xyz/api/v1— for scripts, CI hooks, and custom integrations. - Hosted MCP endpoint at
https://borker.xyz/api/v1/mcp— for AI agents (Claude Code, Claude Desktop, and any other MCP client). Same capabilities, zero integration code. See Borker MCP.
Both authenticate with a workspace agent key — a bearer token you issue in Settings. A key is scoped to one workspace: it can never see or touch another workspace, and revoking it cuts access instantly.
Quickstart
1. Issue a key. In Borker, go to Settings → Agent Keys → Create key. Pick a name and scopes (Read is enough for this quickstart), then copy the token from the one-time reveal.
The token is shown exactly once. Store it like a password — Borker keeps only a hash and cannot show it again. Lost it? Revoke the key and create a new one.
2. Make a request.
curl https://borker.xyz/api/v1/channels \
-H "Authorization: Bearer bork_live_xxxxxxxx_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"3. You'll get your connected channels back:
{
"channels": [
{
"id": "7d3f…",
"platform": "x",
"displayName": "My Startup",
"handle": "mystartup",
"subscriptionTier": "free",
"isDefault": true,
"isActive": true
}
]
}That's the whole loop: the same token works across every endpoint in the API reference, and powers the MCP endpoint for agents.
What agents can do
| Capability | How |
|---|---|
| Read brand voice, channels, schedule | GET /brand, /channels, /schedule |
| Inspect the pipeline (depth, balance, quota) | GET /stats |
| Add a ready-written draft (free) | POST /content with body |
| Generate a post in your voice (metered) | POST /content with prompt |
| Approve, edit, reject | PATCH /content/:id |
| Schedule or publish | POST /content/:id/schedule |
The credit rule: a generation credit is consumed only when Borker's
AI writes for you. Supplying your own text with body is always
free; prompt counts against your plan's monthly generations (BYOK
and Lifetime plans generate without limits).
Everything an agent creates shows up in your Content Pipeline with an API badge and the key owner's name, and flows through the same review, sensitivity, and approval holds as everything else. Your agent drafts; your pipeline still protects you.