@xreplyai/mcp

MCP server for XreplyAI — plan, generate, and schedule tweets in your voice. Browse viral content for inspiration, manage your post queue, and publish to X/Twitter from any AI agent.

Features

13 tools covering the full posts workflow:

• Discovery — Browse the viral tweet library filtered by niche
• Generation — Generate single posts or batches in your voice
• Post management — Create, edit, delete posts
• Publishing — Publish immediately or schedule to X/Twitter
• Context — Check billing, voice profile, preferences, and custom rules

Requirements

• Node.js 20+
• An XreplyAI account (get your JWT token from Settings)

Token expiry: Tokens expire after 30 days. If the MCP stops authenticating, return to the XreplyAI Settings page, copy a fresh token, and update your MCP config.

Setup

Get your token

Sign in to XreplyAI, go to Settings, and copy your API token.

Claude Desktop

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "xreply": {
      "command": "npx",
      "args": ["@xreplyai/[email protected]"],
      "env": {
        "XREPLY_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Claude Code

Run this command:

claude mcp add xreply -e XREPLY_TOKEN=your-jwt-token-here -- npx @xreplyai/[email protected]

Then run claude mcp list to confirm it's registered.

Or add manually to ~/.claude/mcp.json:

{
  "mcpServers": {
    "xreply": {
      "command": "npx",
      "args": ["@xreplyai/[email protected]"],
      "env": {
        "XREPLY_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Cursor

Click to install (you'll be prompted to update your token after):

Install in Cursor

Or add manually to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "xreply": {
      "command": "npx",
      "args": ["@xreplyai/[email protected]"],
      "env": {
        "XREPLY_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Windsurf

Open Windsurf and go to Plugins → Manage plugins → View raw config, then add the server config below. Or edit ~/.codeium/windsurf/mcp_config.json directly:

{
  "mcpServers": {
    "xreply": {
      "command": "npx",
      "args": ["@xreplyai/[email protected]"],
      "env": {
        "XREPLY_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

OpenClaw

OpenClaw is a self-hosted AI gateway that connects chat apps (WhatsApp, Telegram, Discord) to AI agents via Skills.

Install via ClawHub (once published):

clawhub install xreply

Manual install:

cp -r mcp/openclaw/ ~/.openclaw/skills/xreply/

Configure your token in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "xreply": {
        "env": {
          "XREPLY_TOKEN": "your-jwt-token-here"
        }
      }
    }
  }
}

The skill uses mcporter to bridge OpenClaw to the XReply MCP server. Install it with:

npm install -g mcporter

Verify the skill loads:

openclaw skills list --eligible

Tools

Discovery

| Tool | Description | |------|-------------| | xreply_viral_library | Browse viral tweets (100+ likes) filtered by niche and sort |

Generation

| Tool | Description | |------|-------------| | xreply_posts_generate | Generate a single post in your voice | | xreply_posts_generate_batch | Generate 1-9 posts at once by category |

Post Management

| Tool | Description | |------|-------------| | xreply_posts_list | List all posts in your queue | | xreply_posts_create | Save a post draft | | xreply_posts_edit | Edit body or scheduled time | | xreply_posts_delete | Delete a post |

Publishing

| Tool | Description | |------|-------------| | xreply_posts_publish | Publish now or schedule to X/Twitter |

Context

| Tool | Description | |------|-------------| | xreply_billing_status | Check subscription tier and quota | | xreply_voice_status | Check voice profile analysis status | | xreply_preferences_get | Get generation preferences | | xreply_preferences_set | Update tone, emoji, structure preferences | | xreply_rules_list | List custom writing rules |

Example workflows

Plan posts for the week

1. xreply_viral_library (niche: "saas") — find inspiration
2. xreply_posts_generate_batch (category: "personalized", count: 7) — generate 7 posts
3. xreply_posts_create — save the ones you like
4. xreply_posts_edit (id: X, scheduled_at: "2026-03-10T09:00:00Z") — schedule each

Quick post

1. xreply_posts_generate (topic: "my SaaS hit 1000 users", angle: "story_arc")
2. xreply_posts_create (body: "<generated text>")
3. xreply_posts_publish (id: X) — post immediately

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | XREPLY_TOKEN | Yes | — | Your XreplyAI JWT token |

Development

npm install
npm run build
npm test
XREPLY_TOKEN=your-token npx tsx src/index.ts