Skip to content
MCP server

EDK-1: Compass for Machines

Find objects, conditions and routes on the ground with the EDK-1 spatial model

Runs locallyStatus and history
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/mcp

Add 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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel