Eulerian Marketing Platform MCP Server

A Model Context Protocol (MCP) proxy server that bridges AI assistants (Claude Desktop, Gemini CLI, etc ...) to a remote Eulerian Marketing Platform MCP server. This proxy handles authentication, request forwarding, and provides a local MCP interface to your remote Eulerian instance.

How It Works

This server acts as a transparent proxy between local MCP clients and your remote Eulerian Marketing Platform server:

┌─────────────┐        ┌──────────────────┐        ┌────────────────┐
│   Claude    │ ◄─────►│  This MCP Proxy  │◄─────► │ Remote Eulerian│
│   Desktop   │  stdio │  (Local)         │  HTTP  │  MCP Server    │
└─────────────┘        └──────────────────┘        └────────────────┘

The proxy:

• 🔐 Handles authentication with your remote Eulerian server
• 📡 Forwards MCP requests via HTTP with Bearer token
• 🛠️ Exposes remote tools and resources to AI assistants
• 📝 Provides comprehensive logging for debugging
• ⚡ Uses async HTTP for better performance

Warning

Given the rapid pace of evolution of protocols, implementations and new features coming out, the MCP may or may not be compatible with your suite of tools. Please fill in an issue so that we can check it.

Features

• 🔌 Proxy Architecture: Bridges local MCP clients to remote Eulerian MCP server via HTTP
• 🔐 Secure Authentication: Uses Bearer token authentication for remote server access
• 🌐 Cross-platform support: Works on Windows, Linux, and macOS
• 🤖 Multiple AI clients: Compatible with Claude Desktop and Gemini CLI
• 📝 Comprehensive Logging: Logs all requests/responses for debugging
• ⚡ Async HTTP: Non-blocking requests using httpx for better performance
• 🛠️ Tool Discovery: Automatically discovers and exposes remote tools
• ⏱️ Configurable Timeouts: Adjustable request timeouts

Prerequisites

• Python 3.10 or higher - Install Python
• Access to a remote Eulerian Marketing Platform MCP server (HTTP endpoint)
• Valid authentication token for the remote server
• One of the following AI clients:
  • Claude Desktop (Windows, macOS, Linux)
  • Gemini CLI
  • Codex CLI (macOS, Linux)
  • Claude Code (macOS, Linux)
  • Cursor (Windows, macOS, Linux)
  • VS Code with GitHub Copilot (Windows, macOS, Linux)

Available Tools

All API Endpoints supported by the Eulerian API can be queried through the current MCP.

Installation

Quick Start (Recommended)

The easiest way to use this MCP server is with pip.

Make sure pip is installed : python -m pip install --upgrade pip

Install via pip

If you prefer to install the package globally:

pip install eulerian-marketing-platform

Alternative: Install from source

git clone https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp.git
cd eulerian-marketing-platform-mcp
pip install -e .

Configuration

Required Environment Variables

• EMP_API_ENDPOINT: Your remote Eulerian Marketing Platform MCP server URL (HTTP endpoint)
  • Example: https://dem.api.eulerian.com/mcp
• EMP_API_TOKEN: Your authentication token for the remote server, it is the one linked to your Eulerian account.

Optional Environment Variables

• EMP_LOG_FILE: Log file location (default: /tmp/eulerian-mcp-proxy.log)
• EMP_TIMEOUT: Request timeout in seconds (default: 300)

Example .env file

Create a .env.example file in your project:

# Required
EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp
EMP_API_TOKEN=your_authentication_token_here

# Optional
EMP_LOG_FILE=/var/log/eulerian-mcp-proxy.log
EMP_TIMEOUT=600

Setup Instructions by Client

1. Claude Desktop

Claude Desktop supports local MCP servers via stdio transport.

Configuration File Locations

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: `~/Library/Application Suppo

... View full README on GitHub