✓ Verified ✍️ Content Creation ✓ Enhanced Data

Twinfold

Control Twinfold — AI-powered social media content platform — from your agent.

Rating
4.6 (124 reviews)
Downloads
10,600 downloads
Version
1.0.0

Overview

Control Twinfold — AI-powered social media content platform — from your agent.

Complete Documentation

View Source →

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 Body: { "tool": "twinfold.", "arguments": { ... } }

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

Discover tools

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

Returns all 34 tools with schemas. No auth required.

Tools Quick Reference

Content Creation

ToolUse
createPostGenerate a post with AI. Supports multilingual, images, first comments, per-platform adaptation, auto-publish
createArticleGenerate long-form articles with Twin knowledge
adaptContentRewrite content for a specific platform's culture and format
generateHooksGet 4 viral hook options with engagement scores
generateImageGenerate an AI image and attach to a post
repurposeContentTurn any text into multi-platform draft posts
planContentGenerate a multi-day content calendar with draft posts

Content Management

ToolUse
getPostRead a single post with full details
listPostsList posts (filter by status/platform)
updatePostEdit content, platforms, media, schedule
deletePostRemove draft/scheduled posts
listArticlesList articles

Publishing

ToolUse
publishNowPublish immediately to connected platforms
schedulePostSchedule for a future date/time

Autopilot

ToolUse
runAutopilotTrigger full autopilot pipeline (discover → create → publish)
getAutopilotQueueList posts pending review
approvePostApprove for scheduled publication
rejectPostReject an autopilot post

Intelligence

ToolUse
queryTwinAsk the AI Twin questions based on user's expertise
addKnowledgeTeach the Twin new knowledge
getTrendsFetch trending topics scored by relevance

Brand Guide & Voice

ToolUse
getBrandGuideGet the brand guide markdown
setBrandGuideUpdate brand guide (free, no credits)
generateBrandGuideAI-generate brand guide from Twin knowledge (5 credits)
listBrandVoicesList all brand voice profiles
createBrandVoiceCreate a brand voice manually
updateBrandVoiceUpdate an existing brand voice
deleteBrandVoiceDelete a brand voice
generateBrandVoiceAI-generate a brand voice analysis (5 credits)

Notifications

ToolUse
getNotificationsList notifications (unread, by type, paginated)
markNotificationReadMark one or all notifications as read
getNotificationPreferencesGet notification channel preferences

Account

ToolUse
listAccountsConnected social accounts + content languages
getCreditsCredit balance, plan, cost table
getAnalyticsPost stats and workspace analytics

Common Workflows

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

Quick: Create and publish a post

text
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

text
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

text
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

OperationCredits
Post10
Article50
Hook simulation5
Image10
First comment2
Twin query2
Brand guide generate5
Brand voice generate5
Always check twinfold.getCredits before heavy operations.

Error Handling

  • 401 → Invalid API key
  • 402 → Insufficient credits (check with getCredits)
  • 400 → Bad arguments (error message explains what's wrong)
  • 429 → Rate limited (wait and retry)

Tips

  • Use autoAdapt: true on createPost to get platform-optimized versions automatically
  • Set language: "fr-CA" for authentic Quebec French content
  • Use getTrendscreatePost for trend-jacking workflows
  • repurposeContent turns blog posts, transcripts, or notes into social posts
  • planContent creates a full week of drafts in one call
  • Autopilot runs daily — use getAutopilotQueue + approvePost for review workflows

Installation

Terminal bash

openclaw install twinfold
    
Copied!

💻Code Examples

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

curl-httpstwinfoldappapimcptools.txt
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](references/workflows.md).

### Quick: Create and publish a post

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

1-twinfoldcreatepost--topic-platforms-language-autoadapt-true-autopublish-true-.txt
One call does it all — generates content, adapts per platform, publishes.

### Quick: Create, review, then publish
example.txt
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 }
example.txt
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 }

Tags

#image_and-video-generation

Quick Info

Category Content Creation
Model Claude 3.5
Complexity Multi-Agent
Author lpbaril
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install twinfold