{ "$comment": "GENERATED by scripts/gen-tool-docs.mts from the packages tool registrations. Do not edit by hand.", "endpointTemplate": "https://.mcp.devfellowship.com/mcp", "hosts": [ { "host": "campaigns", "package": "dfl-mcp-campaigns", "endpoint": "https://campaigns.mcp.devfellowship.com/mcp", "published": true, "toolCount": 34, "tools": [ { "name": "list_post_business_units", "title": "List post calendar business units", "description": "The business units the post calendar can schedule for — `strategy.business_units`, archived ones excluded. Call this FIRST: every other tool takes a business_unit_id (a uuid), never a name like \"itera\".", "group": "Accounts & voice", "deprecated_alias_of": null, "params": [] }, { "name": "list_zernio_profiles", "title": "List Zernio profiles and their accounts", "description": "Who publishes where: each Zernio profile (a person or the company) with its connected accounts per network, plus the accounts that belong to no profile. Call this FIRST when drafting a post: draft_post_for_review requires zernio_profile_id — the profile of the person or brand the post goes out as (\"Criador\" in the dfl-campaigns UI). A post is NOT limited to that profile's own accounts — the app allows channels across profiles (e.g. the brand DevFellowship plus a team member's personal accounts); the profile just names who the post is mainly for.", "group": "Accounts & voice", "deprecated_alias_of": null, "params": [] }, { "name": "list_zernio_accounts", "title": "List connected Zernio accounts", "description": "The social accounts connected in Zernio, each with the id a channel needs to actually publish. Call this BEFORE draft_post_for_review whenever the post has channels: Zernio publishes per ACCOUNT, and there is more than one account on the same platform (a company profile and a personal one), so \"instagram\" alone does not say where the post goes out. A channel drafted without its zernio_account_id is dropped at dispatch, and the review queue cannot add the account afterwards — that post has to be redone.", "group": "Accounts & voice", "deprecated_alias_of": null, "params": [] }, { "name": "list_posts", "title": "List calendar posts", "description": "Read the post calendar, ordered by scheduled_for. Without business_unit_id it is the consolidated view across every BU. Pass status: \"awaiting_review\" to read the human review queue — everything the AI wrote that is still waiting on a person. assignee_id and zernio_profile_id narrow it to one person or one profile; while those columns do not exist yet the filter is skipped and `notes` says so. Each post carries `assignment`; pass include_metrics: true to attach latest_metrics per platform and account. Each post carries `archetype` and `media_group` (its content-format tag; null when unset).", "group": "Posts & review queue", "deprecated_alias_of": null, "params": [ { "name": "business_unit_id", "type": "string", "required": false, "description": "Filter to one BU (from list_post_business_units)" }, { "name": "status", "type": "enum", "required": false, "description": "Filter by lifecycle state", "enumValues": [ "draft", "awaiting_review", "approved", "rejected", "dispatched" ] }, { "name": "scheduled_from", "type": "string", "required": false, "description": "Only posts scheduled at/after this ISO date-time" }, { "name": "scheduled_to", "type": "string", "required": false, "description": "Only posts scheduled at/before this ISO date-time" }, { "name": "assignee_id", "type": "string", "required": false, "description": "Only posts assigned to this user id" }, { "name": "zernio_profile_id", "type": "string", "required": false, "description": "Only posts linked to this Zernio profile" }, { "name": "include_metrics", "type": "boolean", "required": false, "description": "Attach latest_metrics per platform and account to each post (never summed across platforms)", "defaultValue": "false" }, { "name": "limit", "type": "number", "required": false, "description": "", "defaultValue": "50" } ] }, { "name": "list_core_daily_topics", "title": "List Core Daily topics per person", "description": "What each person said in the last N days, merged per person from the Discord channel #core-daily-updates (primary) and the Core Daily meeting transcripts (when there was one). Each line has `source` (\"channel\" with a Discord `url`, or \"meeting\"); lines under 8 words and repeats are removed, at most 30 per person, newest first. `sources` says which side answered. Read-only. Use it to propose one draft per person: each line is raw speech, so rewrite it into a hook before calling draft_post_for_review, and pass assignee_id = user_id when it is present (user_id is only set on an exact name match with a member).", "group": "Suggested topics", "deprecated_alias_of": null, "params": [ { "name": "days", "type": "number", "required": false, "description": "Window in days, 1 to 30", "defaultValue": "7" }, { "name": "speaker", "type": "string", "required": false, "description": "Only this speaker (case and accents ignored), as shown in `speaker`" } ] }, { "name": "list_suggested_topics", "title": "List suggested topics (Curadoria board)", "description": "Read the suggested topics on the Curadoria board of /posts/pautas in dfl-campaigns. A suggested topic (a curated content topic, \"pauta\" in Portuguese) is an idea for content that a person or an agent put on the board and that later turns into one or many posts. Each topic has a title, briefing, status (idea, todo, awaiting_content, in_production, awaiting_approval, posted, standby), optional due_date, formats, channels, reference_links, business_unit_id, assignee_id and a `url` to its card. Active topics are returned by default; pass archived=true for the archived ones. Filters are applied after the read. Read-only. Call it before create_suggested_topic so you do not add a duplicate. If the answer says the board is not live on this deployment, do not retry.", "group": "Suggested topics", "deprecated_alias_of": null, "params": [ { "name": "status", "type": "enum", "required": false, "description": "Only topics in this column", "enumValues": [ "idea", "todo", "awaiting_content", "in_production", "awaiting_approval", "posted", "standby" ] }, { "name": "assignee_id", "type": "string", "required": false, "description": "Only topics assigned to this user" }, { "name": "business_unit_id", "type": "string", "required": false, "description": "Only topics of this BU (from list_post_business_units)" }, { "name": "archived", "type": "boolean", "required": false, "description": "true reads the archived topics instead of the active ones", "defaultValue": "false" } ] }, { "name": "create_suggested_topic", "title": "Add a suggested topic to the Curadoria board", "description": "Add one suggested topic to the Curadoria board of /posts/pautas in dfl-campaigns. A suggested topic (a curated content topic, \"pauta\" in Portuguese) is an idea for content that a person or an agent proposes and that later turns into one or many posts. Creating one posts NOTHING and drafts no post: it only puts a card on the board, marked as created by an agent (origin \"mcp\"), for a person to pick up. To draft a post use draft_post_for_review. The status defaults to idea. Run list_suggested_topics first to avoid duplicates. The answer carries the card `url`. A refusal (not available on this deployment, a rule, a missing BU or user) says do not retry; only a temporary failure may be retried.", "group": "Suggested topics", "deprecated_alias_of": null, "params": [ { "name": "title", "type": "string", "required": true, "description": "Short name of the topic, as it shows on the card" }, { "name": "briefing", "type": "string", "required": false, "description": "What the content is about and the angle (up to 5000 characters)" }, { "name": "status", "type": "enum", "required": false, "description": "Board column; omitted means idea", "enumValues": [ "idea", "todo", "awaiting_content", "in_production", "awaiting_approval", "posted", "standby" ] }, { "name": "due_date", "type": "string", "required": false, "description": "Day the content is wanted, YYYY-MM-DD" }, { "name": "formats", "type": "enum[]", "required": false, "description": "Content formats" }, { "name": "channels", "type": "enum[]", "required": false, "description": "Networks the content is for" }, { "name": "reference_links", "type": "string[]", "required": false, "description": "http(s) links that inspired or back the topic" }, { "name": "business_unit_id", "type": "string", "required": false, "description": "Which BU the topic is for (from list_post_business_units)" }, { "name": "assignee_id", "type": "string", "required": false, "description": "The user expected to produce it" } ] }, { "name": "update_suggested_topic", "title": "Edit a suggested topic on the Curadoria board", "description": "Edit the content of one suggested topic (\"pauta\") on the Curadoria board of /posts/pautas in dfl-campaigns: title, briefing, due date, formats, channels, reference links, BU or assignee. Any member can edit any topic. Send only the fields to change; an omitted field keeps its value, and null clears briefing, due_date, business_unit_id or assignee_id. Arrays (formats, channels, reference_links) replace the whole list. It does NOT change the column or the order: use move_suggested_topic for that, and archive_suggested_topic to archive. It refuses an empty change, an unknown field and an unknown id. Get the id from list_suggested_topics. A refusal says do not retry; only a temporary failure may be retried.", "group": "Suggested topics", "deprecated_alias_of": null, "params": [ { "name": "id", "type": "string", "required": true, "description": "The suggested topic id (from list_suggested_topics)" }, { "name": "title", "type": "string", "required": false, "description": "New title" }, { "name": "briefing", "type": "string", "required": false, "description": "New briefing; null clears it" }, { "name": "due_date", "type": "string", "required": false, "description": "Day the content is wanted, YYYY-MM-DD; null clears it" }, { "name": "formats", "type": "enum[]", "required": false, "description": "Replaces the formats" }, { "name": "channels", "type": "enum[]", "required": false, "description": "Replaces the channels" }, { "name": "reference_links", "type": "string[]", "required": false, "description": "Replaces the http(s) reference links" }, { "name": "business_unit_id", "type": "string", "required": false, "description": "BU from list_post_business_units; null clears it" }, { "name": "assignee_id", "type": "string", "required": false, "description": "The user expected to produce it; null clears it" } ] }, { "name": "move_suggested_topic", "title": "Move a suggested topic to a column or position", "description": "Move one suggested topic (\"pauta\") to a column of the Curadoria board of /posts/pautas in dfl-campaigns and, optionally, to a place inside it. status is the target column (it may be the current one, to only reorder). Without before_id/after_id the card goes to the end of the column; with before_id it lands right above that card, with after_id right below it (send one, never both). The neighbour must be an active topic already in the target column. Any member can move any topic. It does not edit content (update_suggested_topic) and does not touch posts. A refusal says do not retry; only a temporary failure may be retried.", "group": "Suggested topics", "deprecated_alias_of": null, "params": [ { "name": "id", "type": "string", "required": true, "description": "The suggested topic to move (from list_suggested_topics)" }, { "name": "status", "type": "enum", "required": true, "description": "Target column", "enumValues": [ "idea", "todo", "awaiting_content", "in_production", "awaiting_approval", "posted", "standby" ] }, { "name": "before_id", "type": "string", "required": false, "description": "Place the card right above this one" }, { "name": "after_id", "type": "string", "required": false, "description": "Place the card right below this one" } ] }, { "name": "archive_suggested_topic", "title": "Archive or restore a suggested topic", "description": "Archive one suggested topic (\"pauta\") of the Curadoria board of /posts/pautas in dfl-campaigns, or bring an archived one back with restore=true. Archiving hides the card from the board but keeps it, and it is reversible: this is the safe way to take a topic off the board. Any member can archive or restore any topic. To remove one for good use delete_suggested_topic. Archived topics are read with list_suggested_topics archived=true. A refusal (unknown id, not available on this deployment) says do not retry; only a temporary failure may be retried.", "group": "Suggested topics", "deprecated_alias_of": null, "params": [ { "name": "id", "type": "string", "required": true, "description": "The suggested topic id (from list_suggested_topics)" }, { "name": "restore", "type": "boolean", "required": false, "description": "true brings an archived topic back to the board; default archives", "defaultValue": "false" } ] }, { "name": "delete_suggested_topic", "title": "Permanently delete a suggested topic you created", "description": "Permanently delete one suggested topic (\"pauta\") from the Curadoria board of /posts/pautas in dfl-campaigns. It cannot be undone. Only the creator of the topic or an admin may delete it: the server decides that, from the caller session, and refuses everybody else with \"do not retry\" (ask the creator or an admin instead). To take a topic off the board without losing it, use archive_suggested_topic. Pass confirm_title equal to the topic's current title, exactly as list_suggested_topics shows it; a different title, or an id that is not on the board, deletes nothing. Posts already drafted from the topic are not deleted.", "group": "Suggested topics", "deprecated_alias_of": null, "params": [ { "name": "id", "type": "string", "required": true, "description": "The suggested topic id (from list_suggested_topics)" }, { "name": "confirm_title", "type": "string", "required": true, "description": "The topic's current title, copied exactly: the guard against deleting the wrong card" } ] }, { "name": "get_post", "title": "Get one calendar post", "description": "One post with its channels, its lifecycle state and its approval trail — who approved it and when, and whether it was already dispatched to Zernio. Also returns `assignment` (zernio_profile_id, assignee_id; null while those columns do not exist) and `latest_metrics`: the latest views/likes/comments per platform AND Zernio account, never summed across platforms. The post always carries `archetype` and `media_group` (its content-format tag; null when unset or while the columns do not exist). `live` is { published_at, published_url } once dfl-campaigns read the post LIVE in Zernio (status `published`): the link to the post on the network. null while it is not known live. Use it to answer \"how did this post do\" and \"where is it\".", "group": "Posts & review queue", "deprecated_alias_of": null, "params": [ { "name": "post_id", "type": "string", "required": true, "description": "" } ] }, { "name": "draft_post_for_review", "title": "Draft a post into the human review queue", "description": "Write one post into the calendar. It lands in `awaiting_review` and NOTHING leaves this server until a person opens the queue in dfl-campaigns, reads it and approves it — you cannot clear it yourself; approve_post only records a decision a person already gave you. Schedule the time you want it to go out; a channel only reaches its network if it carries the connected zernio_account_id. An Instagram Reel cover is optional: pass cover_media_id (the COVER_MEDIA_ID from the thumbify-reel-cover skill) or cover_url (a Thumbify render URL), or Instagram uses frame 0 of the video. A cover that is not a Thumbify cover is refused at approval. The Lesson Studio cover slide is NOT carried over. A carousel (Instagram, or a TikTok photo carousel) is either media_ids (existing public.media ids) or media_urls (rendered images, e.g. from render_composition_images; dfl-campaigns registers them as your media). A single image is media_id; TikTok accepts it as a photo post (JPEG, PNG or WebP, up to 20 MB each). Pass media_group + archetype (the content-format tag): a post without an archetype is \"untagged\" in the weekly summary, and the result carries content_tag_warning.", "group": "Posts & review queue", "deprecated_alias_of": null, "params": [ { "name": "business_unit_id", "type": "string", "required": true, "description": "Which BU publishes it (from list_post_business_units)" }, { "name": "title", "type": "string", "required": true, "description": "Internal title — how the post shows up in the calendar" }, { "name": "body", "type": "string", "required": true, "description": "The text that goes out to the network" }, { "name": "scheduled_for", "type": "string", "required": true, "description": "ISO date-time the post should be published at" }, { "name": "youtube_visibility", "type": "enum", "required": false, "description": "How the post lands on YouTube and TikTok. Omitted means `private` — the closed default, on purpose: a post that goes out more public than intended cannot be taken back, while a private one is one click away from being opened. On TikTok (video or photo) it sets the privacy level: private = only the creator, unlisted = followers only, public = everyone — so the default `private` means a TikTok post only the creator can see. Only matters when a channel is youtube or tiktok.", "enumValues": [ "private", "unlisted", "public" ] }, { "name": "link_url", "type": "string", "required": false, "description": "INTERNAL note only — this URL is NOT published. The dispatch sends title, body and media to Zernio and nothing else, so a link (and any utm_ it carries) reaches the network ONLY if it is written inside `body`. The dfl-campaigns form stopped offering this field for that reason; it is kept here for rows written through the API. Put the link in `body`." }, { "name": "media_id", "type": "string", "required": false, "description": "public.media id — never a raw bucket URL; media is served by media.devfellowship.com/:id" }, { "name": "media_ids", "type": "string[]", "required": false, "description": "Carousel (Instagram, or TikTok photo carousel): ordered public.media ids of 2 to 10 images; use instead of media_id. Never a single image: one image is media_id." }, { "name": "media_urls", "type": "string[]", "required": false, "description": "Carousel (Instagram, or TikTok photo carousel) from rendered images: 2 to 10 public devfellowship S3 media/ PNG/JPG URLs (e.g. render_composition_images output) in order; use instead of media_ids. Never together with media_id or media_ids." }, { "name": "cover_media_id", "type": "string", "required": false, "description": "Reel cover: another public.media id (JPEG or PNG, 1080x1920) holding a Thumbify cover (reel-cover-v-…) — any other file is refused at approval. Not the video. Omitted means Instagram uses frame 0. Dispatch sends this as instagramThumbnail." }, { "name": "cover_url", "type": "string", "required": false, "description": "Reel cover as a URL, in place of cover_media_id: a public JPEG/PNG of the devfellowship S3 bucket under media/ — typically a Thumbify render output_url (media/renders/