Zernio

zernio-mcp

A Model Context Protocol (MCP) server that gives Claude full access to the Zernio social media management API — 273 tools covering posts, analytics, inbox, ads, contacts, WhatsApp Business, and more across 14+ platforms.

Quick Start

Option 1: npx (recommended)

No installation needed. Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "zernio": {
      "command": "npx",
      "args": ["zernio-mcp"],
      "env": {
        "ZERNIO_API_KEY": "your_zernio_api_key_here"
      }
    }
  }
}

Also available as @eyalm321/zernio-mcp on GitHub Packages.

Option 2: Local install

git clone https://github.com/Eyalm321/zernio-mcp.git
cd zernio-mcp
npm install
npm run build

Then configure Claude Desktop:

{
  "mcpServers": {
    "zernio": {
      "command": "node",
      "args": ["/absolute/path/to/zernio-mcp/dist/index.js"],
      "env": {
        "ZERNIO_API_KEY": "your_zernio_api_key_here"
      }
    }
  }
}

Getting your API key

1. Log in to zernio.com
2. Go to Settings > API Keys
3. Create a new key and copy it

Tools (273 total)

Accounts (42 tools)

Posts & Media (25 tools)

Analytics (16 tools)

Ads (19 tools)

Messages / DMs (10 tools)

Comments (8 tools)

Reviews (3 tools)

Contacts & CRM (11 tools)

Broadcasts (7 tools)

Automations (6 tools)

Sequences / Drip Campaigns (8 tools)

Contact Enrollment (2 tools)

Tags (3 tools)

Twitter/X Actions (8 tools)

Reddit (4 tools)

Queue Scheduling (6 tools)

Validation (4 tools)

Connect / OAuth (17 tools)

Webhooks (5 tools)

WhatsApp Business (44 tools)

Profiles & Workspace (20 tools)

Logs (2 tools)

Supported Platforms

Example Prompts

Once configured, you can ask Claude things like:

• "What comments came in today across all my social accounts?"
• "Reply to all unanswered DMs with a friendly acknowledgment"
• "Show me the engagement stats for my last 5 Instagram posts"
• "What's the best time to post on Instagram based on my audience?"
• "Summarize all new reviews and draft replies for the 1-star ones"
• "Create a post saying 'Hello World!' scheduled for tomorrow at 9am on Twitter and LinkedIn"
• "Boost my best-performing post from this week with a $50 budget"
• "Show me my follower growth over the past 30 days"
• "Send a WhatsApp template message to all my VIP contacts"
• "Set up an automation to auto-reply when someone comments 'price' on my posts"
• "What's my Google Business Profile performance this month?"
• "Create a drip campaign sequence with 3 follow-up messages"

Development

npm install
npm run build       # compile TypeScript
npm start           # run the server
npm test            # run all tests (667 tests)
npm run test:watch  # run tests in watch mode

Project Structure

src/
  index.ts                  # MCP server entry point
  client.ts                 # API request utility
  tools/
    accounts.ts             # 42 tools - account management, GMB, platform settings
    ads.ts                  # 19 tools - campaigns, ads, audiences, targeting
    analytics.ts            # 16 tools - metrics, demographics, insights
    automations.ts          #  6 tools - comment-to-DM automations
    broadcasts.ts           #  7 tools - mass messaging
    comments.ts             #  8 tools - comment management
    connect.ts              # 17 tools - OAuth and platform connections
    contacts.ts             # 11 tools - CRM contacts and custom fields
    messages.ts             # 10 tools - DM conversations
    posts.ts                # 25 tools - post CRUD, media, approval workflows
    profiles.ts             # 20 tools - workspace, users, API keys
    queue.ts                #  6 tools - scheduling queue slots
    reddit.ts               #  2 tools - Reddit search and feed
    reviews.ts              #  3 tools - review management
    social.ts               # 33 tools - Twitter, sequences, webhooks, tags
    validation.ts           #  4 tools - content and media validation
    whatsapp-business.ts    # 44 tools - WhatsApp Business full suite
  __tests__/                # 667 tests across 19 test files

Built With

• @modelcontextprotocol/sdk - MCP server framework
• Zod - Schema validation
• Vitest - Testing framework
• TypeScript / Node.js

CI/CD

• CI: Runs on every push and PR to main — builds and tests on Node 20 and 22
• Publish: Automatically publishes to both npm and GitHub Packages when a GitHub release is created (requires NPM_TOKEN secret for npm; GitHub Packages uses GITHUB_TOKEN automatically)

License

MIT