An MCP server that exposes the EVE Earth Observation chat API as a set of MCP tools.
EVE-MCP is part of an initiative by Trillium Technologies and ESA to realize the vision of Earth system predictability (ESP). You can read about the ESP vision here.
The server registers the following MCP tools:
query_eve— query the EVE RAG system and return the assembled answerlist_eve_collections— list publicly available document collectionscheck_eve_health— unauthenticated health check against the EVE APIextract_factuality_issues— analyze a Google Earth Engine Python script and surface scientific assumptions worth verifyingassess_factuality_issue— produce an expert-style assessment of an issue raised against a GEE script
The project uses Poetry and a Git
submodule for the upstream eve-api client.
git clone --recurse-submodules https://github.com/<org>/eve-mcp.git
cd eve-mcp
poetry installIf you cloned without --recurse-submodules:
git submodule update --init --recursiveSupported Python versions: 3.11–3.14.
The server authenticates to EVE on first tool invocation using the following environment variables:
| Variable | Required | Default | Purpose |
|---|---|---|---|
EVE_EMAIL |
yes | — | EVE account email |
EVE_PASSWORD |
yes | — | EVE account password |
EVE_BASE_URL |
no | https://api.eve-chat.chat |
EVE API base URL |
Over stdio (the standard MCP transport):
poetry run python -m eve_mcp.serverInstall the pre-commit hooks once:
poetry run pre-commit installRun the full hook suite (black, isort, mypy, pylint, pytest+coverage) against all files:
poetry run pre-commit run --all-filesSee CONTRIBUTING.md for development setup, pre-commit hooks, and PR conventions.
Originally created by the GeoSTARS (STARS: Scientific Testing of Agentic Reasoning) team: ( James Walsh, Russell Spiewak, Will Fawcett, and Raúl Ramos ). Supported by the ESA Phi-Lab as part of Trillium Technologies Earth Systems Lab ESL.
MIT — see LICENSE.
© 2026 Trillium Technologies Ltd.