Control Twinfold — the AI thought leadership platform — via its MCP API.
The user needs a Twinfold API key. Check env var TWINFOLD_API_KEY.
If missing, tell the user:
twf_)export TWINFOLD_API_KEY=twf_... or add to .envEndpoint: POST https://twinfold.app/api/mcp/tools
Auth: Authorization: Bearer
Body: { "tool": "twinfold.
All calls return { "result": { ... } } on success or { "error": "..." } on failure.
curl https://twinfold.app/api/mcp/tools
Returns all 34 tools with schemas. No auth required.
| Tool | Use |
|---|---|
| ------ | ----- |
createPost | Generate a post with AI. Supports multilingual, images, first comments, per-platform adaptation, auto-publish |
createArticle | Generate long-form articles with Twin knowledge |
adaptContent | Rewrite content for a specific platform's culture and format |
generateHooks | Get 4 viral hook options with engagement scores |
generateImage | Generate an AI image and attach to a post |
repurposeContent | Turn any text into multi-platform draft posts |
planContent | Generate a multi-day content calendar with draft posts |
| Tool | Use |
|---|---|
| ------ | ----- |
getPost | Read a single post with full details |
listPosts | List posts (filter by status/platform) |
updatePost | Edit content, platforms, media, schedule |
deletePost | Remove draft/scheduled posts |
listArticles | List articles |
| Tool | Use |
|---|---|
| ------ | ----- |
publishNow | Publish immediately to connected platforms |
schedulePost | Schedule for a future date/time |
| Tool | Use |
|---|---|
| ------ | ----- |
runAutopilot | Trigger full autopilot pipeline (discover → create → publish) |
getAutopilotQueue | List posts pending review |
approvePost | Approve for scheduled publication |
rejectPost | Reject an autopilot post |
| Tool | Use |
|---|---|
| ------ | ----- |
queryTwin | Ask the AI Twin questions based on user's expertise |
addKnowledge | Teach the Twin new knowledge |
getTrends | Fetch trending topics scored by relevance |
| Tool | Use |
|---|---|
| ------ | ----- |
getBrandGuide | Get the brand guide markdown |
setBrandGuide | Update brand guide (free, no credits) |
generateBrandGuide | AI-generate brand guide from Twin knowledge (5 credits) |
listBrandVoices | List all brand voice profiles |
createBrandVoice | Create a brand voice manually |
updateBrandVoice | Update an existing brand voice |
deleteBrandVoice | Delete a brand voice |
generateBrandVoice | AI-generate a brand voice analysis (5 credits) |
| Tool | Use |
|---|---|
| ------ | ----- |
getNotifications | List notifications (unread, by type, paginated) |
markNotificationRead | Mark one or all notifications as read |
getNotificationPreferences | Get notification channel preferences |
| Tool | Use |
|---|---|
| ------ | ----- |
listAccounts | Connected social accounts + content languages |
getCredits | Credit balance, plan, cost table |
getAnalytics | Post stats and workspace analytics |
For detailed tool schemas and workflow examples, read references/workflows.md.
1. twinfold.createPost { topic, platforms, language, autoAdapt: true, autoPublish: true }
One call does it all — generates content, adapts per platform, publishes.
1. twinfold.createPost { topic, platforms, language } → postId
2. Show content to user, let them edit
3. twinfold.updatePost { postId, content: editedContent }
4. twinfold.publishNow { postId }
1. twinfold.generateHooks { topic } → pick best hook
2. twinfold.createPost { topic, platforms, language, generateImage: true, generateFirstComment: true } → postId
3. twinfold.getPost { postId } → review
4. twinfold.publishNow { postId }
LinkedIn · Twitter/X · Instagram · Facebook · YouTube · TikTok · Pinterest · Threads · Reddit · Bluesky
English · French · Quebec French (fr-CA) · Spanish · German · Portuguese · Brazilian Portuguese · Italian · Dutch · Japanese · Korean · Chinese · Arabic
Set language per social account or per API call. Content generates natively (not translated).
| Operation | Credits |
|---|---|
| ----------- | --------- |
| Post | 10 |
| Article | 50 |
| Hook simulation | 5 |
| Image | 10 |
| First comment | 2 |
| Twin query | 2 |
| Brand guide generate | 5 |
| Brand voice generate | 5 |
Always check twinfold.getCredits before heavy operations.
401 → Invalid API key402 → Insufficient credits (check with getCredits)400 → Bad arguments (error message explains what's wrong)429 → Rate limited (wait and retry)autoAdapt: true on createPost to get platform-optimized versions automaticallylanguage: "fr-CA" for authentic Quebec French contentgetTrends → createPost for trend-jacking workflowsrepurposeContent turns blog posts, transcripts, or notes into social postsplanContent creates a full week of drafts in one callgetAutopilotQueue + approvePost for review workflows共 1 个版本