MCP server

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

Package

The package is @compassfoodtech/mcp. It reads the Compass key from COMPASS_API_KEY and sends REST requests to https://api.compassfoodtechnologies.com. It replaces @compass-food/mcp, which no longer receives updates; change the package name in your MCP config.

Sandbox keys can call Search, Enrich, Decide, and Changes. Allowance and rate limits still apply. Get a key at signup. Compare tiers at /pricing.

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

npx -y @compassfoodtech/mcp

Claude Desktop

Edit the Claude Desktop MCP config and add:

{
  "mcpServers": {
    "compass": {
      "command": "npx",
      "args": ["-y", "@compassfoodtech/mcp"],
      "env": {
        "COMPASS_API_KEY": "<paste the key from signup>"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "compass": {
      "command": "npx",
      "args": ["-y", "@compassfoodtech/mcp"],
      "env": {
        "COMPASS_API_KEY": "<paste the key from signup>"
      }
    }
  }
}

Codex

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

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

[mcp_servers.compass.env]
COMPASS_API_KEY = "<paste the key from signup>"

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.