Eulerian MCP Integration Guide for Visual Studio Code and GitHub Copilot
EULERIAN MCP
- Setup guide — beginner friendly
- Connect Eulerian to VS Code + GitHub Copilot
- A step-by-step, no-jargon walkthrough — starting from a computer with nothing installed
This guide shows you, click by click, how to connect the Eulerian Marketing Platform MCP to GitHub Copilot inside VS Code. VS Code is a free application from Microsoft; Copilot is its AI assistant. We start from zero — installing VS Code, creating a free account — and finish with Copilot answering questions about your real Eulerian data.
What you will need:
A computer you can install software on
Your Eulerian endpoint URL and API token (from your Eulerian contact)
An email address to create a free GitHub account.
No prior experience required.
Step 1 Install VS Code
Go to https://code.visualstudio.com , click the big download button for your system, run the installer and accept the defaults. Open VS Code when it finishes — you'll see a welcome screen like this:
The VS Code welcome screen, inviting you to sign in and start.
Step 2 Add GitHub Copilot and create a free account
Click the Extensions icon on the left bar (four little squares), search GitHub Copilot, and click Install. Copilot then asks you to sign in. If you don't have a GitHub account, choose Sign up — on the sign-up page, keep the “Sign up for Copilot Free” box ticked so you get Copilot at no cost:
Creating a free GitHub account with “Copilot Free” enabled.
Step 3 You're in
Once signed in, VS Code opens with the Copilot Chat panel on the right. This is where you'll talk to the assistant.
VS Code signed in, with the Copilot Chat panel open on the right.
Step 4 Install Python and the Eulerian bridge
Copilot reaches Eulerian through a tiny “bridge” that runs on your machine. Install Python 3.10+ from https://www.python.org/downloads/ (tick “Add Python to PATH” on Windows), then open a terminal (Windows: Start → type cmd → Enter) and run:
pip install eulerian-marketing-platform
Step 5 Tell VS Code about Eulerian
Open the command palette with Ctrl+Shift+P (macOS: Cmd+Shift+P), type MCP: Open User Configuration and press Enter. An mcp.json file opens. Paste this, then replace the endpoint and token with your own:
{"servers": {"eulerian-marketing-platform": {"type": "stdio","command": "C:/Users/you/AppData/Local/Programs/Python/Python312/python.exe","args": ["-m", "eulerian_marketing_platform.server"],"env": {"EMP_API_ENDPOINT": " https://your-eulerian-instance.com/mcp ","EMP_API_TOKEN": "paste-your-eulerian-token-here"}}}}
The one thing that catches everyone: VS Code uses the key "servers" — not "mcpServers" like most other apps. For the command path on Windows you can use forward slashes / (as above) or escaped backslashes \\; both work. Find your Python with python -c "import sys; print(sys.executable)".
A small Start button appears just above the "eulerian-marketing-platform" line — click it. After a few seconds VS Code shows the server as running with its tools:
mcp.json with the server “Running · 134 tools” (the token is hidden here for privacy).
Step 6 Switch Copilot to Agent mode
MCP tools only work in Agent mode. At the bottom of the Copilot Chat box, open the mode dropdown and pick Agent. You can review which tools are on via the tools (
) button — the Eulerian tools appear in the list:
) button — the Eulerian tools appear in the list:
The tools picker in Agent mode, showing the Eulerian MCP tools available to Copilot.
Handy: to make Copilot use a specific Eulerian tool, type # followed by the tool name in your message (for example #getallowedwebsite_account).
Step 7 Try it — ask for your data
In the chat (Agent mode), ask a plain-language question, for example a weekly visits trend. Copilot calls the Eulerian tools and returns real figures:
Copilot returning a day-by-day visits trend from Eulerian (client name redacted).
That's the full setup. You can now ask business questions in natural language and Copilot will pull the answers from Eulerian.
Good to know (and what we verified)
If a report first comes back “invalid”: on a first reporting attempt Copilot may show reports definition is invalid — this happens when the question is missing a time dimension. The agent normally fixes it by itself (it adds a daily date_day dimension and retries), then returns the data. It is not a connection or protocol problem.
Validation note (for the record): VS Code + GitHub Copilot was tested end to end and worked out of the box — connection, 134 tools discovered, and reporting all succeeded.
If something doesn't work
No MCP: Open User Configuration command
Update VS Code (needs 1.101+) and make sure the GitHub Copilot extension is installed.
Server won't start / shows 0 tools
Check the key is "servers" and the command points to your real Python path (Step 5).
Copilot ignores the Eulerian tools
You're not in Agent mode. Switch mode at the bottom of the chat box, or force a tool with #tool_name.
A report comes back “invalid”
Usually self-corrected (see above). If not, ask for a “daily” breakdown to add a time dimension.