Skip to Content
MCP ServerOverview

MCP Server

smithery badge

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

ToolDescription
list_workspacesList all workspaces you have access to
list_automationsList automations in a workspace
get_automationGet details of a specific automation
create_automationCreate a new automation with scheduling and channel targeting
update_automationUpdate automation settings
delete_automationDelete an automation
run_automationTrigger content generation immediately
list_connectionsList platform OAuth connections
list_channelsList publishing channels (Facebook pages, Telegram groups, etc.)
list_postsList posts with status and automation filters
get_postGet post details including content and metrics
create_postCreate a draft post for a channel
update_postEdit a draft post’s content
delete_postDelete a draft post
publish_postPublish a post to its platform
list_sourcesList RSS feed sources
create_sourceAdd an RSS feed source
delete_sourceRemove an RSS feed source
validate_rssValidate an RSS feed URL
text_assistAI text enhancement (proofread, rephrase, generate)
media_assistSearch stock photos or generate AI images
generate_hashtagsGenerate platform-optimized hashtags
list_assetsList media library assets
list_labelsList workspace labels
get_subscription_statusCheck 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/mcp

VS 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
  1. Your AI client connects to the endpoint over the Streamable HTTP transport
  2. The server authenticates to QiQ Social with the access token you supply
  3. Tools execute queries and operations on your behalf
  4. Results are returned to the assistant as structured data

Automation Types

When creating automations, use these types:

TypeDescriptionRequires Topic
write_socialAI-generated social media postsYes
write_blogAI-generated blog articlesYes
rss_socialRepurpose RSS feed items as social postsNo
rss_blogRepurpose RSS feed items as blog articlesNo
rss_digest_blogDigest multiple RSS items into one blog postNo

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:

PlatformPlacementMax CharactersMax Media
Instagraminstagram_account2,20010
Facebookfacebook_page63,20680
LinkedInlinkedin_profile3,00020
Xx_profile2804
Telegramtelegram_channel4,09610
Discorddiscord_channel2,000
Threadsthreads_profile50010
Pinterestpinterest_board5001
Blueskybluesky_profile3004
TikToktiktok_account2,2001 (video)
YouTubeyoutube_channel5,0001 (video)
Google Businessgoogle_business_location1,5001
Mastodonmastodon_account5004
Last updated on