
Plan, draft and schedule social posts in your own voice, with your review before anything goes out.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <agent key>. Create the key in Borker under Settings, Keys. Docs: https://www.borker.xyz/docs/agent-api/mcp
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Create a draft from text YOU supply, for the channel you name in channelId (from list_channels). Consumes NO generation credit (no AI runs), but the draft is still checked against the workspace's sensitivity rules and the AI-ism scan, and the returned item says what either found. A draft needs its channel: a call that names none (a platform alone included) fails with validation_error naming the connected channels and their ids, and no draft is created. The draft lands in the review pipeline with a time: pass scheduledAt (ISO, in the future) to pick it, or leave it out and the draft takes its channel's next open time under the workspace's plan; the returned item's scheduledAt says which. Autopilot approves and publishes only the posts Borker plans itself. A post an agent creates stays a draft until a person approves it or the agent schedules it through the API, within the workspace's checks: the length limit and URL credits. A draft marked sensitive comes back with its reasons and is not stopped: a key with write scope can still schedule it. Attach images with media: [{url} | {id}] (a public image URL Borker fetches and checks, or an id from request_media_upload / list_media); a failing image fails the call and no draft is created. For an X THREAD, format the body with the numbered joiner — 1/ first tweet, blank line, 2/ second tweet — each tweet 280 chars or less on a free-tier channel. Separators like --- or **Reply N:** are legacy and are refused at publish.
The post text
Images to attach, in publish order. Each entry is {url} (a public https image URL Borker fetches and validates: JPEG, PNG, GIF or WebP, 4.5MB at most) or {id} (an upload id from request_media_upload or list_media). All or nothing: one failing image fails the call with a sentence naming it. The channel's platform caps how many (X 4, LinkedIn 9, Farcaster 2).
Paragraph only: the blog title, which is a separate field from the body. Set it or the essay publishes as 'Untitled'. Ignored on other platforms.
The channel the draft is for, from list_channels. Required.
Accepted as an alternative to channelId, but a draft targets ONE channel — pass exactly one id. To post to several channels, use generate_content.
ISO timestamp in the future for when the draft should go out once approved. Omit it and the draft takes its channel's next open time.
Optional, up to 255 characters, your own choice (a UUID works). Send the same key when you retry a call that timed out or failed in transit: within 24 hours the retry returns the draft the first call created, same id, instead of creating a second. A different key creates a new draft. Keys are per workspace.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://borker.xyz/api/v1/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Bearer <agent key>. Create the key in Borker under Settings, Keys. Docs: https://www.borker.xyz/docs/agent-api/mcpCreate a draft from text YOU supply, for the channel you name in channelId (from list_channels). Consumes NO generation credit (no AI runs), but the draft is still checked against the workspace's sensitivity rules and the AI-ism scan, and the returned item says what either found. A draft needs its channel: a call that names none (a platform alone included) fails with validation_error naming the connected channels and their ids, and no draft is created. The draft lands in the review pipeline with a time: pass scheduledAt (ISO, in the future) to pick it, or leave it out and the draft takes its channel's next open time under the workspace's plan; the returned item's scheduledAt says which. Autopilot approves and publishes only the posts Borker plans itself. A post an agent creates stays a draft until a person approves it or the agent schedules it through the API, within the workspace's checks: the length limit and URL credits. A draft marked sensitive comes back with its reasons and is not stopped: a key with write scope can still schedule it. Attach images with media: [{url} | {id}] (a public image URL Borker fetches and checks, or an id from request_media_upload / list_media); a failing image fails the call and no draft is created. For an X THREAD, format the body with the numbered joiner — 1/ first tweet, blank line, 2/ second tweet — each tweet 280 chars or less on a free-tier channel. Separators like --- or **Reply N:** are legacy and are refused at publish.
| Argument | Type | Description |
|---|---|---|
| body* | string | The post text |
| media | array | Images to attach, in publish order. Each entry is {url} (a public https image URL Borker fetches and validates: JPEG, PNG, GIF or WebP, 4.5MB at most) or {id} (an upload id from request_media_upload or list_media). All or nothing: one failing image fails the call with a sentence naming it. The channel's platform caps how many (X 4, LinkedIn 9, Farcaster 2). |
| title | string | Paragraph only: the blog title, which is a separate field from the body. Set it or the essay publishes as 'Untitled'. Ignored on other platforms. |
| topic | string | |
| channelId | string | The channel the draft is for, from list_channels. Required. |
| channelIds | array | Accepted as an alternative to channelId, but a draft targets ONE channel — pass exactly one id. To post to several channels, use generate_content. |
| scheduledAt | string | ISO timestamp in the future for when the draft should go out once approved. Omit it and the draft takes its channel's next open time. |
| idempotencyKey | string | Optional, up to 255 characters, your own choice (a UUID works). Send the same key when you retry a call that timed out or failed in transit: within 24 hours the retry returns the draft the first call created, same id, instead of creating a second. A different key creates a new draft. Keys are per workspace. |
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "string",
"description": "The post text"
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "An upload id Borker already holds"
},
"url": {
"type": "string",
"description": "A public image URL"
}
}
},
"description": "Images to attach, in publish order. Each entry is {url} (a public https image URL Borker fetches and validates: JPEG, PNG, GIF or WebP, 4.5MB at most) or {id} (an upload id from request_media_upload or list_media). All or nothing: one failing image fails the call with a sentence naming it. The channel's platform caps how many (X 4, LinkedIn 9, Farcaster 2)."
},
"title": {
"type": "string",
"description": "Paragraph only: the blog title, which is a separate field from the body. Set it or the essay publishes as 'Untitled'. Ignored on other platforms."
},
"topic": {
"type": "string"
},
"channelId": {
"type": "string",
"description": "The channel the draft is for, from list_channels. Required."
},
"channelIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Accepted as an alternative to channelId, but a draft targets ONE channel — pass exactly one id. To post to several channels, use generate_content."
},
"scheduledAt": {
"type": "string",
"description": "ISO timestamp in the future for when the draft should go out once approved. Omit it and the draft takes its channel's next open time."
},
"idempotencyKey": {
"type": "string",
"description": "Optional, up to 255 characters, your own choice (a UUID works). Send the same key when you retry a call that timed out or failed in transit: within 24 hours the retry returns the draft the first call created, same id, instead of creating a second. A different key creates a new draft. Keys are per workspace."
}
}
}Delete a content item (any state except published — published items are immutable). Cancels a scheduled external post best-effort first.
| Argument | Type | Description |
|---|---|---|
| id* | string | Content item id (UUID) |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Content item id (UUID)"
}
}
}Have Borker GENERATE a post from a prompt in the workspace's brand voice, one item per channel id in channelIds (get the ids from list_channels). Borker never picks a channel for you: a call that names none fails with validation_error naming the connected channels and their ids, and nothing is generated. Consumes one generation credit per channel against the monthly quota (free on BYOK plans). Fails with generation_limit when the quota is exhausted.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | What the post should be about |
| channelIds* | array | The channels to write for, one post per id, from list_channels. Required: an empty or missing list is refused. |
{
"type": "object",
"required": [
"prompt",
"channelIds"
],
"properties": {
"prompt": {
"type": "string",
"description": "What the post should be about"
},
"channelIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "The channels to write for, one post per id, from list_channels. Required: an empty or missing list is refused."
}
}
}Read the workspace's voice profile: its identity prose (tagline, motto, mission, what it is), the About-you facts (the only claims that may be made about this workspace; the tagline and mission are claims too and are not repeated inside the facts), the standing rules for how the writing sounds, and the subjects to avoid. Use this to write in-character, and never assert anything about the workspace that the facts and the prose do not state.
No arguments.
{
"type": "object",
"properties": {}
}Fetch one content item by id, including its status, channel and its voice, topic, title (Paragraph), and full text.
| Argument | Type | Description |
|---|---|---|
| id* | string | Content item id (UUID) |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Content item id (UUID)"
}
}
}Read how the workspace is scheduled: config (timezone, approval mode, per-voice gate settings under voices.you and voices.brand, which apply by each channel's voice from list_channels, and the match threshold a source item must clear), cadence (one row per connected channel: its voice, how often it posts and whether that pulse is on) and planned (the plan items for the coming 14 days: channel, target date and time, state, and the content id once a post is written).
No arguments.
{
"type": "object",
"properties": {}
}Workspace content analytics over a rolling window: per-channel post balance by status, pipeline depth, source mix, AI-ism flag rate, and generation quota usage. Use it to spot starved channels or a thin pipeline.
| Argument | Type | Description |
|---|---|---|
| days | integer | Window in days (default 30) |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Window in days (default 30)"
}
}
}List the workspace's connected social channels (X, LinkedIn, Threads, Bluesky, Farcaster, Paragraph) with their ids, handles, subscription tier and voice ('personal' speaks as the founder, 'brand' as the company; get_schedule's voices.you governs personal channels and voices.brand the brand ones). Use the channel ids when creating or generating content.
| Argument | Type | Description |
|---|---|---|
| platform | string | Optional platform filter |
{
"type": "object",
"properties": {
"platform": {
"enum": [
"x",
"linkedin",
"linkedin-page",
"farcaster",
"paragraph",
"threads",
"bluesky"
],
"type": "string",
"description": "Optional platform filter"
}
}
}List content items newest-first with cursor pagination. Filter by status (draft/pending/scheduled/publishing/published/failed/cancelled/all), channelId, or source. Returns items plus nextCursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string | Opaque cursor from a previous page |
| source | string | One of api, manual, news_reactive, redistribute, daily_generation, build_log |
| status | string | Status filter, or 'all' (default) |
| channelId | string |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"description": "Opaque cursor from a previous page"
},
"source": {
"type": "string",
"description": "One of api, manual, news_reactive, redistribute, daily_generation, build_log"
},
"status": {
"type": "string",
"description": "Status filter, or 'all' (default)"
},
"channelId": {
"type": "string"
}
}
}List the workspace's uploads that no post has taken yet (id, filename, format, size, createdAt, expiresAt), newest first. Pass an id as {id} in create_content_draft or update_content to attach it. Each is removed 24 hours after upload unless attached.
No arguments.
{
"type": "object",
"properties": {}
}Get an image into Borker so a draft can carry it. With filename alone it answers {mediaId, uploadUrl, expiresAt}: a signed, single-use upload link good for 15 minutes; send the file to it with an HTTP PUT (curl -T photo.png <uploadUrl>), after which mediaId is attachable as {id} in create_content_draft or update_content. With data (the image as base64, 1MB at most) it stores the image now and answers {media: {id, filename, format, size, createdAt, expiresAt}}. Either way the bytes are validated like an upload from the app: JPEG, PNG, GIF or WebP, 4.5MB at most. An upload nobody attaches is removed after 24 hours.
| Argument | Type | Description |
|---|---|---|
| data | string | Optional: the image bytes as base64, 1MB at most. Leave it out to get an upload link for a bigger file. |
| filename* | string | The name the upload is listed under in list_media, e.g. launch.png |
{
"type": "object",
"required": [
"filename"
],
"properties": {
"data": {
"type": "string",
"description": "Optional: the image bytes as base64, 1MB at most. Leave it out to get an upload link for a bigger file."
},
"filename": {
"type": "string",
"description": "The name the upload is listed under in list_media, e.g. launch.png"
}
}
}Approve (if needed) and schedule an item for publishing. Pass scheduledAt (ISO, snapped to 5 minutes, future) for a specific time, or publishNow: true to publish on the next cron tick. Omitting both reuses the time the item is already planned for (a draft from create_content_draft has one: the time it was given at creation), and fails with 400 when it has none, in which case send scheduledAt or publishNow. An item with no channel, or on a disconnected one, fails with 400 validation_error naming the cause: give it a connected channel with update_content's channelId first. Scheduling a draft approves it, so a draft whose text trips the AI-ism scan fails with the match list until you repeat the call with acknowledgeAiIsms: true. Autopilot approves and publishes only the posts Borker plans itself. A post an agent creates stays a draft until a person approves it or the agent schedules it through the API, within the workspace's checks: the length limit and URL credits. A draft marked sensitive comes back with its reasons and is not stopped: a key with write scope can still schedule it.
| Argument | Type | Description |
|---|---|---|
| id* | string | Content item id (UUID) |
| publishNow | boolean | |
| scheduledAt | string | ISO timestamp |
| acknowledgeAiIsms | boolean | Schedule the draft even though the AI-ism scan matched. Send it only after showing the matches to the operator, or rewrite the text instead. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Content item id (UUID)"
},
"publishNow": {
"type": "boolean"
},
"scheduledAt": {
"type": "string",
"description": "ISO timestamp"
},
"acknowledgeAiIsms": {
"type": "boolean",
"description": "Schedule the draft even though the AI-ism scan matched. Send it only after showing the matches to the operator, or rewrite the text instead."
}
}
}Send one build-log entry: a piece of work the person did and confirmed is worth sharing. source is a handle such as build-log; the first entry for a handle creates that source in the workspace (shown as 'Build log' on the Sources page), and a handle already used by one of the workspace's feeds is refused with validation_error naming source. No AI runs and no generation credit is used at supply. A supply places nothing: the entry arrives not yet planned. A source paces its new entries by default: Borker's night run places each new entry, oldest day first, on the next free posting day, and the destination it lands on decides the voice. The person can switch pacing off in Settings, Sources, and then plans entries themselves. Borker writes each post on its day and holds it for review. Pass kind (finding, decision, ship or reversal) and context (background for the writer, never posted) when you have them, and skillVersion to name your version. Answers {id, position, state, kind, context, planned, notPlanned, paces, destinations}: position is the entry's place in the series by happenedAt; a new entry is not_yet_planned with planned and notPlanned null; paces is true when the night run will place it. Pass externalId so a retry is safe: an entry the source already holds under that externalId is returned unchanged, same id, with state planned and planned {date, time} once it is planned, and nothing is created.
| Argument | Type | Description |
|---|---|---|
| body* | string | What happened, in full: at least 40 characters, enough for a post to be written from it. |
| kind | string | Optional: what kind of beat the entry is. finding: something found out. decision: a decision made. ship: something shipped. reversal: something taken back or changed. Borker shapes the post by it. |
| media | array | Optional: at most one image for the entry, {url} or {id} as create_content_draft takes them. Borker keeps it until the entry's day and puts it on every post written from the entry. A failing image fails the call with create_content_draft's validation_error and nothing is supplied. |
Edit a draft/pending item's text, move it to another channel with channelId, and/or move it through the review lifecycle: status 'pending' approves a draft, 'draft' un-approves, 'cancelled' rejects (optionally with rejectionReason). Approving queues the post: at the scheduledAt you pass (ISO-8601, in the future), else at its planned instant, else at the plan's next open time; the result's scheduledAt says the instant it took, and a scheduledAt that has gone by is refused before anything moves. On a scheduled post, status 'pending' unschedules it (the time is cleared and a held URL credit released); schedule_content moves it instead. A draft with no channel, or on a disconnected one, cannot be approved (400 validation_error naming the cause): give it a connected channel with channelId, in the same call or before. Giving an item the channel its plan slot was waiting for can approve and queue it: a draft an auto-approval voice held only for want of a channel is approved (as this key) when its text still passes auto's checks, and an approved item is queued at its planned time; the returned item's status and scheduledAt say where it landed, and plannedTimePassed: true means it stays approved and needs a new time. With status 'draft' the item is un-approved first and moves as a draft. Published items are immutable. Approving a draft whose text trips the AI-ism scan fails with the match list until you repeat the call with acknowledgeAiIsms: true. A post from a piece (one with sourceUrl) goes out with a link to it where its channel puts links (X: its own last post); linkOverride replaces that link with another https address, '' places none, null lets the workspace's Links in posts switch decide again, and the choice is this post's alone. Autopilot approves and publishes only the posts Borker plans itself. A post an agent creates stays a draft until a person approves it or the agent schedules it through the API, within the workspace's checks: the length limit and URL credits. A draft marked sensitive comes back with its reasons and is not stopped: a key with write scope can still schedule it.
| Argument | Type | Description |
|---|---|---|
| id* | string | Content item id (UUID) |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.
| title* | string | The entry's title, up to 200 characters. |
| source* | string | The handle of the source, e.g. build-log, up to 80 characters. Send the same handle for every entry of one series. |
| context | string | Optional, up to 600 characters: what was going on, why it mattered, who it is for. Background for Borker's writer only; it is never posted verbatim. |
| externalId | string | Optional, up to 255 characters, your own stable id for the entry (e.g. session:7c1d#12). Send the same one when you retry. |
| happenedAt* | string | The date the work happened, e.g. 2026-08-23, or a full ISO timestamp. Orders the series. |
| destinations | array | Optional: the channel ids from list_channels the entry goes to, each once. Name one by default, and several only when the entry plainly belongs on more than one. The night run writes one post per named channel, each on that channel's next free posting day; with none named the entry goes to the channel with the next free day. An id that is not one of the workspace's channels fails the call with validation_error naming destinations. A retry keeps the destinations the first call stored. |
| skillVersion | string | Optional, up to 20 characters: the version of the skill or agent sending the entry, e.g. 0.3.0. Borker keeps the last one on the source with when it arrived. |
{
"type": "object",
"required": [
"source",
"title",
"body",
"happenedAt"
],
"properties": {
"body": {
"type": "string",
"description": "What happened, in full: at least 40 characters, enough for a post to be written from it."
},
"kind": {
"enum": [
"finding",
"decision",
"ship",
"reversal"
],
"type": "string",
"description": "Optional: what kind of beat the entry is. finding: something found out. decision: a decision made. ship: something shipped. reversal: something taken back or changed. Borker shapes the post by it."
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "An upload id Borker already holds"
},
"url": {
"type": "string",
"description": "A public image URL"
}
}
},
"maxItems": 1,
"description": "Optional: at most one image for the entry, {url} or {id} as create_content_draft takes them. Borker keeps it until the entry's day and puts it on every post written from the entry. A failing image fails the call with create_content_draft's validation_error and nothing is supplied."
},
"title": {
"type": "string",
"description": "The entry's title, up to 200 characters."
},
"source": {
"type": "string",
"description": "The handle of the source, e.g. build-log, up to 80 characters. Send the same handle for every entry of one series."
},
"context": {
"type": "string",
"maxLength": 600,
"description": "Optional, up to 600 characters: what was going on, why it mattered, who it is for. Background for Borker's writer only; it is never posted verbatim."
},
"externalId": {
"type": "string",
"description": "Optional, up to 255 characters, your own stable id for the entry (e.g. session:7c1d#12). Send the same one when you retry."
},
"happenedAt": {
"type": "string",
"description": "The date the work happened, e.g. 2026-08-23, or a full ISO timestamp. Orders the series."
},
"destinations": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: the channel ids from list_channels the entry goes to, each once. Name one by default, and several only when the entry plainly belongs on more than one. The night run writes one post per named channel, each on that channel's next free posting day; with none named the entry goes to the channel with the next free day. An id that is not one of the workspace's channels fails the call with validation_error naming destinations. A retry keeps the destinations the first call stored.",
"uniqueItems": true
},
"skillVersion": {
"type": "string",
"maxLength": 20,
"description": "Optional, up to 20 characters: the version of the skill or agent sending the entry, e.g. 0.3.0. Borker keeps the last one on the source with when it arrived."
}
}
}| media |
| array |
| Images to attach, in publish order. Each entry is {url} (a public https image URL Borker fetches and validates: JPEG, PNG, GIF or WebP, 4.5MB at most) or {id} (an upload id from request_media_upload or list_media). All or nothing: one failing image fails the call with a sentence naming it. The channel's platform caps how many (X 4, LinkedIn 9, Farcaster 2). On update the list REPLACES the post's images; [] clears them. Draft or pending items only. |
| status | string |
| content | string | Replacement post text |
| channelId | string | Move the draft to this channel (from list_channels): connected, and on the draft's own platform |
| scheduledAt | string | With status 'pending' on a draft: the ISO-8601 instant (in the future) to queue the approved post at. Leave it out and the post takes its planned instant, else the plan's next open time. |
| linkOverride | string | null | The link a post from a piece goes out with: another https address, '' for none, or null to let the workspace's Links in posts switch decide again. Draft or pending items with a sourceUrl only. |
| rejectionReason | string |
| acknowledgeAiIsms | boolean | Approve the draft even though the AI-ism scan matched. Send it only after showing the matches to the operator, or rewrite the text instead. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Content item id (UUID)"
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "An upload id Borker already holds"
},
"url": {
"type": "string",
"description": "A public image URL"
}
}
},
"description": "Images to attach, in publish order. Each entry is {url} (a public https image URL Borker fetches and validates: JPEG, PNG, GIF or WebP, 4.5MB at most) or {id} (an upload id from request_media_upload or list_media). All or nothing: one failing image fails the call with a sentence naming it. The channel's platform caps how many (X 4, LinkedIn 9, Farcaster 2). On update the list REPLACES the post's images; [] clears them. Draft or pending items only."
},
"status": {
"enum": [
"pending",
"draft",
"cancelled"
],
"type": "string"
},
"content": {
"type": "string",
"description": "Replacement post text"
},
"channelId": {
"type": "string",
"description": "Move the draft to this channel (from list_channels): connected, and on the draft's own platform"
},
"scheduledAt": {
"type": "string",
"description": "With status 'pending' on a draft: the ISO-8601 instant (in the future) to queue the approved post at. Leave it out and the post takes its planned instant, else the plan's next open time."
},
"linkOverride": {
"type": [
"string",
"null"
],
"description": "The link a post from a piece goes out with: another https address, '' for none, or null to let the workspace's Links in posts switch decide again. Draft or pending items with a sourceUrl only."
},
"rejectionReason": {
"type": "string"
},
"acknowledgeAiIsms": {
"type": "boolean",
"description": "Approve the draft even though the AI-ism scan matched. Send it only after showing the matches to the operator, or rewrite the text instead."
}
}
}