MCP server

Install Compass as a local MCP server for Claude Desktop, Cursor, and Codex.

Package

The launch package is @compass-food/mcp. It reads the Compass key from COMPASS_API_KEY and sends REST requests to https://api.compassfoodtechnologies.com.

Listed on Smithery: https://smithery.ai/servers/compassfoodtech/compass-mcp

npx -y @compass-food/mcp

Claude Desktop

Edit the Claude Desktop MCP config and add:

{
  "mcpServers": {
    "compass": {
      "command": "npx",
      "args": ["-y", "@compass-food/mcp"],
      "env": {
        "COMPASS_API_KEY": "cmp_test_your_key_here"
      }
    }
  }
}

Cursor

Add Compass to Cursor MCP settings, either globally or per workspace:

{
  "mcpServers": {
    "compass": {
      "command": "npx",
      "args": ["-y", "@compass-food/mcp"],
      "env": {
        "COMPASS_API_KEY": "cmp_test_your_key_here"
      }
    }
  }
}

Codex

Add Compass to ~/.codex/config.toml:

[mcp_servers.compass]
command = "npx"
args = ["-y", "@compass-food/mcp"]

[mcp_servers.compass.env]
COMPASS_API_KEY = "cmp_test_your_key_here"

Tool reference

Field	Type	Notes
compass_search	tool	Wraps POST /v1/search for natural-language restaurant discovery.
compass_enrich_restaurant	tool	Wraps POST /v1/enrich/restaurant for matching a known restaurant.
compass_decide_fit	tool	Wraps POST /v1/decision/restaurant-fit for fit, not_fit, or unknown decisions.