MCP Introduction

Model Context Protocol (MCP) Server Integration

Model Context Protocol (MCP) Integration

The ReplyNodes MCP server enables AI models, LLMs, and code editors to interact with your ReplyNodes account programmatically. Use it to build AI agents that can schedule posts, manage integrations, and generate media.

What is MCP?

The Model Context Protocol is an open standard developed by Anthropic that allows LLMs and AI models to use external tools and access data sources in a standardized way. It's used by Claude Code, Cursor, VS Code, and other AI-powered tools.

MCP servers expose "tools" that AI models can call, enabling natural language workflows like:

"Schedule a post about this topic on Twitter and LinkedIn"
"Generate a video and post it to all my channels"
"Show me what integrations I have connected"

ReplyNodes MCP Server

Base URL

https://api.replynodes.com/mcp

Authentication Methods

The MCP server supports two authentication methods:

1. Path-based (simpler for setup):

https://api.replynodes.com/mcp/:apiKey

2. Header-based (more secure):

POST https://api.replynodes.com/mcp
Header: Authorization: Bearer YOUR_API_KEY

Available Tools

The ReplyNodes MCP server provides 10 tools for AI workflows:

Post Management

IntegrationSchedulePostTool - Schedule posts to specific integrations with timing and content
IntegrationValidationTool - Validate post content against channel rules and requirements

Integration Management

IntegrationListTool - List all connected social media integrations
GroupListTool - List integration groups (channels)
IntegrationTriggerTool - Execute integration-specific actions and triggers

Media & Content Generation

GenerateVideoTool - Generate AI videos from scripts
GenerateVideoOptionsTool - Get available video generation options
VideoFunctionTool - Call specific video manipulation functions
GenerateImageTool - Generate AI images
UploadFromUrlTool - Upload media files from URLs

Quick Setup

Claude Code / Terminal

# Add the MCP server to Claude Code
claude mcp add replynodes --transport http "https://api.replynodes.com/mcp/:YOUR_API_KEY"

Or with header-based auth:

claude mcp add --transport http replynodes https://api.replynodes.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "replynodes": {
      "url": "https://api.replynodes.com/mcp/:YOUR_API_KEY"
    }
  }
}

Or with header auth:

{
  "mcpServers": {
    "replynodes": {
      "url": "https://api.replynodes.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code with Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "replynodes": {
      "type": "http",
      "url": "https://api.replynodes.com/mcp/:YOUR_API_KEY"
    }
  }
}

Or with header auth:

{
  "servers": {
    "replynodes": {
      "type": "http",
      "url": "https://api.replynodes.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "replynodes": {
      "serverUrl": "https://api.replynodes.com/mcp/:YOUR_API_KEY"
    }
  }
}

Or with header auth:

{
  "mcpServers": {
    "replynodes": {
      "serverUrl": "https://api.replynodes.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Amp

amp mcp add replynodes https://api.replynodes.com/mcp/:YOUR_API_KEY

Codex

Add to ~/.codex/config.toml:

[mcp_servers.replynodes]
url = "https://api.replynodes.com/mcp/:YOUR_API_KEY"

Or with header auth:

[mcp_servers.replynodes]
url = "https://api.replynodes.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "replynodes": {
      "url": "https://api.replynodes.com/mcp/:YOUR_API_KEY"
    }
  }
}

Warp

Use the settings UI:

Settings > MCP Servers > + Add
Paste this config:

{
  "replynodes": {
    "url": "https://api.replynodes.com/mcp/:YOUR_API_KEY"
  }
}

Or with header auth:

{
  "replynodes": {
    "url": "https://api.replynodes.com/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

Using MCP Tools

Once configured, you can use natural language to interact with ReplyNodes:

Example: Schedule a Post

In Claude Code or any MCP-enabled editor:

"Schedule a post saying 'Check out our new feature!' to Twitter and LinkedIn for tomorrow at 2 PM"

The AI will:

Parse your request
Call IntegrationListTool to find your Twitter and LinkedIn connections
Call IntegrationSchedulePostTool to schedule the post
Provide a confirmation with the post ID

Example: Generate and Post Video

"Generate a 30-second video about AI scheduling tools and post it to all my channels"

The AI will:

Call GenerateVideoOptions to get available templates
Call GenerateVideoTool with your script
Call IntegrationListTool to get all channels
Call IntegrationSchedulePostTool to post the video to each channel

Example: List All Integrations

"What social media channels do I have connected?"

The AI will call IntegrationListTool and show you all your connected channels with details.

Tool Descriptions

IntegrationSchedulePostTool

Schedule posts to specific integrations. Supports:

Text content and images
Multiple integrations in one request
Scheduled or immediate posting
Custom posting times

IntegrationValidationTool

Validates post content against channel-specific rules:

Character limits (varies by platform)
Allowed media types
Format requirements
Platform-specific restrictions

IntegrationListTool

Returns all connected social media integrations with:

Integration ID and name
Platform type (Twitter, LinkedIn, etc.)
Connection status
Profile information

GroupListTool

Lists all integration groups (channels) you've created:

Group ID and name
Associated integrations
Group organization

IntegrationTriggerTool

Executes platform-specific actions and triggers available for each integration.

GenerateVideoTool

Generate AI videos from scripts or descriptions:

Supports multiple video styles
Custom duration
Branding options

GenerateVideoOptionsTool

Get available options for video generation:

Available templates
Duration options
Style choices
Branding customization

VideoFunctionTool

Call specific video manipulation functions:

Resize and crop
Add text overlays
Apply filters
Add music or sound effects

GenerateImageTool

Generate AI images from text descriptions:

Text-to-image generation
Style selection
Size and aspect ratio control

UploadFromUrlTool

Upload media from URLs:

Download and store files
Automatic format detection
CDN delivery

Security & Rate Limits

Your API key authorizes all MCP requests
Same rate limits apply as the REST API
Audit logs track all MCP tool usage
Use OAuth tokens for multi-user applications

Troubleshooting

"Connection refused"

Verify your internet connection
Ensure the ReplyNodes servers are accessible
Check your firewall/VPN settings

"Authentication failed"

Verify your API key is correct
Ensure it hasn't been revoked
Check key expiration in Settings

"Tool not found"

Verify the MCP server is properly configured
Check that your client supports MCP
Try reconnecting the MCP server

Next Steps

Public API Reference - REST API for programmatic access
CLI Tool - Command-line interface
OAuth Applications - Build apps for other users

MCP Introduction

On this page