javimosch 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:
- Go to twinfold.app → Settings → API Keys
- Create a key (starts with
twf_) - Set it:
export TWINFOLD_API_KEY=twf_...or add to.env
API
Endpoint: POST https://twinfold.app/api/mcp/tools
Auth: Authorization: Bearer <TWINFOLD_API_KEY>
Body: { "tool": "twinfold.<toolName>", "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
401→ Invalid API key402→ Insufficient credits (check withgetCredits)400→ Bad arguments (error message explains what's wrong)429→ Rate limited (wait and retry)
Tips
- Use
autoAdapt: trueoncreatePostto get platform-optimized versions automatically - Set
language: "fr-CA"for authentic Quebec French content - Use
getTrends→createPostfor trend-jacking workflows repurposeContentturns blog posts, transcripts, or notes into social postsplanContentcreates a full week of drafts in one call- Autopilot runs daily — use
getAutopilotQueue+approvePostfor review workflows