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

Installation

No API keys or configuration needed — the server connects to QiQ Social automatically.

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": {
      "command": "npx",
      "args": ["-y", "@qiq/mcp"]
    }
  }
}

Claude Code

claude mcp add qiq-social -- npx -y @qiq/mcp

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "qiq-social": {
      "command": "npx",
      "args": ["-y", "@qiq/mcp"]
    }
  }
}

Remote (HTTP)

If you prefer not to install anything locally, you can connect to the hosted MCP server at mcp.qiq.social.

Claude Desktop — edit your config file:

{
  "mcpServers": {
    "qiq-social": {
      "type": "url",
      "url": "https://mcp.qiq.social/mcp"
    }
  }
}

VS Code — add to .vscode/mcp.json:

{
  "servers": {
    "qiq-social": {
      "type": "http",
      "url": "https://mcp.qiq.social/mcp"
    }
  }
}

How It Works

The MCP server supports two transport modes:

• Local (stdio): Runs on your machine via npx. Your AI assistant spawns and communicates with the process directly.
• Remote (HTTP): Hosted at mcp.qiq.social. Your AI client connects over HTTP using the Streamable HTTP transport.

Both modes connect to the same QiQ Social backend with built-in credentials — no API keys needed.

AI Assistant ←→ MCP Server (local or remote) ←→ QiQ Social API

1. Your AI assistant connects to the MCP server (spawns locally or connects via HTTP)
2. The server connects to QiQ Social using the built-in API credentials
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:

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: