# EDK-1: Compass for Machines

> EDK-1: Compass for Machines is a freemium MCP server for maps and travel. Find objects, conditions and routes on the ground with the EDK-1 spatial model. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://edk.earth/agents
- **Repository:** https://github.com/edkearth/mcp
- **MCP Registry name:** earth.edk/mcp
- **Categories:** maps and travel, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env EDK_API_KEY='<EDK_API_KEY>' -- npx -y @edks/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edks/mcp"
      ],
      "env": {
        "EDK_API_KEY": "<EDK_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edks/mcp"
      ],
      "env": {
        "EDK_API_KEY": "<EDK_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@edks/mcp"
      ],
      "env": {
        "EDK_API_KEY": "<EDK_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edks/mcp"
      ],
      "env": {
        "EDK_API_KEY": "<EDK_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edks/mcp"
      ],
      "env": {
        "EDK_API_KEY": "<EDK_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/edk-1-compass-for-machines
