twinfold

由您的代理控制 Twinfold——人工智能驱动的社交媒体内容平台。创建帖子、生成图像、以 13 种语言适应 10 个平台的内容、管理自动驾驶、发布和跟踪分析。当用户想要创建社交媒体内容、发布到 LinkedIn/Twitter/Instagram/等、管理内容日历、运行自动驾驶内容生成、检查趋势或与 Twinfold 帐户交互时使用。触发条件：发布、发布、推文、linkedin、社交媒体、内容、日程、自动驾驶、双折、主题、适应、趋势、重新利用。

## 概述（中文）

由您的代理控制 Twinfold——人工智能驱动的社交媒体内容平台。创建帖子、生成图像、以 13 种语言适应 10 个平台的内容、管理自动驾驶、发布和跟踪分析。当用户想要创建社交媒体内容、发布到 LinkedIn/Twitter/Instagram/等、管理内容日历、运行自动驾驶内容生成、检查趋势或与 Twinfold 帐户交互时使用。触发条件：发布、发布、推文、linkedin、社交媒体、内容、日程、自动驾驶、双折、主题、适应、趋势、重新利用。

## 原文

# Twinfold Skill

Control [Twinfold](https://twinfold.app) — 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 <TWINFOLD_API_KEY>`  
**Body:** `{ "tool": "twinfold.<toolName>", "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

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

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 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 `getTrends` → `createPost` 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