replynodes

@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