Eulerian Marketing Platform MCP

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

Two installation methods are available. The DXT extension is the easiest — no terminal required.

Option A: One-click DXT Extension (Recommended)

Desktop Extensions (DXT) let you install MCP servers in Claude Desktop with a single double-click, without editing JSON config files.

Requirements: Python 3.10+ with the package installed:

pip install eulerian-marketing-platform

Install steps:

1. Download the latest .dxt file from the releases page
2. Double-click the .dxt file — Claude Desktop opens an installation dialog
3. Enter your API Endpoint and API Token when prompted
4. Click Install — the server is ready immediately

That's it. No pip install, no config file editing, no restart required.

To update: download the new .dxt and double-click it again.

Option B: Manual JSON configuration

Claude Desktop supports local MCP servers via stdio transport.

Configuration File Locations

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

Setup Steps

1. Open Claude Desktop
2. Access configuration:

• Click Claude menu → Settings → Developer → Edit Config
• Or manually edit the JSON file at the location above

1. Add the server configuration:

{

"mcpServers": { "eulerian-marketing-platform": { "command": "python", "args": ["-m", "eulerian_marketing_platform.server"], "env": { "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp", "EMP_API_TOKEN": "your_authentication_token_here" } } } }

1. Restart Claude Desktop

1. Verify the connection:

• Look for a hammer/tools icon (🔨) in the bottom-right corner
• Click it to see available Eulerian tools
• Ask Claude: "What Eulerian Marketing Platform tools do you have access to?"

Platform-Specific Notes

Windows:

• Use the Run dialog (Win + R) and enter %APPDATA%\Claude to quickly navigate to the config directory
• If using a local installation, ensure Python is in your PATH

Linux:

• The config directory may not exist initially - create it with: mkdir -p ~/.config/Claude

macOS:

• Access the config via Finder: Cmd + Shift + G → ~/Library/Application Support/Claude/

---

2. Gemini CLI

Gemini CLI supports MCP servers through its configuration file.

Prerequisites

Install Gemini CLI if you haven't already:

npm install -g @google/gemini-cli

Configuration File Location

~/.gemini/settings.json

Setup Steps

1. Create or edit the settings file:

# Create the directory if it doesn't exist

mkdir -p ~/.gemini

Edit the settings file

nano ~/.gemini/settings.json

1. Add the MCP server configuration:

{

"mcpServers": { "eulerian-marketing-platform": { "command": "python", "args": ["-m", "eulerian_marketing_platform.server"], "env": { "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp", "EMP_API_TOKEN": "your_authentication_token_here" } } } }

1. Start Gemini CLI:

gemini

1. Verify the connection:

• Use the /mcp command to see connected servers
• Ask Gemini: "What tools are available from the Eulerian Marketing Platform?"

Platform-Specific Notes

Windows:

• Settings file location: %USERPROFILE%\.gemini\settings.json
• Create directory: mkdir %USERPROFILE%\.gemini

Linux/macOS:

• Standard location: ~/.gemini/settings.json

---

3. Codex CLI

Codex CLI supports MCP servers configured in ~/.codex/config.toml. The configuration is shared between the CLI and the Codex IDE extension (VS Code).

Prerequisites

• Node.js 18+ and npm
• Codex CLI installed: npm install -g @openai/codex
• Python 3.10+ with this package installed (pip install eulerian-marketing-platform)
• A ChatGPT Plus, Pro, Team, Edu, or Enterprise subscription (or an OpenAI API key)

Option A: Using the codex mcp add command (easiest)

Run the following command to register the Eulerian MCP server:

codex mcp add eulerian-marketing-platform \

--env EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp \ --env EMP_API_TOKEN=your_authentication_token_here \ -- python -m eulerian_marketing_platform.server

That's it — Codex will update ~/.codex/config.toml for you.

Option B: Edit config.toml manually

Open (or create) ~/.codex/config.toml and add the following:

[mcp_servers.eulerian-marketing-platform]

command = "python" args = ["-m", "eulerian_marketing_platform.server"] tool_timeout_sec = 300

[mcp_servers.eulerian-marketing-platform.env] EMP_API_ENDPOINT = "https://your-eulerian-instance.com/mcp" EMP_API_TOKEN = "your_authentication_token_here"

Note: The section name must use mcp_servers (with an underscore). Using mcp-servers or any other variant will silently fail.

Option C: Project-scoped configuration

To limit the MCP server to a specific project, create a .codex/config.toml file at the root of that project with the same content as above. The project must be marked as trusted by Codex.

Verify the connection

1. Launch Codex in your terminal:

   codex

1. Type /mcp in the interactive TUI to see all connected MCP servers.
2. Confirm that eulerian-marketing-platform appears in the list with its available tools.
3. Try asking:

   What Eulerian Marketing Platform tools do you have access to?

Managing the server

# List all configured MCP servers

codex mcp

Remove the server

codex mcp remove eulerian-marketing-platform

Troubleshooting (Codex CLI)

• Server not appearing in `/mcp`: Verify that the [mcp_servers.eulerian-marketing-platform] section is present in ~/.codex/config.toml and that the TOML syntax is valid.
• Timeout errors: Increase tool_timeout_sec in config.toml (default is 60 seconds). Eulerian queries can take longer, so 300 is recommended.
• Authentication errors: Double-check that EMP_API_ENDPOINT and EMP_API_TOKEN are correct.
• Python not found: Ensure the python command resolves to Python 3.10+. You may need to use python3 instead:

  command = "python3"

• Package not found: Make sure eulerian-marketing-platform is installed in the Python environment that Codex will invoke. Run python -m eulerian_marketing_platform.server manually to confirm it works.
• Check logs: Monitor the proxy logs for detailed error information:

  tail -f /tmp/eulerian-mcp-proxy.log

---

4. Claude Code

Claude Code is Anthropic's terminal-based coding agent. It supports MCP servers configured via the claude mcp CLI command or by editing ~/.claude.json.

Prerequisites

• Node.js 18+ and npm
• Claude Code installed: npm install -g @anthropic-ai/claude-code
• Python 3.10+ with this package installed (pip install eulerian-marketing-platform)
• An Anthropic API key or Claude subscription

Option A: Using the claude mcp add command (easiest)

claude mcp add eulerian-marketing-platform \

-e EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp \ -e EMP_API_TOKEN=your_authentication_token_here \ -- python -m eulerian_marketing_platform.server

By default this adds the server with local scope (current project only). To make it available in all projects, add the -s user flag:

claude mcp add -s user eulerian-marketing-platform \

-e EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp \ -e EMP_API_TOKEN=your_authentication_token_here \ -- python -m eulerian_marketing_platform.server

Option B: Edit ~/.claude.json manually

Open ~/.claude.json and add the server under the mcpServers key:

{

"mcpServers": { "eulerian-marketing-platform": { "type": "stdio", "command": "python", "args": ["-m", "eul