Twinfold

Twinfold Skill

Control Twinfold — the AI thought leadership platform — via its MCP API.

Setup

The user needs a Twinfold API key. Check env var TWINFOLD_API_KEY.

If missing, tell the user: 1. Go to twinfold.app → Settings → API Keys 2. Create a key (starts with twf_) 3. Set it: export TWINFOLD_API_KEY=twf_... or add to .env

API

Endpoint: POST https://twinfold.app/api/mcp/tools Auth: Authorization: Bearer Body: { "tool": "twinfold.", "arguments": { ... } }

All calls return { "result": { ... } } on success or { "error": "..." } on failure.

Discover tools

curl https://twinfold.app/api/mcp/tools

Returns all 34 tools with schemas. No auth required.

Tools Quick Reference

Content Creation

| 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 |

Content Management

| 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 |

Publishing

| Tool | Use | |------|-----| | publishNow | Publish immediately to connected platforms | | schedulePost | Schedule for a future date/time |

Autopilot

| 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 |

Intelligence

| 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 |

Brand Guide & Voice

| 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) |

Notifications

| Tool | Use | |------|-----| | getNotifications | List notifications (unread, by type, paginated) | | markNotificationRead | Mark one or all notifications as read | | getNotificationPreferences | Get notification channel preferences |

Account

| Tool | Use | |------|-----| | listAccounts | Connected social accounts + content languages | | getCredits | Credit balance, plan, cost table | | getAnalytics | Post stats and workspace analytics |

Common Workflows

For detailed tool schemas and workflow examples, read references/workflows.md.

Quick: Create and publish a post

1. twinfold.createPost { topic, platforms, language, autoAdapt: true, autoPublish: true }

One call does it all — generates content, adapts per platform, publishes.

Quick: Create, review, then publish

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 }

Full pipeline with images and hooks

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 }

Platforms

LinkedIn · Twitter/X · Instagram · Facebook · YouTube · TikTok · Pinterest · Threads · Reddit · Bluesky

Languages

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).

Credit Costs

| 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.

Error Handling

Tips

The user needs a Twinfold API key. Check env var TWINFOLD_API_KEY.

If missing, tell the user: 1. Go to twinfold.app → Settings → API Keys 2. Create a key (starts with twf_) 3. Set it: export TWINFOLD_API_KEY=twf_... or add to .env