MindThread
Server Details
Threads scheduler for AI agents: write, schedule and publish posts, review replies, read insights.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- ppcvote/mindthread-mcp
- GitHub Stars
- 1
- Server Listing
- MindThread MCP
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 43 tools
The core resources are mostly distinct, but publish vs schedule_text vs add_library overlap around getting content onto Threads, and single-item vs bulk library operations create similar choices. The settings and cloud patrol tool families are separable from their descriptions, but the large surface makes misselection likely.
Most tools follow a readable snake_case verb_noun pattern, such as list_accounts, get_playbook, and update_library_item. A few outliers like publish, analytics_insights, cloud_patrol_log, and cloud_patrol_stats lack a clear verb, but there is no chaotic mixed casing.
43 tools is well beyond the 3-15 sweet spot and past the 25+ heavy threshold for this domain. Many are narrow single/bulk/status variants that could be consolidated without losing capability.
Coverage is broad across accounts, settings, library queue management, scheduling and publishing, analytics, cloud patrol, brand documents, approvals, usage, and events. Missing account disconnect/removal and some direct reply or comment management keep it from full lifecycle completeness.
Available Tools
43 toolsadd_libraryAdd library itemsADestructiveInspect
Adds up to 20 items (text, optional public https images) to an account's library as queued (default; they publish automatically at schedule_times) or draft (they wait). Each text is checked against the account's content_rules. Applies after drafts are approved by the user and should enter the daily publishing queue, or should be parked as drafts.
Inputs: items (required), account_id (required), status.
analytics_insightsAccount insightsARead-onlyIdempotentInspect
Returns views, likes, replies and followers for one account over a period (7d, 30d; default 30d). account_id is required; "all" returns the organization-wide aggregate. views_scope is lifetime, posts_scope is the period. Applies when the user asks how an account is performing.
Inputs: account_id (required), period.
apply_account_settingsApply bulk settings changesADestructiveIdempotentInspect
Writes a batch of settings changes to up to 100 accounts, each account in its own transaction, and returns a per-row result (ok, unchanged, or failed with the reason) and a batch_id that revert_account_settings_batch can undo within 24 hours. idempotency_key is required: a retried request with the same key returns the first result instead of writing twice. Changes to run mode, auto-posting or review before publish affect posting right away and need confirm_sensitive:true, and that confirmation may wait for the owner's approval. Nothing is written without a preview: from a Claude or ChatGPT connection the preview_id from preview_account_settings is required, and a preview_id that does not match the changes is refused. Applies after the user has seen the preview and confirmed it. 繁中:套用批次變更(每帳號一個交易、24 小時內可復原),敏感欄位要 confirm_sensitive,目錄連線一定要先預覽並帶 preview_id。
Inputs: idempotency_key (required), csv, reason, changes, +2 more.
approve_library_itemApprove a draft into the queueADestructiveIdempotentInspect
Moves one draft into the publishing queue by id. A draft whose held_reason is publish_result_unknown answers 409 publish_result_unknown because it may already be on Threads; an item being published answers 409 publishing_in_progress. Applies when the user approves a single draft.
Inputs: id (required).
approve_pending_replySend a drafted replyADestructiveInspect
Approves one drafted cloud patrol reply by id and sends it to Threads now, optionally with an edited reply text that passes the same quality gates as generated text. May wait for the owner's confirmation. Applies when the user has read a pending draft and wants it posted.
Inputs: id (required), reply.
build_materialBuild brand materialADestructiveInspect
Builds or rebuilds the account's material digest from up to 8 https pages of the brand's own website, optional notes with real cases and FAQs (up to 6,000 characters), and the account's top posts. Replaces the previous digest. Counts as one AI generation. dry:true returns a preview without saving. Applies once per account before the first generation, and again when the website changes.
Inputs: account_id (required), dry, urls, notes.
bulk_archive_libraryArchive library items in bulkAIdempotentInspect
Archives up to 50 library items by id in one call. Archived items leave the queue but are kept and can be restored with update_library_item. Per-item errors include publishing_in_progress. Applies for clearing a queue without deleting anything.
Inputs: ids (required).
bulk_delete_libraryDelete library items in bulkADestructiveIdempotentInspect
Permanently deletes up to 50 queued, draft or archived library items by id in one call. Per-item errors include publishing_in_progress. Applies when the user explicitly wants items removed for good.
Inputs: ids (required).
bulk_queue_libraryQueue library items in bulkADestructiveIdempotentInspect
Moves up to 50 drafts into the publishing queue by id in one call; they publish automatically at the account's schedule_times. Per-item errors include publishing_in_progress and publish_result_unknown (the item may already be on Threads). Applies when the user approves several drafts at once.
Inputs: ids (required).
cancel_scheduleCancel a scheduled postADestructiveIdempotentInspect
Cancels a scheduled post by id. A post that is being published right now answers 409 publishing_in_progress. A cancelled post drops out of list_schedules. There is no way to move a scheduled time: cancel it and schedule again. Applies when the user no longer wants a scheduled post to go out.
Inputs: id (required).
cloud_patrol_logCloud patrol reply logARead-onlyIdempotentInspect
Lists replies sent by cloud patrol for an account in the last 1 to 7 days, with the target post and the reply text. Applies when the user wants to read what was actually said.
Inputs: account_id (required), days.
cloud_patrol_statsCloud patrol resultsARead-onlyIdempotentInspect
Returns views and likes earned by cloud patrol replies for an account over 1 to 14 days, with the top replies. Applies when the user asks whether patrol is working or which keywords perform.
Inputs: account_id (required), days.
connect_account_linkGet a link to connect a new accountAInspect
Returns a Threads OAuth link for the user to open in a browser to connect a new Threads account to this member. The account appears in list_accounts after the user completes the flow. May wait for the owner's confirmation. Applies when the user wants to add an account.
Inputs: no named parameters.
delete_library_itemDelete a library itemADestructiveIdempotentInspect
Permanently deletes one queued, draft or archived library item by id. Applies when the user explicitly wants an item gone rather than archived.
Inputs: id (required).
disable_this_keyDisable this connectionADestructiveIdempotentInspect
Permanently disables the key or connection making this call. Cannot be undone; the owner creates a new key or reconnects in Settings. Only this connection's API requests stop, and for a connection made through the consent page (OAuth) the webhooks it created are turned off too; queued posts and cloud patrol settings created with it keep running (with an API key, its webhooks keep running as well). The result lists the confirmation requests this connection was still waiting on, now cancelled. Every later call with it answers 401 key_disabled. A connection made through the consent page of a platform such as claude.ai or ChatGPT is shared by every session of that platform for this member, so disabling it stops all of them until the user reconnects. Applies when the credential may have leaked or the user asks to stop this connection for good.
Inputs: no named parameters.
generate_postsGenerate post draftsAInspect
Generates 1 to 5 post drafts about a topic using a content formula (auto, or an id from list_formulas), the account persona and material, optional reference context (up to 8,000 characters) and a quality level (fast, standard, premium). Nothing is published or queued. The result carries rule_violations against the account's content_rules. Applies when the user wants drafts to read, edit or choose from.
Inputs: topic (required), count, context, formula, +2 more.
get_account_settingsGet account settingsARead-onlyIdempotentInspect
Returns one account's persona, schedule_times, review_before_publish, auto_reply_enabled, auto_thread, content_rules, and the guardrails block: etag (used as if_match on update), last_change, pending loosening approvals, and which paths the rules are enforced on. Applies before any settings change, because content_rules is replaced as a whole on update.
Inputs: account_id (required).
get_account_settings_batchGet a bulk settings batchARead-onlyIdempotentInspect
Returns one batch by batch_id: when it was sent and from where (website, API or MCP), counts, whether it can still be reverted, and each row's result with the failure reason. Applies after apply_account_settings, or when the user asks what a bulk change did. 繁中:查一批變更的逐列結果。
Inputs: batch_id (required).
get_approvalCheck a confirmation requestARead-onlyIdempotentInspect
Returns one confirmation request created by this connection, by id (apr_...): status (pending, approved, executed, failed, denied, expired, cancelled), the action summary, how the owner decided (decision_via, decided_by, step_up), and once executed, the full result. The server runs the original request itself after the owner confirms, so the request is not resent. Applies after a tool answered approval_required, polling about every 15 seconds until the status is final (pending requests expire after 24 hours).
Inputs: id (required).
get_brand_docGet a brand documentARead-onlyIdempotentInspect
Returns one saved document by doc_id (latest, or an earlier version), or lists all documents when doc_id is omitted. Applies before generating or scheduling posts so the drafts follow the brand and content documents. 繁中:讀取品牌文件;不給 doc_id 就列出全部。
Inputs: doc_id, version.
get_cloud_patrolGet cloud patrol settingsARead-onlyIdempotentInspect
Returns an account's cloud patrol configuration and status: keywords, daily cap, replies sent today, review_before_reply, last scan time. Cloud patrol searches Threads every 15 minutes and replies to relevant fresh posts through the official API. Applies before changing patrol settings or when the user asks whether patrol is on.
Inputs: account_id (required).
get_materialGet brand materialARead-onlyIdempotentInspect
Returns the account's material digest (who the brand is, what it sells, claims, experiences, FAQ, sourced numbers, voice) that every generation path appends to the persona. has_material:false means generation currently runs on the persona alone. Applies before generating when it is unclear whether the account has material.
Inputs: account_id (required).
get_meMy plan and keyARead-onlyIdempotentInspect
Returns the current plan, this connection's identity and permissions (each permission is allow, ask or deny), remaining daily calls in this connection's pool, remaining patrol points, and the connected accounts. Applies at the start of a session and whenever a call answered approval_required or insufficient_scope, to see which permission is involved.
Inputs: no named parameters.
get_my_usageMy usage and call logARead-onlyIdempotentInspect
Returns this connection's own usage for the last 1 to 30 days (days=1 is today since 00:00 Asia/Taipei): summary (calls, units, errors, by_endpoint) and recent calls (request_id, endpoint, status, units, at), newest first, limit 1 to 100, cursor for the next page. Only this connection's records. Applies when the user asks what this connection did, or a request_id is needed to report a problem.
Inputs: days, limit, cursor.
get_playbookOperating playbookARead-onlyIdempotentInspect
Returns the operating playbook for running an account through this server: the daily loop, how confirmation requests work, quotas, and the review checklist. The same text is in the initialize instructions. Applies when the instructions were not kept or the user asks how the service works.
Inputs: no named parameters.
get_top_postsGet top postsARead-onlyIdempotentInspect
Returns the best posts of a Threads account this member connected, ranked by engagement (likes + replies + reposts + quotes) or by views, likes, replies, reposts or quotes, with each post's text and metrics from MindThread's insights cache. Other people's accounts cannot be read: the Threads API only returns insights for the authorized user's own posts. Applies when the user wants to study what worked on their own account, for example to write a content document. 繁中:只讀會員自己連結的帳號,依互動排序取表現最好的貼文。
Inputs: account_id (required), days, limit, metric.
list_accountsList connected accountsARead-onlyIdempotentInspect
Lists the Threads accounts connected to this MindThread member, with the id to pass as account_id to every other tool. Applies whenever an account id is needed and the user named an account by username or description.
Inputs: no named parameters.
list_account_settingsList account settings (bulk)ARead-onlyIdempotentInspect
Lists every connected Threads account of this member with the settings of the MindThread bulk settings sheet (run mode, auto-posting, review before publish, posting times, audience time zone, random schedule, library recycling, cold start, content language, AI quality, auto-reply and reply limits) and status chips (expired authorization, repeated publish failures, skipped nightly refill). Up to 100 accounts per page, with limit and cursor for more. columns describes each setting (type, allowed values, which ones are sensitive) and rules_url links to the field rules page. Applies when the user wants to see or compare settings across many accounts. 繁中:列出所有帳號的總表設定與狀態標籤。
Inputs: limit, cursor.
list_eventsList recent eventsARead-onlyIdempotentInspect
Returns the member's event feed for the last 7 days, newest first (limit 1 to 200): post.published, post.failed, reply.sent, patrol.reply, patrol.pending, token.expiring, usage.threshold, approval.decided. since (ISO 8601) returns only newer events; types filters by name. Each call counts against the daily quota even when nothing is new, so poll sparingly (every 30 minutes on the free plan). Applies when the user asks what happened recently or whether a post went out.
Inputs: limit, since, types.
list_formulasList content formulasARead-onlyIdempotentInspect
Lists the content formulas that generate_posts accepts, with id and a short description of each. Applies when the user wants a specific structure (for example a story, a list, a myth-busting post) rather than auto.
Inputs: no named parameters.
list_guardrail_changesGuardrail change historyARead-onlyIdempotentInspect
Lists an account's guardrail revisions, newest first (limit 1 to 50, default 20; before for the next page). Each revision has source (api, approval, rollback, system), actor, changed_fields, loosened, tightened, before, after and restore_body (an update_account_settings body that puts the earlier values back). Applies when the user asks what changed, who changed it, or wants to restore an earlier rule set.
Inputs: account_id (required), limit, before.
list_libraryList library itemsARead-onlyIdempotentInspect
Lists an account's library items by status (queued, draft, published, failed; limit up to 200). Queued items publish automatically at the account's schedule_times; the result shows each item's position and next_publish_at. A draft with held_reason publish_result_unknown and reclaimed:true may already be on Threads. Applies when the user asks what is queued, what is waiting as a draft, or what failed.
Inputs: account_id (required), limit, status.
list_pending_repliesList drafted replies awaiting reviewARead-onlyIdempotentInspect
Lists cloud patrol reply drafts for an account by status (pending by default; also sent, rejected, expired). Each pending draft has the target post, the drafted reply and an expiry 24 hours after it was drafted. Each call counts against the daily quota even when nothing is pending. Applies when review_before_reply is on and the user wants to decide what goes out.
Inputs: account_id (required), status.
list_schedulesList scheduled postsARead-onlyIdempotentInspect
Lists scheduled posts, optionally filtered by account_id, with status, publish_at, and held_reason when a post was held (for example content_rules_violated or publish_result_unknown). Applies when the user asks what is coming up or why a post did not go out.
Inputs: account_id.
preview_account_settingsPreview bulk settings changesARead-onlyIdempotentInspect
Shows what a batch of settings changes would do and writes nothing: for each account and cell the current value and the new value, warnings (for example no posting time left), and row errors (an account that is not this member's, an unknown column, a value outside the allowed range, a cell changed since it was read). Takes changes as a list of { account_id, set, base } or csv in the same format as the website download. The result carries apply_changes and a preview_id valid for 15 minutes, which apply_account_settings takes as they are. Applies before any bulk change, so the user sees the exact cells first. 繁中:預覽批次變更,逐格列出舊值與新值,什麼都不寫。
Inputs: csv, changes.
publishPublish or schedule a postADestructiveInspect
Publishes a post to Threads now (publish_now:true) or at publish_at (ISO 8601 with offset). Takes text, one public https image (media_urls with 1 url), a carousel (2 to 10 urls) or a video_url. Text over 500 characters is split into a thread. Publishing now or within 30 minutes uses the publish-now permission; a post 30 minutes or more ahead uses the schedule permission. Either may wait for the owner's confirmation when that permission is set to ask on this connection. publish_at takes any offset and comes back in UTC (Z); a publish_at more than 60 seconds in the past returns 400 publish_at_in_past with server_now. The same account needs at least 10 minutes between scheduled posts: a closer publish_at returns 400 schedule_too_dense with nearest_publish_at. idempotency_key makes a retried request return the first result instead of posting twice. Applies when the user has final text and wants it on Threads.
Inputs: account_id (required), text, video_url, media_urls, +3 more.
reject_pending_replyReject a drafted replyADestructiveIdempotentInspect
Rejects one drafted cloud patrol reply by id with an optional note. It is never sent and the same post is not proposed again. Applies when the user does not want a drafted reply to go out.
Inputs: id (required), reason.
revert_account_settings_batchUndo a bulk settings batchADestructiveInspect
Restores the values that one batch changed, within 24 hours of the batch. Accounts changed again after the batch are skipped and listed with the reason, so a later edit is never overwritten. A batch can be reverted once. Applies when the user wants to undo a bulk change. 繁中:24 小時內復原一批變更,之後又被改過的帳號會跳過。
Inputs: batch_id (required).
save_brand_docSave a brand documentADestructiveIdempotentInspect
Saves a brand, content or content-map document (Markdown or plain text, up to 50,000 characters) under a doc_id such as brand, content or content_map, as a new version; the last 20 versions are kept. Pass base_version (the version you read, 0 when creating) so a concurrent edit is refused instead of overwritten. Nothing is published. Applies after interviewing the user about their brand, summarizing their top posts, or drafting a content map. 繁中:存品牌文件、內容文件或內容地圖,保留最近 20 版。
Inputs: doc_id (required), content (required), title, language, +2 more.
schedule_textSchedule a text postADestructiveInspect
Schedules an existing text (up to 500 characters) at publish_at, or at the next best slot with auto_optimize_time:true (the two are mutually exclusive). publish_at takes any offset and comes back in UTC (Z); a publish_at more than 60 seconds in the past returns 400 publish_at_in_past with server_now. The same account needs at least 10 minutes between scheduled posts: a closer publish_at returns 400 schedule_too_dense with nearest_publish_at. Checked against the account's content_rules: with enforce:block a violation returns 422 and nothing is scheduled; the post is checked again right before it publishes. Applies for text-only posts with a specific time or when the user wants the system to pick the time.
Inputs: text (required), account_id (required), publish_at, schedule_at, +1 more.
set_cloud_patrolSet cloud patrolADestructiveIdempotentInspect
Creates or updates an account's cloud patrol: keywords (1 to 10; a "#tag" entry searches a topic tag), reply persona, daily_cap (1 to 50 on free and trial, up to 80 on paid plans, up to 150 with a haixun add-on), enabled, and review_before_reply. When patrol is on, the account replies to relevant fresh Threads posts through the official API every 15 minutes, one patrol point per delivered reply; with review_before_reply:true every drafted reply waits in list_pending_replies instead of going out. Turning patrol on, or changing a patrol that is already on, needs the patrol permission, which is not granted to directory connections: the owner does it in MindThread. Applies when the user wants to stop patrol or tune its keywords, persona and cap while it is off.
Inputs: account_id (required), mode, enabled, persona, +6 more.
update_account_settingsUpdate account settingsADestructiveIdempotentInspect
Changes an account's persona (up to 4,000 characters), schedule_times (comma-separated HH:MM in the account time zone, up to 8), review_before_publish, auto_reply_enabled, auto_thread, auto_link_to_comment, enabled, random posting (random_schedule, random_per_day, random_window, and random_exclude: up to 3 ranges such as 17:00-18:00 that random times skip), and content_rules (max_chars, min_chars, forbid_cta, forbid_hashtags, banned_phrases, facts as the only numbers the AI may use, forbid_causal_claims, judge_claims, one_fact_per_post, mention_limits, enforce warn or block). Only the fields sent are changed, except content_rules, which is replaced as a whole. if_match (the guardrails etag) makes a concurrent change answer 412 instead of overwriting; reason (up to 200 characters) is stored in the revision; dry_run:true previews whether the change would apply, ask the owner or be denied, without writing anything. A change that loosens a guardrail may wait for the owner's confirmation. Applies when the user asks to change voice, posting times, review mode, auto-reply or content rules.
Inputs: account_id (required), reason, dry_run, enabled, +12 more.
update_library_itemUpdate a library itemADestructiveIdempotentInspect
Changes one library item by id: status (archived, draft, queued), text (checked against content_rules), or its place in the queue (position first or last, or an explicit order). 409 publishing_in_progress means it is being published; 409 publish_result_unknown means it may already be on Threads; 409 status_changed means it changed since it was read. Applies when the user wants to edit, reorder, archive or restore one item.
Inputs: id (required), text, order, status, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Publish and schedule Threads posts from your AI assistant.
Publish, reply, moderate, search and read insights on your Threads (threads.com) account.
Draft, schedule and publish social media posts from any AI agent.
Schedule social posts, threads and video to X, LinkedIn, Bluesky, Mastodon and YouTube from your AI.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceManage Threads and Bluesky social media from AI assistants. Schedule posts, check analytics, and automate follow-up replies.3MIT
- AlicenseCqualityDmaintenanceEnables professional Threads management with advanced analytics, AI-powered content optimization, and automation features.4559 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage a Threads profile through Meta's API, including posting, threads, replies, reply moderation, and insights.3030 npm4MIT
- AlicenseCqualityCmaintenanceEnables professional Threads management with enterprise-grade analytics, AI-powered content optimization, and automation features, including posting, scheduling, audience insights, and bulk operations.4559 npm10MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.