MCP Server

Give any AI assistant full access to the RelayAPI through the Model Context Protocol.

Connect any AI assistant to RelayAPI using the Model Context Protocol. Create posts, manage accounts, check analytics, and more — all through natural language.

What You Can Do

Ask your AI assistant things like:

• "Post 'Hello world!' to Twitter"
• "List my connected social accounts"
• "Cross-post this announcement to Twitter and LinkedIn"
• "Show my analytics for the past week"
• "Upload this image and post it to Instagram"
• "Schedule a LinkedIn post for tomorrow at 9am"

Quick Reference

How It Works

The MCP server exposes two tools that give the AI full access to the RelayAPI SDK:

Setup

{
  "mcpServers": {
    "relayapi_mcp_api": {
      "command": "npx",
      "args": ["-y", "relay-mcp"],
      "env": {
        "RELAY_API_KEY": "rlay_live_your_key_here"
      }
    }
  }
}

claude mcp add relay_mcp_api --env RELAY_API_KEY="rlay_live_your_key_here" -- npx -y relay-mcp

{
  "mcpServers": {
    "relayapi_mcp_api": {
      "command": "npx",
      "args": ["-y", "relay-mcp"],
      "env": {
        "RELAY_API_KEY": "rlay_live_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "relayapi_mcp_api": {
      "command": "npx",
      "args": ["-y", "relay-mcp"],
      "env": {
        "RELAY_API_KEY": "rlay_live_your_key_here"
      }
    }
  }
}

Tool Reference

search_docs

Search SDK documentation to find methods, parameters, and usage examples. Use this to discover the right approach before writing code.

execute

Execute TypeScript code against a pre-authenticated SDK client in a sandbox. Your code must define an async run function that receives the client:

async function run(client) {
  const result = await client.posts.list();
  console.log(result.data);
}

Example Conversations

Simple Post

You: Post "Just shipped our new API!" to Twitter

AI: I'll create that post for you.

The AI searches the docs for the posts.create method, then executes:

async function run(client) {
  const post = await client.posts.create({
    content: 'Just shipped our new API!',
    targets: ['acc_twitter_123'],
    schedule: 'now',
  });
  console.log(post);
}

AI: Done! Your post has been published to Twitter.

List Accounts

You: Show me my connected social accounts

The AI executes:

async function run(client) {
  const accounts = await client.accounts.list();
  console.log(accounts.data);
}

AI: You have 3 connected accounts:

• Twitter — @yourcompany
• LinkedIn — Your Company Page
• Instagram — @yourcompany

Cross-Post to Multiple Platforms

You: Post "Big announcement coming tomorrow!" to all my accounts

The AI lists accounts first, then creates a post targeting each one:

async function run(client) {
  const accounts = await client.accounts.list();
  const accountIds = accounts.data.map((a) => a.id);

  const post = await client.posts.create({
    content: 'Big announcement coming tomorrow!',
    targets: accountIds,
    schedule: 'now',
  });
  console.log(post);
}

AI: Published to Twitter, LinkedIn, and Instagram.

CLI Options

When running the MCP server directly, these flags are available:

Remote Deployment

Run the MCP server as an HTTP service for remote or shared access:

npx -y relay-mcp@latest --transport=http --port=3000

Clients authenticate via headers:

• Authorization: Bearer rlay_live_your_key_here
• x-relay-api-key: rlay_live_your_key_here

Configure a remote client:

{
  "mcpServers": {
    "relayapi_mcp_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer rlay_live_your_key_here"
      }
    }
  }
}

Troubleshooting

API key not found

Make sure the RELAY_API_KEY environment variable is set in your MCP client configuration. The key must start with rlay_live_ or rlay_test_.

Tool execution timeout

Individual API requests have a 30-second timeout. If a request times out, try a smaller query or add filters. Total code execution has a limit of approximately 5 minutes — simplify complex workflows or break them into smaller steps.

Command not found: npx

The MCP server requires Node.js 18 or later. Install it from nodejs.org and make sure npx is in your PATH.

Stale package version

If you're not seeing the latest features, clear the npx cache:

npx -y relay-mcp@latest

The @latest tag ensures you always get the most recent version.

Links

• GitHub
• SDKs
• API Reference
• Quickstart