`@alexandrebouchez/batch-mcp`

Open-source MCP server for Batch.com — full coverage of the Customer Engagement Platform (CEP v2.x) and Mobile Engagement Platform (MEP v1.1) REST APIs, exposed to LLM agents over stdio and HTTP.

What it does

Lets any MCP-compatible agent (Claude Desktop, Claude Code, Cursor, Continue, the Anthropic API, ChatGPT, etc.) operate a Batch.com account: update profiles, manage audiences, send transactional pushes, orchestrate omnichannel campaigns, request data exports, and more — through a curated set of typed tools.

Every Batch endpoint that ships in their public docs is exposed as a tool. Destructive operations require an explicit confirm: true. Async 202 operations return the indexing token so the agent can poll completion explicitly.

Status

🚧 Pre-release. Setup phase — tools coming online progressively. Track progress in the plan or open issues.

Install (stdio)

npx -y @alexandrebouchez/batch-mcp

Configure your client (Claude Desktop example, ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "batch": {
      "command": "npx",
      "args": ["-y", "@alexandrebouchez/batch-mcp"],
      "env": {
        "BATCH_REST_KEY": "your_rest_key",
        "BATCH_PROJECT_KEY": "your_project_key",
        "BATCH_IOS_LIVE_KEY": "...",
        "BATCH_ANDROID_LIVE_KEY": "..."
      }
    }
  }
}

See .env.example for the full env var list.

Install (HTTP, self-hosted on Vercel)

Once deployed, point your MCP client at https://<your-deploy>.vercel.app/api/mcp.

Development

pnpm install
pnpm dev          # starts both packages in watch mode
pnpm test
pnpm typecheck
pnpm lint

Monorepo layout:

packages/server   — @alexandrebouchez/batch-mcp (npm)
apps/web          — Next.js landing + /api/mcp endpoint (Vercel)

License

AGPL-3.0-only. If you run a modified version of this server as a service, you must publish your source under AGPL-3.0. See LICENSE.

This is intentional: it lets the community fork and improve the server freely, while preventing closed-source SaaS providers (including Batch.com itself) from absorbing the code without contributing back.

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Batch SAS. "Batch" is a trademark of its respective owner. This is an independent open-source integration built against the public Batch.com REST API.

@alexandrebouchez/batch-mcp