Reeling

io.github.yomarianoPublished by GitHub account yomarianov1.0.1Updated Oct 25, 2026

Social publishing, scheduling and delivery-status tools for Reeling accounts.

VerifiedStreamable HTTPWeb executable

Overview

Reeling's hosted MCP server (mcp.reeling.app); API key required; Streamable HTTP; 18 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
mcp.reeling.app
Last checked

Installation

In SourceWeft

  1. Open Reeling in the dashboard and add it to a workspace.
  2. Connect X-API-Key credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.yomariano%2Freeling/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "reeling": {
      "type": "http",
      "url": "https://mcp.reeling.app/mcp",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

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)

Tool NameDescription
reeling_list_projectsLists all projects & workspaces in your Reeling account.
reeling_list_channelsLists all connected channels across all 15 networks with handle names and account status.
reeling_get_channel_optionsRetrieves publishing options for a connected channel, such as Pinterest boards (ID, name, privacy) or TikTok creator options.
reeling_publish_postPublishes or schedules short-form videos, articles, or community answers across targeted platforms (includes Pre-Publish Spam Shield & 3/day, 3/week cadence guard).
reeling_get_post_statusChecks delivery, processing, and publishing status for a specific post.
reeling_discover_community_questionsDiscovers high-intent daily questions on Reddit and Quora matching your topics and returns remaining daily/weekly cadence quota.
reeling_draft_community_answerGenerates a value-first, non-promotional answer for a Reddit or Quora thread and evaluates its 0–100 Pre-Publish Spam & Shadowban score.
reeling_get_analyticsFetches aggregated analytics: total views, likes, comments, impressions, and per-platform breakdown.
reeling_sync_metricsTriggers a live sync against YouTube, Bluesky, Instagram, Threads, and TikTok APIs.
reeling_evaluate_content_jevEvaluates video scripts and captions using Reeling's JEV hook and retention diagnostics.
reeling_get_inboxRetrieves audience comments across social channels into a unified inbox.
reeling_reply_to_commentPosts a direct reply to a comment on any connected social platform.
reeling_adapt_content_aiUses Reeling's AI copy engine to adapt a hook/script for TikTok, Instagram, YouTube, Threads, or Bluesky.
reeling_generate_videoRequests short-form video generation through Reeling’s configured service; plan allowance and provider processing apply.
reeling_create_storyboardGenerates structured multi-scene storyboards (30s up to 5 minutes) broken into consecutive 5s cinematic cuts with audio/foley cues.
reeling_stitch_storyboardRequests scene rendering and stitching through Reeling’s configured video workflow.

🔑 Getting Started

  1. Obtain your API Key:

    • Go to reeling.app and sign in.
    • Navigate to Settings → API Keys.
    • Generate a new key (starts with rl_...).
  2. Run the server:

    bash
    npx -y github:yomariano/reeling-mcp#v1.1.0

    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
json
{  "mcpServers": {    "reeling": {      "command": "npx",      "args": ["-y", "github:yomariano/reeling-mcp#v1.1.0"],      "env": {        "REELING_API_KEY": "rl_your_live_api_key_here",        "REELING_API_URL": "https://api.reeling.app"      }    }  }}

Or run directly from source:

json
{  "mcpServers": {    "reeling": {      "command": "node",      "args": ["/absolute/path/to/reeling-mcp/bin/cli.js"],      "env": {        "REELING_API_KEY": "rl_your_live_api_key_here"      }    }  }}

2. Cursor IDE

Create or edit .cursor/mcp.json in your project root:

json
{  "mcpServers": {    "reeling": {      "command": "npx",      "args": ["-y", "github:yomariano/reeling-mcp#v1.1.0"],      "env": {        "REELING_API_KEY": "rl_your_live_api_key_here"      }    }  }}

3. Antigravity (AGY)

Add to your ~/.gemini/antigravity-cli/mcp_config.json or project MCP configuration:

json
{  "mcpServers": {    "reeling": {      "command": "node",      "args": ["/absolute/path/to/reeling-mcp/bin/cli.js"],      "env": {        "REELING_API_KEY": "rl_your_live_api_key_here"      }    }  }}

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:

bash
# Run locally or deploy to Railway / Render / VPS / Dockernpx -y github:yomariano/reeling-mcp#v1.1.0 --sse --port 3005

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:

bash
npx @modelcontextprotocol/inspector node bin/cli.js

Or test SSE mode:

bash
node bin/cli.js --sse --port 3005curl http://localhost:3005/health

📄 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

mermaid
flowchart LR  Client[Your MCP client] -->|stdio or HTTPS /mcp| Adapter[Reeling MCP adapter]  Adapter -->|API key| API[Reeling REST API]  API --> Queue[Publishing queue]  Queue --> Channels[Authorized social channels]  API -->|Per-destination state| Adapter

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

sh
npm cinpm testnpm run checknpm pack --dry-run

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.

Source: README.md at commit 940fb2c

Tools

18

reeling_get_platform_matrix

PUBLIC DISCOVERY TOOL (No API key required): Returns Reeling's 15 supported social and community platforms, authentication methods (Direct OAuth 2.0 vs free Reeling Companion Chrome Extension), file/character limits, and pricing tiers.

Parametersplatform

reeling_check_spam_score

PUBLIC DISCOVERY TOOL (No API key required): Evaluates a draft title and post body against Reeling's Pre-Publish Spam & AutoModerator Shield for Reddit, Quora, Medium, LinkedIn, or X. Returns a 0–100 safety_score, specific trigger explanations, auto-sanitized copy, and a shareable verification badge.

Parameterstitlecontentrequiredplatform

reeling_list_projects

List all projects / workspaces available in your reeling.app account.

Parametersapi_key

reeling_list_channels

List all connected social media channels (YouTube, TikTok, Instagram, Bluesky, Threads, Pinterest, LinkedIn, Twitter/X, Discord, Telegram, etc.) with account details, usernames, and statuses.

Parametersapi_keyproject_id

reeling_publish_post

Publish or schedule short-form videos, articles, and posts across multiple social platforms simultaneously (TikTok, Instagram Reels, YouTube Shorts, Threads, Bluesky, Facebook, Twitter/X, LinkedIn, Pinterest, Medium, Quora, Reddit).

Parametersmodetagstitleapi_keycontentrequiredplatformsrequiredsubredditvideo_urlproject_idtarget_urlscheduled_atthumbnail_url+3 more

reeling_discover_community_questions

Discover daily Reddit threads and Quora questions matching target keywords & subreddits, and check the account's safe Cadence Guard counters (max 3 answers/day & max 3 top-level posts/week).

Parametersapi_keykeywordsproject_idsubreddits

reeling_draft_community_answer

Draft a value-first, non-spammy answer for a Reddit thread or Quora question, verified by Reeling's Spam Shield.

Parametersapi_keyplatformrequiredsubredditquestion_titlerequiredproject_contextquestion_snippet

reeling_get_channel_options

Retrieve publishing options for a connected channel, such as Pinterest boards (ID, name, privacy) or TikTok creator configurations.

Parametersapi_keychannel_idrequired

reeling_get_post_status

Retrieve delivery and publishing status for a post across all targeted social networks.

Parametersapi_keypost_idrequired

reeling_get_analytics

Retrieve aggregated performance analytics across all connected platforms (views, likes, comments, impressions, platform breakdown, and top-performing posts).

Parametersapi_keyend_datestart_date

reeling_sync_metrics

Trigger an on-demand real-time metric sync against live APIs (YouTube, Bluesky, Instagram, Threads, TikTok).

Parametersapi_keypost_id

reeling_evaluate_content_jev

Run a Type-Safe JEV (Judgment & Evaluation Vector) diagnostic on published post metrics. Evaluates 0-3s hook velocity, cognitive concept fit, visual/code density, engagement triggers, and drop-off causes with Zod schema validation, returning actionable content prescriptions for future generations.

Parametersapi_keyforce_fresh

reeling_get_inbox

Fetch the unified social inbox containing audience comments and feedback across YouTube, Bluesky, Instagram, Threads, and TikTok.

Parametersapi_keyplatform

reeling_reply_to_comment

Send a direct reply to a comment on a social network (YouTube, Bluesky, Instagram, Threads, TikTok).

Parametersapi_keyplatformrequiredcomment_idrequiredreply_textrequiredreply_context

reeling_adapt_content_ai

Use Reeling's AI content adapter to transform a single hook, script, or topic into platform-tailored copy for TikTok, Instagram Reels, YouTube Shorts, Threads, and Bluesky.

Parameterstonetopicrequiredapi_keyplatforms

reeling_generate_video

Generate short-form video clips in seconds using fal.ai MiniMax H3 Max and Video-01 text-to-video AI models. Automatically saves the video to Cloudflare R2 storage and returns the public media URL ready for publishing to YouTube, TikTok, Instagram, etc.

Parameterspromptrequiredapi_keyimage_urlfal_api_keyaspect_ratio

reeling_create_storyboard

Generate an AI multi-scene storyboard (from 30 seconds up to 5 minutes) broken into sequential 5-second cinematic cuts with timecodes, scene titles, camera movements, and audio/foley cues.

Parametersstyletopicrequiredcameraapi_keyduration_seconds

reeling_stitch_storyboard

Render each scene in a storyboard via fal.ai MiniMax H3 and stitch them into a single continuous MP4 video with FFmpeg, uploading the final result to Cloudflare R2 storage.

Parametersscenesrequiredapi_keyfal_api_keyaspect_ratio

Version history

1
  1. v1.0.1LatestOct 20, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts