# EDK-1: Compass for Machines

EDK-1: Compass for Machines is an MCP server for Claude Code that finds objects and events in the physical world, checks coordinates, plans routes, and watches for new sightings.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: edkearth
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/edkearth/mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/edk-1-compass-for-machines

## What it does

EDK-1 searches for objects, events, and natural features, or finds areas by measures such as flood risk, income, and tree cover. `edk_inspect` reads information about a coordinate; `edk_route` plans around named hazards. Monitoring delivers new sightings by webhook. Results include a location and photo.

The server requires Node 18 or later, an EDK account, and an `EDK_API_KEY`. Accounts receive 500 Compute Units per month. Discover costs 0.2 CU per result, and each monitor event costs 0.2 CU; higher reasoning levels use twice the compute.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `EDK_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -e EDK_API_KEY=<EDK_API_KEY> -- npx -y @edks/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add edk-1-compass-for-machines --env EDK_API_KEY=<EDK_API_KEY> -- npx -y @edks/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "edk-1-compass-for-machines": {
            "command": "npx",
            "args": [
                "-y",
                "@edks/mcp"
            ],
            "env": {
                "EDK_API_KEY": "<EDK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "edk-1-compass-for-machines": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@edks/mcp"
            ],
            "env": {
                "EDK_API_KEY": "<EDK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e EDK_API_KEY=<EDK_API_KEY> edk-1-compass-for-machines npx -y @edks/mcp
```
Replace <…> with your own values

## When to use it
- locate potholes or damaged roofs in a chosen area
- find places by flood risk or tree cover
- plan a route around construction or crash-prone intersections
- receive new sightings for a monitored place by webhook

## Example prompts
- Find potholes in Sacramento inside flood zones.
- Inspect the area at coordinates 40.7128, -74.0060.
- Route around streets with active construction.

## Similar
- [azure-sql-virtual-machines](https://affpapa.org/en/nevibecode/skills/azure-sql-virtual-machines.md) — skill · 185 installs
- [architecture-compass](https://affpapa.org/en/nevibecode/skills/architecture-compass.md) — skill · 2700 installs
- [Nautilus Compass Memory](https://affpapa.org/en/nevibecode/mcp/nautilus-compass-memory.md) — MCP server · ★ 1260 repo stars
- [Stats Compass](https://affpapa.org/en/nevibecode/mcp/stats-compass.md) — MCP server · ★ 16 repo stars
- [Federal Compass MCP](https://affpapa.org/en/nevibecode/mcp/federal-compass-mcp.md) — MCP server · ★ 12 repo stars
- [contract-compass](https://affpapa.org/en/nevibecode/mcp/contract-compass.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
