@replynodes/mcp

Connect Claude, Cursor, Codex, OpenClaw, Hermes, 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 Developers → API Keys & Agents (app.replynodes.com/developers) and create a key.
3. Keep it secret — it grants full access to your Replynodes organization.

Setup

Claude Code (as a plugin)

This repo is also a Claude Code plugin marketplace, so you can install it with:

/plugin marketplace add replynodes/replynodes-mcp
/plugin install replynodes-mcp@replynodes-mcp

You'll be prompted for your Replynodes API key; Claude Code stores it and starts the MCP server for you.

Claude Desktop / Claude Code (manual MCP config)

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

| Tool | What it does | | --- | --- | | groupList | List your groups/customers, for filtering integrations | | integrationList | List connected social integrations (channels), optionally scoped to a group | | integrationSchema | Get the schema/required fields for scheduling a post to a given integration | | triggerTool | Trigger an integration action once you have the ids/fields it needs | | integrationSchedulePostTool (a.k.a. schedulePostTool) | Schedule a post to one or more integrations | | postsList | List posts for the current organization, most recent first | | postsUpdate | Edit an existing post in place | | postAnalytics | Read performance for a published post | | ask_replynodes | Ask the ReplyNodes agent a question | | draftPostFromSource | Turn a public URL or pasted source into a sourced brief and draft | | planFounderDistributionAngles | Create a normalized brief and three distribution angles | | generateImageTool | Generate an image to attach to a post | | generateVideoTool / generateVideoOptions / videoFunctionTool | Generate video content and resolve provider-specific options | | uploadFromUrlTool | Upload a remote image/video into the media library from a public URL |

Tool availability depends on your Replynodes plan and connected integrations.

Environment variables

| Variable | Required | Description | | --- | --- | --- | | REPLYNODES_API_KEY | yes | Your Replynodes API key | | REPLYNODES_MCP_URL | no | Override 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 Developers → API Keys & Agents (app.replynodes.com/developers) if it leaks.

Related

Looking for the agent side of this — skills that draft, review, and prepare content before it reaches integrationSchedulePostTool (a.k.a. schedulePostTool)? See Awesome Social Media Skills, an open-source library of portable AI agent skills for social content, with a quickstart showing how the two fit together.

License

MIT