Reeling MCP server
[MCP checks]
[GitHub release]
[License: MIT]
[Glama validation]
Official open-source Model Context Protocol (MCP) server for Reeling, an AI social media scheduler and short-form video publishing platform.
Use Reeling from Claude Desktop, Cursor, Windsurf, OpenClaw, ChatGPT-compatible connectors, or your own MCP client. The server gives an AI agent a controlled interface for cross-platform social publishing, scheduling, analytics, audience comments, and content adaptation.
This repository is the public developer companion for Reeling. It contains the MCP adapter; runnable API examples live in reeling-examples; Reeling's private application, production infrastructure, customer data, and credentials are not part of this repository.
Links: Reeling homepage · AI Plugins & Skills Hub · 15 Channel Integrations · Developer portal · Hosted MCP install · API settings · Pricing
Platform integrations (15 supported channels)
Availability depends on the connected account, app access and current capabilities. TikTok inbox delivery requires finishing in TikTok; X (Companion mode), Reddit (Companion mode), Medium, and Quora use the Reeling Companion Chrome extension to bridge your authenticated browser session. Check the current platform matrix before publishing.
- 🎵 TikTok
- 📸 Instagram Reels & Stories
- ▶️ YouTube Shorts & Video
- 🦋 Bluesky
- 🧵 Threads
- 📌 Pinterest
- 💼 LinkedIn
- 🐦 Twitter / X (OAuth 2.0 or Free Companion Bridge)
- 👽 Reddit (Companion Bridge or Script OAuth + Topic Radar & Spam Shield)
- ❓ Quora (Companion Bridge + Question Radar & 75-Word Burden-of-Proof Shield)
- ✍️ Medium (Companion Bridge + AI Cliché & Tag Shield)
- 📘 Facebook Pages
- 💬 Discord & Telegram
- 🐘 Mastodon
🛠️ Available MCP Tools (16 Tools)
🔑 Getting Started
-
Obtain your API Key:
- Go to reeling.app and sign in.
- Navigate to Settings → API Keys.
- Generate a new key (starts with
rl_...).
-
Run the server:
Or connect to the hosted Streamable HTTP endpoint at https://mcp.reeling.app/mcp using the installation guide.
💻 Configuration Examples
1. Claude Desktop
Add this to your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Or run directly from source:
2. Cursor IDE
Create or edit .cursor/mcp.json in your project root:
3. Antigravity (AGY)
Add to your ~/.gemini/antigravity-cli/mcp_config.json or project MCP configuration:
4. Remote Hosted SSE Server (for Grok Bot, Claude Remote, Web Agents)
You can run reeling-mcp as a persistent Server-Sent Events (SSE) server for remote AI agents:
Endpoints exposed:
GET /health: Health check status.
GET /sse: Server-Sent Events connection stream (provide a credential through your client’s secret header configuration).
POST /messages?sessionId=...: JSON-RPC protocol message receiver.
Grok Bot Configuration (xAI)
Add to your Grok Bot custom MCP servers:
- Transport: SSE
- Endpoint:
https://mcp.reeling.app/sse (or http://localhost:3005/sse)
- Headers:
X-API-Key: rl_your_live_api_key_here
🤖 Agent integrations
The hosted server exposes installable bundles and connector metadata for ChatGPT-compatible connectors, Claude, and Grok at mcp.reeling.app/install. The local package works with any MCP client that can launch an npm package or connect to the HTTP transport.
For API-level integrations, see the Reeling developer portal. Please open an issue when you build a client, example, or platform adapter that other Reeling users could reuse.
🧪 Testing Locally
You can test the MCP server manually using the MCP inspector:
Or test SSE mode:
📄 License
MIT © reeling.app
Contributing
Issues and pull requests are welcome for client compatibility, documentation, examples, and safe improvements to the MCP transport. Do not commit API keys, production URLs containing secrets, customer data, or private Reeling application code. See the repository's security policy before reporting a vulnerability.
Working examples
Clone reeling-examples for account discovery, a reviewed video request, bounded delivery-status polling, analytics retrieval and an editable content calendar. Start in offline mode. Read the example guide.
Architecture
The adapter sends authenticated requests to the Reeling API. Account, plan and platform permissions determine what can run. Review write tools in your client; a tool result or upload receipt alone does not establish public publication.
Development and releases
See CONTRIBUTING.md, CHANGELOG.md, and GitHub releases. Installs above use a versioned GitHub tag; npm publication requires a separate authenticated npm release.
Setup guide preview
[Reeling MCP setup guide with transport choices and configuration instructions]
Local preview of the public developer guide. Open the current setup guide.