EDK-1: Compass for Machines
Find objects, conditions and routes on the ground with the EDK-1 spatial model
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.6.1
- Listing updated
- 3 days ago
About EDK-1: Compass for Machines
EDK-1: Compass for Machines is a freemium MCP server for maps and travel. It runs locally on your machine and is started by your AI client.
Five calls shape this server: Discover finds places from a question, Inspect describes one coordinate, Route plans around things you name, Monitor watches an area and Detect reads an image. The MCP package exposes six tools, edk_discover, edk_inspect, edk_route, edk_monitor_create, edk_monitor_events and edk_usage. Every result carries a location, a photo and an embed_url that opens it on the EDK Atlas.
Discover handles queries like graffiti near train stations, storm-damaged roofs or areas with low flood risk and high tree canopy. A reasoning setting from fast to max studies results more closely; medium and max cost twice the compute and need higher tiers.
It runs locally through npx @edks/mcp and needs an EDK_API_KEY. Usage is metered in Compute Units, with 500 free each month; monitoring is paid-tier only.
Install
Run in a terminal
claude mcp add mcp --env EDK_API_KEY='<EDK_API_KEY>' -- npx -y @edks/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@edks/mcp"
],
"env": {
"EDK_API_KEY": "<EDK_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@edks/mcp"
],
"env": {
"EDK_API_KEY": "<EDK_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@edks/mcp"
],
"env": {
"EDK_API_KEY": "<EDK_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@edks/mcp"
],
"env": {
"EDK_API_KEY": "<EDK_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@edks/mcp"
],
"env": {
"EDK_API_KEY": "<EDK_API_KEY>"
}
}
}
}Configuration
EDK_API_KEYSecret API key from https://edk.earth/console/keys (500 free CU every month).Required
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- edk_discover
- Finds objects, conditions, events or areas from a plain-language query
- edk_inspect
- Reads what is true at a coordinate
- edk_route
- Routes from A to B around named conditions
- edk_monitor_create
- Watches a place and reports new sightings by webhook
- edk_monitor_events
- Lists monitors and the events they found
- edk_usage
- Shows Compute Unit balance, tier and limits
What it does
- Discover places
- Finds objects, conditions, events or areas matching a plain-language query.
- Inspect a point
- Reads terrain, hazards, income, flood risk and canopy at a coordinate.
- Route around conditions
- Plans a path avoiding things such as potholed streets or construction.
- Monitor an area
- Creates monitors and lists the events they find, delivered by webhook.
- Reasoning levels
- Fast to max, with deeper review costing twice the compute.
- Atlas links
- Each result includes an embed_url to view it on the EDK Atlas.
Good for
- List solar farms or bridges near a city
- Check flood risk and tree canopy for an address
- Route across a city avoiding potholes
- Watch an area for new construction
- Count objects in an uploaded image
Pricing
Freemium
500 free Compute Units a month; paid credits for higher limits
Prices change. Check edk.earth before you buy.
EDK-1: Compass for Machines FAQ
How is it installed?
Run npx -y @edks/mcp with the EDK_API_KEY environment variable set; the README shows Claude Code, Cursor, VS Code, Codex and Docker setups.
What is a Compute Unit?
The GPU and CPU work a request needs; accounts get 500 free each month.
Is monitoring free?
No. The pricing page lists Monitor as paid plans only, at tier 4 and above, 0.2 CU per event.
How many Discover results can I get?
The free tier returns up to 3 per request; paid tiers allow up to 200.
Is EDK-1: Compass for Machines free?
EDK-1: Compass for Machines has a free plan, with paid plans for more usage or features.
How do I add EDK-1: Compass for Machines to Claude Code?
Run this command in your terminal: claude mcp add mcp --env EDK_API_KEY='<EDK_API_KEY>' -- npx -y @edks/mcp
What are the best alternatives to EDK-1: Compass for Machines?
The closest alternatives to EDK-1: Compass for Machines are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.
Alternatives to EDK-1: Compass for Machines

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

Tutu eSIM
MCP serverLive travel eSIM plans, prices and roaming costs for 190+ countries
- 5 tools
- Remote
- Paid
- Maps and travel