MCP server (`rcs-mcp`)

rcs-mcp is a hand-rolled Model Context Protocol server — newline-delimited JSON-RPC over stdio, zero runtime dependencies. Register it once and Claude (or any MCP host) can search, render, clone, author, and send templates as native tools.

The MCP server ships in the @rcs-campaigns/agent-toolkit package and is a Pro-plan feature.

Prerequisites

A scoped agent API key (rcsk_live_…).
Your gateway URL (the /api/agent base — your self-hosted server or the hosted gateway).
Node.js (the server runs via npx, no global install required).

Register with Claude

A single claude mcp add command points the host at the packaged server with your gateway URL and key:


claude mcp add rcs-campaigns \
  --env RCS_GATEWAY_URL=https://your-server \
  --env RCS_AGENT_KEY=rcsk_live_… \
  -- npx -y -p @rcs-campaigns/agent-toolkit rcs-mcp

That’s it — the tools then appear natively in the agent.

Register with any MCP host

Any MCP host that supports stdio servers can launch rcs-mcp the same way. Use this JSON server entry (the shape most hosts accept):


{
  "mcpServers": {
    "rcs-campaigns": {
      "command": "npx",
      "args": ["-y", "-p", "@rcs-campaigns/agent-toolkit", "rcs-mcp"],
      "env": {
        "RCS_GATEWAY_URL": "https://your-server",
        "RCS_AGENT_KEY": "rcsk_live_…"
      }
    }
  }
}

The 48 tools

Registering the server gives your agent 48 native tools — each one is exactly one gateway call, spanning templates, conversational surveys, grounding knowledge, audiences, contacts, the conversation inbox, webhooks, and usage:

Tool	Scope required
Discovery
`capabilities`	any key
Templates
`search_templates`	`templates:read`
`get_template`	`templates:read`
`render_template`	`templates:read`
`create_template`	`templates:write`
`update_template`	`templates:write`
`duplicate_template`	`templates:write`
`delete_template`	`templates:write`
`clone_template`	`marketplace:clone`
`submit_template`	`templates:submit`
`send_message`	`messages:send`
Surveys
`search_surveys`	`surveys:read`
`get_survey`	`surveys:read`
`render_survey`	`surveys:read`
`create_survey`	`surveys:write`
`clone_survey`	`marketplace:clone`
`delete_survey`	`surveys:write`
`submit_survey`	`surveys:submit`
`send_survey`	`surveys:send`
`update_survey`	`surveys:write`
`list_survey_sends`	`surveys:read`
`send_survey_test`	`surveys:send`
`get_results`	`results:read`
`upload_media`	`surveys:write`
Grounding knowledge
`get_knowledge`	`templates:read`
`set_knowledge`	`templates:write`
`delete_knowledge`	`templates:write`
`enable_knowledge`	`templates:write`
`disable_knowledge`	`templates:write`
Audiences
`search_audiences`	`audiences:read`
`get_audience`	`audiences:read`
`list_audience_contacts`	`audiences:read`
`create_audience`	`audiences:write`
`import_contacts`	`audiences:write`
`delete_audience`	`audiences:write`
Contacts
`list_contacts`	`contacts:read`
`get_contact`	`contacts:read`
`update_contact`	`contacts:write`
Inbox
`list_conversations`	`conversations:read`
`get_conversation`	`conversations:read`
`reply`	`conversations:write`
`assign_conversation`	`conversations:write`
Webhooks
`list_webhooks`	`webhooks:manage`
`create_webhook`	`webhooks:manage`
`update_webhook`	`webhooks:manage`
`delete_webhook`	`webhooks:manage`
`test_webhook`	`webhooks:manage`
Account
`get_usage`	`usage:read`

See the API reference for each tool’s inputs and outputs.