Blueshift MCP Server

Read-only MCP (Model Context Protocol) server for the Blueshift marketing automation API.

Installation

npm install -g yespark-blueshift-mcp-server

Or use directly with npx:

npx yespark-blueshift-mcp-server

Configuration

Set these environment variables:

| Variable | Required | Description | |----------|----------|-------------| | BLUESHIFT_API_KEY | Yes | Your Blueshift User API Key | | BLUESHIFT_API_URL | No | API endpoint (default: https://api.eu.getblueshift.com) |

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "blueshift": {
      "command": "npx",
      "args": ["-y", "yespark-blueshift-mcp-server"],
      "env": {
        "BLUESHIFT_API_KEY": "your-api-key-here"
      }
    }
  }
}

For US region, add the API URL:

{
  "mcpServers": {
    "blueshift": {
      "command": "npx",
      "args": ["-y", "yespark-blueshift-mcp-server"],
      "env": {
        "BLUESHIFT_API_KEY": "your-api-key-here",
        "BLUESHIFT_API_URL": "https://api.getblueshift.com"
      }
    }
  }
}

Available Tools (22 tools)

Customers

• customers_search - Search customer by email
• customers_get - Get customer by UUID

Events

• events_debug - Get most recent event
• events_history - Get customer event history

Campaigns

• campaigns_list - List all campaigns
• campaigns_get - Get campaign details with stats
• campaigns_pause - Pause a running campaign
• campaigns_launch - Launch a paused campaign

Segments

• segments_list - List all segments
• segments_get_counts - Get segment membership counts

Templates

• email_templates_list - List email templates
• email_templates_get - Get email template details
• push_templates_list - List push templates
• sms_templates_list - List SMS templates

Catalogs

• catalogs_list - List product catalogs
• catalogs_get - Get catalog details

User Lists

• user_lists_get - Get custom user list details

Subscription Groups

• subscription_groups_list - List subscription groups
• subscription_groups_get - Get group details

Email Validation

• email_validate - Validate single email
• email_bulk_validate - Validate multiple emails

Utilities

• adapters_list - List integrations
• tags_list - List tags and folders

Resources

The server also exposes these MCP resources:

• blueshift://campaigns - All campaigns
• blueshift://segments - All segments
• blueshift://email-templates - All email templates
• blueshift://subscription-groups - All subscription groups

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Test with MCP Inspector
npm run inspector

API Documentation

See the Blueshift API Reference for full documentation.

License

MIT