MCP Server
The QiQ Social MCP (Model Context Protocol) server lets AI assistants like Claude manage your social media automations, create and publish posts, and interact with your workspace — all through natural language.
What is MCP?
Model Context Protocol is an open standard that allows AI assistants to securely connect to external tools and data sources. With the QiQ Social MCP server, you can control your entire content pipeline from Claude Desktop, Claude Code, VS Code, or any MCP-compatible client.
Available Tools
| Tool | Description |
|---|---|
list_workspaces | List all workspaces you have access to |
list_automations | List automations in a workspace |
get_automation | Get details of a specific automation |
create_automation | Create a new automation with scheduling and channel targeting |
update_automation | Update automation settings |
delete_automation | Delete an automation |
run_automation | Trigger content generation immediately |
list_connections | List platform OAuth connections |
list_channels | List publishing channels (Facebook pages, Telegram groups, etc.) |
list_posts | List posts with status and automation filters |
get_post | Get post details including content and metrics |
create_post | Create a draft post for a channel |
update_post | Edit a draft post’s content |
delete_post | Delete a draft post |
publish_post | Publish a post to its platform |
list_sources | List RSS feed sources |
create_source | Add an RSS feed source |
delete_source | Remove an RSS feed source |
validate_rss | Validate an RSS feed URL |
text_assist | AI text enhancement (proofread, rephrase, generate) |
media_assist | Search stock photos or generate AI images |
generate_hashtags | Generate platform-optimized hashtags |
list_assets | List media library assets |
list_labels | List workspace labels |
get_subscription_status | Check plan and usage limits |
Connecting
The MCP server is hosted at https://qiq.social/mcp and speaks the Streamable HTTP transport — there is nothing to install.
Claude Desktop
Edit your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"qiq-social": {
"type": "url",
"url": "https://qiq.social/mcp"
}
}
}Claude Code
claude mcp add --transport http qiq-social https://qiq.social/mcpVS Code
Add to .vscode/mcp.json:
{
"servers": {
"qiq-social": {
"type": "http",
"url": "https://qiq.social/mcp"
}
}
}Authentication
Tools that read or modify workspace data need your QiQ Social access token. Copy it from Settings → API in the web app and send it as a bearer token:
{
"mcpServers": {
"qiq-social": {
"url": "https://qiq.social/mcp",
"headers": {
"Authorization": "Bearer <your-access-token>"
}
}
}
}How It Works
AI Assistant ←→ https://qiq.social/mcp ←→ QiQ Social API- Your AI client connects to the endpoint over the Streamable HTTP transport
- The server authenticates to QiQ Social with the access token you supply
- Tools execute queries and operations on your behalf
- Results are returned to the assistant as structured data
Automation Types
When creating automations, use these types:
| Type | Description | Requires Topic |
|---|---|---|
write_social | AI-generated social media posts | Yes |
write_blog | AI-generated blog articles | Yes |
rss_social | Repurpose RSS feed items as social posts | No |
rss_blog | Repurpose RSS feed items as blog articles | No |
rss_digest_blog | Digest multiple RSS items into one blog post | No |
Post Content Structure
Social Posts
{
"content": "Your post text here",
"media": [
{ "type": "image", "url": "https://example.com/photo.jpg" }
]
}Blog Posts (WordPress, Webflow)
{
"title": "Article Title",
"content": "<h2>Heading</h2><p>HTML content...</p>",
"excerpt": "A short summary",
"tags": ["marketing", "ai"],
"media": [
{ "type": "image", "url": "https://example.com/hero.jpg" }
]
}Discord Posts (with embed)
{
"content": "Check out this article!",
"embed": {
"title": "Article Title",
"description": "Article summary",
"url": "https://example.com/article"
}
}Platform Constraints
Each channel placement has character limits and media constraints:
| Platform | Placement | Max Characters | Max Media |
|---|---|---|---|
instagram_account | 2,200 | 10 | |
facebook_page | 63,206 | 80 | |
linkedin_profile | 3,000 | 20 | |
| X | x_profile | 280 | 4 |
| Telegram | telegram_channel | 4,096 | 10 |
| Discord | discord_channel | 2,000 | — |
| Threads | threads_profile | 500 | 10 |
pinterest_board | 500 | 1 | |
| Bluesky | bluesky_profile | 300 | 4 |
| TikTok | tiktok_account | 2,200 | 1 (video) |
| YouTube | youtube_channel | 5,000 | 1 (video) |
| Google Business | google_business_location | 1,500 | 1 |
| Mastodon | mastodon_account | 500 | 4 |