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.
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 |
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
Installation
openclaw install twinfold
💻Code Examples
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](references/workflows.md).
### Quick: Create and publish a post1. twinfold.createPost { topic, platforms, language, autoAdapt: true, autoPublish: true }
One call does it all — generates content, adapts per platform, publishes.
### Quick: Create, review, then publish1. 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 }Tags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.
Adversarial Prompting
Adversarial analysis to critique, fix.