Boring Threads Publisher
Publish posts, multi-post threads, and replies on Threads. Powered by Boring.
Security & Data Handling
- - MCP link is a credential: Your MCP Server URL contains an embedded authentication token. Treat it like a password — do not share it publicly. Regenerate anytime in Settings.
- Media uploads: Local files or URLs are uploaded to Boring's Google Cloud Storage to make them accessible for publishing. Social media APIs require publicly accessible media URLs.
- Data flow: Your content and media are sent from Boring's server to Threads' API on your behalf via your connected OAuth token.
- No local credentials: No local API keys or environment variables needed. All auth is embedded in the MCP link.
Prerequisites
- 1. Sign up at boring.aiagent-me.com with Google
- Connect Threads account via OAuth
- Get your MCP link: Go to Settings → copy your MCP Server URL (contains your auth token — treat it like a password)
- Add to Claude: Paste the MCP link as a Connector — no install, no API key needed
Workflow
Step 1: List Accounts
Call boring_list_accounts and filter for threads platform. Show connected accounts.
Step 2: Determine Post Type
Threads supports multiple content types:
| Type | Description | Limit |
|---|
| Text | Text-only post | 500 characters |
| Photo |
Single image | JPG/PNG/WEBP, max 8MB |
| Carousel | Multi-image | 2-20 images (more than other platforms!) |
| Video | Single video | MP4/MOV, max 512MB, 5 min |
| Thread | Multi-post thread | Array of text posts, each up to 500 chars |
Step 3: Choose the Right Tool
Single post (text, photo, carousel, video) → use boring_publish_post:
CODEBLOCK0
Multi-post thread (long-form content split into connected posts) → use boring_publish_thread:
CODEBLOCK1
Reply to existing post → use boring_reply_to_post_threads:
CODEBLOCK2
Step 4: Handle Long Content
If the user provides content longer than 500 characters:
- 1. Automatically split into multiple posts for a thread
- Split at sentence boundaries when possible
- Use
boring_publish_thread with the array of texts - Inform the user: "Your content was split into X connected posts"
Step 5: Prepare Media
- - Local files:
boring_upload_file with INLINECODE7 - URLs:
boring_upload_from_url to re-host - Google Drive: Pass directly
Step 6: Publish and Report
Show results:
- - Post ID(s) for each published post
- Thread URL if it was a multi-post thread
- Any errors encountered
Scheduling
Add scheduled_at in ISO 8601 format to schedule:
CODEBLOCK3
Threads-Specific Notes
- - Text-only posts: Threads is one of the few platforms that supports pure text posts
- Carousel limit: Up to 20 images (vs 10 on Instagram/Facebook)
- Token: 60-day expiration with auto-refresh 5 days before expiry
- Rate Limit: 250 calls/hour per user
- Permissions:
threads_basic, threads_content_publish, INLINECODE12
Error Handling
| Error | Solution |
|---|
| INLINECODE13 | Split into thread using INLINECODE14 |
| INLINECODE15 |
Carousel needs 2-20 images |
|
TokenExpired | Reconnect at boring.aiagent-me.com (rare due to auto-refresh) |
|
MediaTooLarge | Images max 8MB, videos max 512MB |
Documentation
Full API docs: boring-doc.aiagent-me.com
Boring Threads Publisher
在 Threads 上发布帖子、多帖线程和回复。由 Boring 提供技术支持。
安全与数据处理
- - MCP 链接即凭证：您的 MCP 服务器 URL 包含嵌入式身份验证令牌。请像对待密码一样对待它——不要公开分享。可随时在设置中重新生成。
- 媒体上传：本地文件或 URL 会上传到 Boring 的 Google Cloud Storage，使其可供发布使用。社交媒体 API 需要公开可访问的媒体 URL。
- 数据流：您的内容和媒体将通过您连接的 OAuth 令牌，从 Boring 服务器代表您发送到 Threads 的 API。
- 无需本地凭证：无需本地 API 密钥或环境变量。所有身份验证都嵌入在 MCP 链接中。
前提条件
- 1. 注册：使用 Google 在 boring.aiagent-me.com 注册
- 连接 Threads 账户：通过 OAuth 连接
- 获取您的 MCP 链接：前往设置 → 复制您的 MCP 服务器 URL（包含您的身份验证令牌——请像对待密码一样对待它）
- 添加到 Claude：将 MCP 链接粘贴为连接器——无需安装，无需 API 密钥
工作流程
步骤 1：列出账户
调用 boringlistaccounts 并筛选 threads 平台。显示已连接的账户。
步骤 2：确定帖子类型
Threads 支持多种内容类型：
单张图片 | JPG/PNG/WEBP，最大 8MB |
| 轮播 | 多张图片 | 2-20 张图片（比其他平台更多！） |
| 视频 | 单个视频 | MP4/MOV，最大 512MB，5 分钟 |
| 线程 | 多帖线程 | 文本帖子数组，每条最多 500 个字符 |
步骤 3：选择正确的工具
单条帖子（文本、图片、轮播、视频）→ 使用 boringpublishpost：
boringpublishpost(
accountid=account_id>,
platform=threads,
text=您的帖子内容,
media_urls=[https://...] （可选）
)
多帖线程（长内容拆分为连接的帖子）→ 使用 boringpublishthread：
boringpublishthread(
accountid=account_id>,
platform=threads,
texts=[线程中的第一条帖子, 第二条帖子继续..., 第三条帖子总结],
media_urls=[https://...] （可选，仅添加到第一条帖子）
)
回复现有帖子→ 使用 boringreplytopostthreads：
boringreplytopostthreads(
accountid=account_id>,
replytoid=postid>,
text=您的回复内容,
media_urls=[https://...] （可选，仅第一个 URL）
)
步骤 4：处理长内容
如果用户提供的内容超过 500 个字符：
- 1. 自动拆分为线程中的多条帖子
- 尽可能在句子边界处拆分
- 使用 boringpublishthread 和文本数组
- 告知用户：您的内容已拆分为 X 条连接的帖子
步骤 5：准备媒体
- - 本地文件：使用 filepath 调用 boringuploadfile
- URL：使用 boringuploadfromurl 重新托管
- Google Drive：直接传递
步骤 6：发布并报告
显示结果：
- - 每条已发布帖子的帖子 ID
- 如果是多帖线程，显示线程 URL
- 遇到的任何错误
定时发布
添加 ISO 8601 格式的 scheduled_at 来定时发布：
boringpublishpost(..., scheduled_at=2025-12-25T10:00:00Z)
boringpublishthread(..., scheduled_at=2025-12-25T10:00:00Z)
Threads 特定说明
- - 纯文本帖子：Threads 是少数支持纯文本帖子的平台之一
- 轮播限制：最多 20 张图片（而 Instagram/Facebook 为 10 张）
- 令牌：60 天有效期，到期前 5 天自动刷新
- 速率限制：每个用户每小时 250 次调用
- 权限：threadsbasic、threadscontentpublish、threadsmanage_replies
错误处理
| 错误 | 解决方案 |
|---|
| TextTooLong | 使用 boringpublishthread 拆分为线程 |
| InvalidCarouselSize |
轮播需要 2-20 张图片 |
| TokenExpired | 在 boring.aiagent-me.com 重新连接（由于自动刷新，很少发生） |
| MediaTooLarge | 图片最大 8MB，视频最大 512MB |
文档
完整 API 文档：boring-doc.aiagent-me.com
