EDK-1 MCP server

EDK-1 is a foundation model of the physical world. Trained on 30 billion images, it sees the planet street by street, so your agent can find anything visible on Earth, read what's true there, route around it, and get alerted the moment it changes.

Use EDK when a task depends on what the real world looks like.

"Graffiti near train stations in Chicago"
"Storm-damaged roofs in New Orleans"
"Humpback whales in Monterey Bay"
"Get me across Pittsburgh avoiding potholed streets"

Every result comes back with its location, its photo and an embed_url that opens it on the EDK Atlas.

Tools

Tool	What it does
edk_discover	Ask for objects (graffiti, solar panels, bridges), conditions (storm-damaged roofs, boarded-up windows, potholes), events (crashes, new construction) or nature (humpback whales, alligators, wildflowers), and get each one back with its photo. Or find areas by what's measured there, like flood risk, income or tree canopy. Set reasoning from fast to max to have results studied more closely.
edk_inspect	Read what's true at any coordinate, from terrain and hazards to who lives there.
edk_route	Get from A to B around what you name, like potholed streets, construction or crash-prone intersections.
edk_monitor_create	Watch a place and get each new sighting by webhook.
edk_monitor_events	List monitors and the events they found.
edk_usage	Compute Unit balance, tier and limits.

Setup

1. Sign up at edk.earth. Every account gets 500 free Compute Units a month.
2. Create a secret key in Console → API Keys.
3. Add the server to your client with EDK_API_KEY set.

Claude Code

claude mcp add edk --env EDK_API_KEY=edk_sk_... -- npx -y @edks/mcp

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json), Windsurf and Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "edk": {
      "command": "npx",
      "args": ["-y", "@edks/mcp"],
      "env": { "EDK_API_KEY": "edk_sk_..." }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "inputs": [{ "type": "promptString", "id": "edk-key", "description": "EDK API key", "password": true }],
  "servers": {
    "edk": {
      "command": "npx",
      "args": ["-y", "@edks/mcp"],
      "env": { "EDK_API_KEY": "${input:edk-key}" }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.edk]
command = "npx"
args = ["-y", "@edks/mcp"]
env = { EDK_API_KEY = "edk_sk_..." }

Docker

docker build -t edk-mcp . && docker run -i --rm -e EDK_API_KEY=edk_sk_... edk-mcp

Pricing

Usage is metered in Compute Units (CU), the GPU and CPU work a request needs. Discover costs 0.2 CU per result, Monitor events 0.2 CU each. Higher reasoning levels use twice the compute. See edk.earth/pricing.

Links

• Docs: edk.earth/docs
• Agents guide: edk.earth/agents
• The data behind it: edk.earth/elements

The server has no dependencies and needs Node 18 or later. EDK_BASE_URL points it at another API host.

MIT licensed.