Scoped agent access
Prepare content. Read what worked. Schedule within your limits.
Connect your agent to Distributor using a revocable bearer token.
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.Use your local secret manager or a private shell prompt to set DISTRIBUTOR_TOKEN. Keep client configs out of source control.
Set DISTRIBUTOR_TOKEN locally first. This command stores the expanded token in your local client config; keep it private.
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"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}"
}
}
}
}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 one of your own unopened drafts 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 |
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 |