ReplyNodes

Connect AI agents to schedule posts automatically to 30+ social media networks

Documentation

@replynodes/mcp

npm version License: MIT

Connect Claude, Cursor, Codex, OpenClaw, or any other Model Context Protocol client to your Replynodes account, so your AI agent can list your social channels, schedule posts, generate images/video for posts, and manage your Replynodes workspace directly from chat.

Replynodes already runs a remote MCP server (https://app.replynodes.com/api/mcp). This package is a thin, zero-maintenance bridge for MCP clients that only support local (stdio) servers — it forwards everything to that remote server using mcp-remote, and authenticates with your Replynodes API key.

If your client already supports remote MCP servers natively (e.g. Claude.ai custom connectors, Claude Code, VS Code Copilot), you don't need this package at all — see Native remote MCP below.

Get an API key

  1. Log in to app.replynodes.com.
  2. Go to Settings → API Keys and create a key.
  3. Keep it secret — it grants full access to your Replynodes organization.

Setup

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "replynodes": {
      "command": "npx",
      "args": ["-y", "@replynodes/mcp"],
      "env": {
        "REPLYNODES_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / Windsurf

Same shape, under Cursor's mcp.json / Windsurf's MCP settings:

{
  "mcpServers": {
    "replynodes": {
      "command": "npx",
      "args": ["-y", "@replynodes/mcp"],
      "env": { "REPLYNODES_API_KEY": "your-api-key-here" }
    }
  }
}

Codex CLI / OpenClaw / other agent frameworks

Run it directly as a stdio command:

REPLYNODES_API_KEY=your-api-key-here npx -y @replynodes/mcp

Point your framework's MCP tool config at that command the same way you would configure any other stdio MCP server.

Native remote MCP (no install)

Clients that speak remote MCP directly can skip this package entirely and connect straight to:

URL:     https://app.replynodes.com/api/mcp
Header:  Authorization: Bearer <your-api-key>

An OAuth-based connector flow is also available at https://app.replynodes.com/api/mcp-oauth for clients that support MCP OAuth discovery instead of static API keys.

Available tools

ToolWhat it does
groupListList your groups/customers, for filtering integrations
integrationListList connected social integrations (channels), optionally scoped to a group
integrationSchemaGet the schema/required fields for scheduling a post to a given integration
triggerToolTrigger an integration action once you have the ids/fields it needs
schedulePostToolSchedule a post to one or more integrations
generateImageToolGenerate an image to attach to a post
generateVideoTool / generateVideoOptions / videoFunctionToolGenerate video content and resolve provider-specific options
uploadFromUrlToolUpload a remote image/video into the media library from a public URL

Tool availability depends on your Replynodes plan and connected integrations.

Environment variables

VariableRequiredDescription
REPLYNODES_API_KEYyesYour Replynodes API key
REPLYNODES_MCP_URLnoOverride the remote MCP endpoint (defaults to https://app.replynodes.com/api/mcp)

Any extra CLI arguments passed to replynodes-mcp are forwarded to mcp-remote (e.g. --debug).

Security

Your API key grants access to your Replynodes organization. It is only used as a Bearer token sent directly to app.replynodes.com — this package does not transmit it anywhere else. Treat it like a password; rotate it in Settings → API Keys if it leaks.

License

MIT