eulerian-marketing-platform 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

eulerian_marketing_platform/__init__.py

@@ -4,7 +4,7 @@ This package provides a Model Context Protocol (MCP) server that enables
 AI assistants to interact with Eulerian Marketing Platform APIs.
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 __author__ = "Eulerian Technologies"
 __all__ = []
 

{eulerian_marketing_platform-0.2.0.dist-info → eulerian_marketing_platform-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: eulerian-marketing-platform
-Version: 0.2.0
+Version: 0.2.1
 Summary: MCP server for Eulerian Marketing Platform - enables AI assistants to interact with Eulerian's marketing analytics and campaign management APIs
 Author-email: Eulerian Technologies <mathieu@eulerian.com>
 License: MIT
@@ -36,7 +36,7 @@ Requires-Dist: ruff (>=0.1.0) ; extra == 'dev'
 
 # Eulerian Marketing Platform MCP Server
 
-A Model Context Protocol (MCP) **proxy server** that bridges AI assistants (Claude Desktop, Gemini CLI, Mistral AI) 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.
+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
 
@@ -61,12 +61,11 @@ The proxy:
 - **🔌 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, Gemini CLI, and Mistral AI
+- **🤖 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
-- **🔍 Easy Installation**: Deploy with a single command using `uvx`
 
 ## Prerequisites
 
@@ -76,63 +75,18 @@ The proxy:
 - One of the following AI clients:
   - Claude Desktop (Windows, macOS, Linux)
   - Gemini CLI
-  - Mistral AI Le Chat (requires remote deployment)
 
 ## Available Tools
 
-The proxy exposes the following tools to AI assistants:
-
-1. **`list_remote_tools()`** - Discover all tools available on the remote Eulerian server
-2. **`call_eulerian_tool(tool_name, arguments)`** - Call any remote tool with arguments
-3. **`get_eulerian_resources()`** - List available resources (data sources)
-4. **`read_eulerian_resource(uri)`** - Read a specific resource by URI
-5. **`get_server_info()`** - Get remote server version and capabilities
-
-For detailed information on how these tools work, see [FASTMCP_PROXY_GUIDE.md](FASTMCP_PROXY_GUIDE.md).
+All API Endpoints supported by the [Eulerian API](https://doc.api.eulerian.com) can be queried through the current MCP.
 
 ## Installation
 
-### Prerequisites Check
-
-Before installing, verify you have `uvx` installed. This is the recommended way to run the MCP server.
-
-**Check if uvx is installed:**
-```bash
-uvx --version
-```
-
-**If not installed, see [UVX_DEPLOYMENT_GUIDE.md](UVX_DEPLOYMENT_GUIDE.md) for detailed installation instructions.**
-
-**Quick install (Linux/macOS):**
-```bash
-# Run the included script
-chmod +x install-uvx.sh
-./install-uvx.sh
-
-# Or install manually
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-**Quick install (Windows PowerShell - Run as Administrator):**
-```powershell
-# Run the included script
-.\install-uvx.ps1
-
-# Or install manually
-powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-```
-
----
-
 ### Quick Start (Recommended)
 
-The easiest way to use this MCP server is with `uvx`, which automatically handles dependencies without requiring a separate installation:
-
-```bash
-# No installation needed! Just configure your AI client (see below)
-```
+The easiest way to use this MCP server is with `pip`.
 
-### Alternative: Install via pip
+### Install via pip
 
 If you prefer to install the package globally:
 
@@ -153,8 +107,8 @@ pip install -e .
 ### Required Environment Variables
 
 - `EMP_API_ENDPOINT`: Your remote Eulerian Marketing Platform MCP server URL (HTTP endpoint)
-  - Example: `https://your-eulerian-instance.com/api/mcp`
-- `EMP_API_TOKEN`: Your authentication token for the remote server
+  - 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
 
@@ -196,23 +150,6 @@ Claude Desktop supports local MCP servers via stdio transport.
 
 3. **Add the server configuration**:
 
-```json
-{
-  "mcpServers": {
-    "eulerian-marketing-platform": {
-      "command": "uvx",
-      "args": ["eulerian-marketing-platform"],
-      "env": {
-        "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
-        "EMP_API_TOKEN": "your_authentication_token_here"
-      }
-    }
-  }
-}
-```
-
-**Alternative: If using pip installation**:
-
 ```json
 {
   "mcpServers": {
@@ -243,7 +180,6 @@ Claude Desktop supports local MCP servers via stdio transport.
 
 **Linux**:
 - The config directory may not exist initially - create it with: `mkdir -p ~/.config/Claude`
-- Ensure `uvx` is installed: `pip install uv`
 
 **macOS**:
 - Access the config via Finder: `Cmd + Shift + G` → `~/Library/Application Support/Claude/`
@@ -284,8 +220,8 @@ nano ~/.gemini/settings.json
 {
   "mcpServers": {
     "eulerian-marketing-platform": {
-      "command": "uvx",
-      "args": ["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"
@@ -316,102 +252,6 @@ gemini
 
 ---
 
-### 3. Mistral AI (Le Chat)
-
-Mistral's Le Chat web interface supports MCP servers through **Custom Connectors**, but they must be deployed as **remote servers** with HTTP/SSE transport.
-
-#### Important Limitations
-
-- ❌ **Local stdio servers are NOT supported** by Mistral Le Chat
-- ✅ **Only remote HTTP/SSE servers** are supported
-- 📡 Your server must be publicly accessible via HTTPS
-
-#### Deployment Options
-
-You'll need to deploy your MCP server to a cloud platform. Popular options include:
-
-- **Render** (https://render.com)
-- **Railway** (https://railway.app)
-- **Fly.io** (https://fly.io)
-- **AWS Lambda** (with API Gateway)
-- **Google Cloud Run**
-- **Azure Container Instances**
-
-#### Server Modification for Remote Deployment
-
-Modify the `server.py` to support HTTP/SSE transport:
-
-```python
-# In your server.py main() function
-def main() -> None:
-    """Entry point for the MCP server."""
-    validate_config()
-    
-    # For remote deployment (Mistral AI)
-    import sys
-    if "--remote" in sys.argv:
-        mcp.run(transport="sse", port=8000)
-    else:
-        # Default stdio for local clients
-        mcp.run()
-```
-
-#### Example: Deploy to Render
-
-1. **Create a `render.yaml` file**:
-
-```yaml
-services:
-  - type: web
-    name: eulerian-mcp-server
-    env: python
-    buildCommand: pip install -e .
-    startCommand: python -m eulerian_marketing_platform.server --remote
-    envVars:
-      - key: EMP_API_ENDPOINT
-        sync: false
-      - key: EMP_API_TOKEN
-        sync: false
-```
-
-2. **Push to GitHub and connect to Render**
-
-3. **Set environment variables in Render dashboard**
-
-#### Setup in Mistral Le Chat
-
-1. **Open Le Chat** (https://chat.mistral.ai)
-
-2. **Navigate to Connectors**:
-   - Click the sidebar toggle
-   - Go to `Intelligence` → `Connectors`
-   - Click `+ Add Connector`
-   - Select `Add custom connector`
-
-3. **Configure the connector**:
-   - **Name**: Eulerian Marketing Platform
-   - **URL**: `https://your-deployed-server.render.com/mcp`
-   - **Description**: Access to Eulerian Marketing Platform analytics and campaigns
-   - **Authentication**: 
-     - Select `API Token Authentication` if your deployment requires it
-     - Or `No Authentication` if your server handles auth via environment variables
-
-4. **Connect and test**:
-   - Click `Connect`
-   - Once connected, enable it in a chat session
-   - Ask: "What Eulerian Marketing Platform capabilities do you have?"
-
-#### Security Recommendations for Remote Deployment
-
-- ✅ Always use HTTPS (not HTTP)
-- ✅ Implement rate limiting
-- ✅ Add request origin validation
-- ✅ Use environment variables for secrets (never hardcode)
-- ✅ Monitor server logs for unusual activity
-- ✅ Consider adding IP allowlisting if possible
-
----
-
 ## Usage Examples
 
 Once configured with any client, you can interact with your remote Eulerian Marketing Platform:
@@ -420,17 +260,14 @@ Once configured with any client, you can interact with your remote Eulerian Mark
 User: "What tools are available from Eulerian?"
 → Proxy calls list_remote_tools() and returns all available tools
 
-User: "Call the get_campaigns tool"
-→ Proxy forwards to remote server and returns campaign data
+User: "Call the update_goal tool"
+→ Proxy forwards to remote server and update goal settings
 
 User: "Show me campaign details for CAMP-12345"
 → Claude uses call_eulerian_tool() to fetch specific campaign
 
 User: "What resources are available?"
 → Proxy lists all available data sources
-
-User: "Read the configuration at eulerian://config/settings"
-→ Proxy fetches and returns the configuration
 ```
 
 The AI assistant will automatically use the appropriate proxy tools to fulfill your requests.
@@ -480,13 +317,6 @@ You'll see detailed logging of:
   - Verify the settings.json is valid JSON
   - Restart Gemini CLI
 
-#### Mistral connector fails to connect
-- **Solution**:
-  - Verify your server is publicly accessible via `curl https://your-server.com/mcp`
-  - Check server logs for errors
-  - Ensure you're using HTTPS (not HTTP)
-  - Verify the `/mcp` endpoint path is correct
-
 ### Debug Mode
 
 For detailed debugging:
@@ -555,9 +385,14 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Changelog
 
+### 0.2.0
+- Move to full Proxy mode
+- Remove instructions for uvx deployment
+- Remove instructions for Mistral integration (too complex)
+
 ### 0.1.0 (Initial Release)
 - Initial MCP server implementation
-- Support for Claude Desktop, Gemini CLI, and Mistral AI
+- Support for Claude Desktop, Gemini CLI
 - Cross-platform support (Windows, Linux, macOS)
 - Environment-based configuration
 

eulerian_marketing_platform-0.2.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+eulerian_marketing_platform/__init__.py,sha256=HibL07V6VMhqFcQSFGJm8ogUu9Qcfl2SSenCfdKtBFY,428
+eulerian_marketing_platform/server.py,sha256=y1vy-LvSjG18dvDv65hO875s_7vogbb5bdNwTetKKcU,8335
+eulerian_marketing_platform-0.2.1.dist-info/LICENSE,sha256=eIqBqE_fRsqQJ8F-2v0e-8WzZqdshsCqnzmqLAWrNHU,1078
+eulerian_marketing_platform-0.2.1.dist-info/METADATA,sha256=WDzHWUPBn0P6MC3PhFXOx70BRGa2xGHIdwoycImLCaA,12111
+eulerian_marketing_platform-0.2.1.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
+eulerian_marketing_platform-0.2.1.dist-info/entry_points.txt,sha256=rrPZptATSS9PUtH9gzCYq0WuP6eahkF-DkdUP1FaYfk,88
+eulerian_marketing_platform-0.2.1.dist-info/top_level.txt,sha256=nidh3T6fw-mLjUqZwQ8AiMScS4usuH0WXW4ZgG4HYCo,28
+eulerian_marketing_platform-0.2.1.dist-info/RECORD,,

eulerian_marketing_platform-0.2.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-eulerian_marketing_platform/__init__.py,sha256=8Od_2veelx75AfbIEFrCS1UF6AOsKaX6CF4zR_z8yYU,428
-eulerian_marketing_platform/server.py,sha256=y1vy-LvSjG18dvDv65hO875s_7vogbb5bdNwTetKKcU,8335
-eulerian_marketing_platform-0.2.0.dist-info/LICENSE,sha256=eIqBqE_fRsqQJ8F-2v0e-8WzZqdshsCqnzmqLAWrNHU,1078
-eulerian_marketing_platform-0.2.0.dist-info/METADATA,sha256=B0l6BxIaS-m55cFeicvSsHEhwVKZAmwy2OaFM9eWYpY,16928
-eulerian_marketing_platform-0.2.0.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
-eulerian_marketing_platform-0.2.0.dist-info/entry_points.txt,sha256=rrPZptATSS9PUtH9gzCYq0WuP6eahkF-DkdUP1FaYfk,88
-eulerian_marketing_platform-0.2.0.dist-info/top_level.txt,sha256=nidh3T6fw-mLjUqZwQ8AiMScS4usuH0WXW4ZgG4HYCo,28
-eulerian_marketing_platform-0.2.0.dist-info/RECORD,,