Claude (web, desktop, mobile)
Settings → Connectors → Add custom connector → paste this URL → Connect → Allow in Distributor.
https://mcp.distributoor.com/mcpScoped agent access
Prepare content. Read what worked. Schedule within your limits.
Connect Claude with Distributor sign-in, or use a revocable key for other clients.
https://mcp.distributoor.com/mcp
Each action requires its scope. The tool list below reflects this deployment.
Settings → Agent access (owner login required).
Open Agent access ↗Start with the smallest set of scopes for your task:
read + drafts:write. Add media:write for uploads and bugs:write for reports.read + schedule:posts for own drafts when enabled; add drafts:write to create them. schedule:write only edits weekly times.read for stored results, enabled rounds and touches. Add engage:draft for reply drafts; engage:run opts into bounded sessions that can spend.Claude uses Distributor sign-in. For other clients, set DISTRIBUTOR_TOKEN privately and keep configs out of source control.
Settings → Connectors → Add custom connector → paste this URL → Connect → Allow in Distributor.
https://mcp.distributoor.com/mcpThen open /mcp → Authenticate and allow access in Distributor.
claude mcp add --transport http distributor https://mcp.distributoor.com/mcpOfficial setup docs ↗Create a key in Settings → Agent access. Store DISTRIBUTOR_TOKEN privately; this command saves the expanded key locally.
claude mcp add --transport http distributor https://mcp.distributoor.com/mcp --header "Authorization: Bearer $DISTRIBUTOR_TOKEN"Add to ~/.codex/config.toml, then start Codex with DISTRIBUTOR_TOKEN in its environment.
[mcp_servers.distributor]
url = "https://mcp.distributoor.com/mcp"
bearer_token_env_var = "DISTRIBUTOR_TOKEN"Official setup docs ↗Add to ~/.cursor/mcp.json. Launch Cursor with DISTRIBUTOR_TOKEN in its environment.
{
"mcpServers": {
"distributor": {
"url": "https://mcp.distributoor.com/mcp",
"headers": {
"Authorization": "Bearer ${env:DISTRIBUTOR_TOKEN}"
}
}
}
}Official setup docs ↗Streamable HTTP. A valid token is required, including for tools/list.
curl --fail-with-body https://mcp.distributoor.com/mcp \
-H "Authorization: Bearer $DISTRIBUTOR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' Generated from the live registry. Write tools can save drafts or start bounded work; check the description and scope before calling.
| Tool | Purpose | Required scope | Access |
|---|---|---|---|
get_guide | Concise Markdown: formats and limits, building articles/carousels/threads, media upload, costs, reading, bug reports. | Any valid token | Read |
list_notifications | Read workspace publication and recovery notifications. | read | Read |
list_formats | Formats, limits, JSON schemas, examples, media rules, scopes and X costs. | read | Read |
create_draft | Create a draft for Mark to review in Compose. | drafts:write | Write |
update_draft | Edit your unopened draft, or a Mark-owned draft when drafts:edit_mark is enabled. | drafts:write | Write |
list_drafts | Your drafts, newest first, with status and slot. | read | Read |
get_draft | One of your drafts: status (draft, proposed, scheduled, posted, failed, rejected, expired, discarded), revision, slot, result, Mark's reject note and the change log. | read | Read |
discard_draft | Hide one of your drafts from Mark (soft delete). | drafts:write | Write |
upload_media | Upload a JPEG/PNG/GIF image or a PDF (linkedin_carousel only) as base64, at most 10 MB. | media:write | Write |
list_accounts | Connected destinations (no secrets): platform, name, status, capabilities. | read | Read |
list_history | Publication jobs with status and result links, newest first. | read | Read |
get_job | Status of one publication job (from list_history or list_calendar). | read | Read |
list_calendar | Scheduled, sending and posted items in [start, end) epoch ms (default 30 days back to 90 ahead; max 366 days; truncated flag over 500). | read | Read |
list_insights | Imported posts for one account ranked by a metric. | read | Read |
list_swipe | Saved swipe posts; private snippets, links, images and notes require swipe:read_private as well as read. | read | Read |
save_swipe | Add or update an imported post in the shared swipe file. | swipe:write | Write |
remove_swipe | Remove an imported post from the swipe file. | swipe:write | Write |
report_bug | Tell Mark what went wrong. | bugs:write | Write |
list_bugs | Your reports with status (open, in_progress, fixed, wont_fix) and Mark's note. | bugs:write | Read |
list_angles | Filter shared angles. | angles:read | Read |
get_angle | Full title, context Markdown, source, links and authenticated media URLs (send the same bearer token to fetch). | angles:read | Read |
create_angle | Create an idea in the shared workspace. | angles:write | Write |
update_angle | Edit an angle with optimistic revision checking. | angles:write | Write |
add_angle_note | Append an audit/build note. | angles:write | Write |
list_plug_templates | List your saved plugs. | read or plugs:write | Read |
get_plug_template | Get your plug template. | read or plugs:write | Read |
create_plug_template | Save a plug; never arm or publish it. | plugs:write | Write |
update_plug_template | Update your template; existing proposals keep their snapshot. | plugs:write | Write |
delete_plug_template | Delete your template. | plugs:write | Write |
propose_plug | Propose an owned X draft/job/post plug. | plugs:write | Write |
list_carousel_templates | List your templates, installed fonts, colour tokens and layouts. | read or templates:write | Read |
get_carousel_template | Get your saved carousel template. | read or templates:write | Read |
create_carousel_template | Save layout, installed font, named colour tokens, cover, footer and sample. | templates:write | Write |
update_carousel_template | Update your template; retained draft images do not change. | templates:write | Write |
duplicate_carousel_template | Save a copy of your carousel template. | templates:write | Write |
render_carousel_preview | Render 2–10 offline slide PNG previews, returned as base64. | read or templates:write | Read |
free_slots | Free posting times for one account over [start, end) epoch ms (default now → 7 days; max 14 days), after Mark's gap, per-day cap and posting-window rules, existing scheduled posts and other agents' live holds. | read | Read |
propose_slot | Hold a free slot (from free_slots) for your draft so Mark can approve it. | drafts:write | Write |
release_slot | Give up the slot your proposed draft holds; the draft returns to draft. | drafts:write | Write |
get_schedule | Read the account weekly wall-clock posting slots and timezone. | read | Read |
suggest_slots | Read stored imported-post performance by weekday/hour: sample sizes, medians, post ids and sample-support confidence. | read | Read |
add_schedule_slot | Edit one weekly posting time. | schedule:write | Write |
remove_schedule_slot | Edit one weekly posting time. | schedule:write | Write |
get_what_worked | Compare equal publication windows from stored own posts only. | read | Read |
remix_brief | Return literal stored source structure and a checklist. | read or drafts:write | Write |
propose_nudge | Propose a likes/views reminder for an owned posted X post. | read or plugs:write | Write |
list_nudges | Your proposed/armed/fired nudges, with frozen reply, metric, coverage and monthly spend. | read or plugs:write | Read |
list_trends | Read cached niche posts with coverage, author-baseline sample size and spend receipts. | read | Read |
engage_estimate | Local preview for a preset/audience. | read | Read |
engage_start_session | Requires opt-in engage:run and a confirmed unchanged estimate_id. | engage:run | Write |
engage_results | Stored sampled session posts and signals; no paid reads. | read | Read |
engage_draft_reply | Stores supplied reply text; preserves Mark’s engaged, skipped and snoozed decisions. | engage:draft | Write |
attach_lead | Attach one Mark-picked person to a local lead state with provenance. | people:write | Write |
get_lead | Read local lead state and provenance. | read | Read |
list_mentions | Stored mentions/replies grouped by person for one account. | read | Read |
draft_mention_reply | Save supplied draft text only. | engage:draft | Write |
get_daily_series | Daily series and both heatmap sources shown in Insights, with gaps and source labels. | read | Read |
get_insights_summary | KPIs and previous-period changes for any platform and date range. | read | Read |
list_posts | All imported posts in the chosen range, filtered and sorted ascending or descending, with pagination. | read | Read |
schedule_draft | Queue an editable agent draft (own key, or any agent key with an all-scope admin key) into Mark's weekly slots (slot=next_slot), an open best-times test slot (slot=test_slot) or an exact at (epoch ms) that is one of those. | schedule:posts | Write |
get_agent_schedule | Guardrails Mark set, 7-day agent usage, weekly spend headroom and the posts you scheduled. | read | Read |
get_time_test | The running/last test for an account: windows (Eastern), open slots, labelled posts, per-window medians with n (no winner below 5 measured posts per window) and the 365-day daily weekday prior (no time of day). | read + spend:read | Read |
get_spend | What Distributor spent: this week/month/all time in Mark's timezone, daily bars, cost per 1,000 impressions and the ledger (newest first). | read + spend:read | Read |
get_person | Read a local person, safe avatar and active touch timeline. | read | Read |
list_recent_touches | Read local people ordered by their latest active touch across channels and lists. | read | Read |
list_rounds | Read stored open and past named rounds. | read | Read |
get_round_feed | Read and sort stored round posts and touch summaries. | read | Read |
list_touches | Read chronological CRM touches by round, list or person. | read | Read |
search_my_posts | Search Mark's own X posts, threads, replies, quotes and X Articles (full text, BM25). | read | Read |
get_my_post | One library post: full text, metrics, performance tier, topics, links, mentions, thread parts and related post ids. | read | Read |
related_posts | Posts related to a library post or to any text, by shared topics and word similarity. | read | Read |
list_post_topics | Mark's topic list with keywords and post counts, plus frequent terms from his own posts. | read | Read |
suggest_links | Past posts worth citing in a draft, with suggested anchor text and the section it belongs to. | read | Read |
crm_create_people | Add up to 200 named people. | crm:people | Write |
crm_update_person_fields | Fill or change email, X, LinkedIn, company, title or URL. | crm:people | Write |
crm_create_list | Create a named list with display name, group and purpose. | crm:write | Write |
crm_update_list_members | Add or remove existing person IDs from a list. | crm:write | Write |
crm_get_pipeline | Pipeline stages, interest labels and custom fields (keys, types, options). | read | Read |
crm_list_lists | Lists with display name, purpose, group, colour, order, totals and people on X. | read | Read |
crm_get_person | One person with status, labels, custom fields, notes, sources and touches. | read | Read |
crm_update_list | Rename a list (membership kept) or set display name, purpose, group, colour, icon, pinned, archived. | crm:write | Write |
crm_reorder_lists | Set the manual order of lists, optionally moving them into one group. | crm:write | Write |
crm_merge_lists | Move every member of source into target and retire source. | crm:write | Write |
crm_update_people | Bulk set pipeline status, add or remove labels, and set custom field values (null clears). | crm:write | Write |
crm_add_note | Add a remark (kind note) or a source link (kind source) to a person; signed with your token. | crm:write | Write |
crm_create_field | Add a custom field (text, number, url, select, date) shown as a People column. | crm:write | Write |
crm_estimate_x_finder | Cost of finding X profiles for people without one: eligible count, typical and maximum cost, monthly cap. | crm:enrich | Read |
crm_run_x_finder | Spend up to the confirmed max_micro from crm_estimate_x_finder to search X for these people. | crm:enrich | Write |
crm_get_x_finder_run | Progress, cost and candidates of one finder run. | crm:enrich | Read |
create_signal_recipe | Create a signal search in the owner workspace. | signals:write | Write |
update_signal_recipe | Edit a signal search using its current revision and a client key for safe retries. | signals:write | Write |
list_signal_recipes | Signal recipes: signal type, source, queries, keep/drop and fit rules, daily flag and maximum cost per run. | read | Read |
list_hot_leads | Hot leads rolled up by company and scored fit, timing, strength; each lead has the signal, why now, source link and a NEW flag for keys first seen in the latest run. | read | Read |
get_signal | One detected signal with its qualification result and reason. | read | Read |
estimate_signal_run | Maximum cost of running these recipes and whether it fits the per-run and monthly caps. | signals:run | Read |
run_signal_recipe | Spend up to the confirmed max_micro from estimate_signal_run to detect signals; refused over the per-run or monthly cap. | signals:run | Write |
get_signal_run | Progress, cost and counts (found, new, dropped) of one run. | signals:run | Read |
segment_hot_leads | Add hot leads to a People list (create it with create=true), and/or set pipeline status and labels. | crm:write | Write |
get_brain | Read active goals first, then versioned Markdown knowledge. | read | Read |
get_goals | Read exactly the current active goals, ordered by weight. | read | Read |
list_examples | Read approved content; check existing angles before drafting. | read | Read |
get_example | Read one approved example with visuals and local metrics. | read | Read |
get_learning_queue | Read examples awaiting distillation; paginate until has_more is false. | read | Read |
propose_brain_update | Submit a Markdown revision with a diff. | brain:write | Write |
add_example | Store supplied approved content. | brain:write | Write |
mark_distilled | Mark examples distilled only after an associated learning proposal has been approved. | brain:write | Write |
list_campaigns | Read campaigns, unused/drafted/scheduled/posted angles and known Insights results. | read | Read |
get_campaign | Read a campaign, angle board, posts and results; clicks remain unknown. | read | Read |
next_campaign_task | Read the earliest eligible weekly slot, due campaign/goal, unused angle, Brain links and guardrails. | read | Read |
create_campaign | Create a goal-linked URL campaign (default duration 21 days). | campaigns:write | Write |
update_campaign | Edit a campaign with its current revision; referenced angles cannot be recycled. | campaigns:write | Write |
create_cornerstone | Add a main video, series, ad or article to a campaign. | campaigns:write | Write |
update_cornerstone | Edit a cornerstone using its current revision. | campaigns:write | Write |
reorder_cornerstones | Set the complete cornerstone order using the campaign current revision. | campaigns:write | Write |
link_post_to_cornerstone | Link a campaign post to one cornerstone. | campaigns:write | Write |
unlink_post_from_cornerstone | Remove a post link but keep the post in its campaign. | campaigns:write | Write |
replay_cornerstone_undo | Replay the complete undo receipt returned by a cornerstone link or unlink. | campaigns:write | Write |
get_strategy | Read pillars → topics → angles with authority proof, angle status, 30-day coverage vs goal weights and gaps. | read | Read |
list_topics | Read topics with their angles; filter by pillar or angle status (unused, drafted, scheduled, posted). | read | Read |
list_gaps | Read under-covered pillars, goals without pillars, topics without fresh angles and angles without proof. | read | Read |
propose_strategy_update | Propose operations (add_pillar, add_topic, add_angle, update_*, archive; use ref and "ref:<name>" to chain). | strategy:write | Write |
find_footage | Search the synced owner footage index by words and filters. | read | Read |
suggest_footage | Deterministic footage matches for an accessible draft. | read | Read |
list_lists | Read named local lists, total people and X sources. | read | Read |
get_list | Read local people in a named list. | read | Read |
create_list | Create an empty named list. | people:write | Write |
add_to_list | Add local person IDs or pasted X profiles to an existing list. | people:write | Write |
remove_from_list | Remove a list tag from local person IDs. | people:write | Write |
get_session_feed | Read stored session posts; no paid reads or reply generation. | read | Read |
publish_youtube_draft | Owner-only YouTube upload opt-in. | youtube:publish | Write |
create_draft_group | Create a token-owned angle for draft formats; never schedules. | drafts:write | Write |
get_draft_group | Every member, format, selected account and revision in your angle. | read | Read |
add_group_draft | Attach your existing draft or create a draft with per-format accounts. | drafts:write | Write |
add_group_format | Add accounts or a same-family format to shared content; another family becomes a linked draft. | drafts:write | Write |
derive_draft_format | Create another format in an angle with selected accounts and optional content changes. | drafts:write | Write |
create_slideshow | Save explicit image slides for owner review. | slideshows:write | Write |
get_slideshow | Read an accessible slideshow and its render status. | read | Read |
update_slideshow | Revision-checked layout update. | slideshows:write | Write |
render_slideshow | Render retained image slides and optional MP4 offline. | slideshows:write | Write |
slideshow_to_draft | Create normal drafts. | slideshows:write | Write |
slideshow_options | Shared fonts, palette, layouts, pixel units and text layout. | read | Read |