{"_id":"@compass-food/mcp","_rev":"5-d9bc6e76b2dee67d15d185a61cdf339f","name":"@compass-food/mcp","dist-tags":{"latest":"0.3.1"},"versions":{"0.2.0":{"name":"@compass-food/mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","compass","dietary","vegan","restaurant","ai-agent","anthropic","claude"],"_id":"@compass-food/mcp@0.2.0","maintainers":[{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"}],"homepage":"https://compassfoodtechnologies.com","bugs":{"url":"https://github.com/compass-food/compass-mcp/issues"},"bin":{"compass-mcp":"dist/index.js"},"dist":{"shasum":"46aab21d929cb9dbc5339fd007b4230c1f16d3b2","tarball":"https://registry.npmjs.org/@compass-food/mcp/-/mcp-0.2.0.tgz","fileCount":30,"integrity":"sha512-YLR07aFrzXHXxrWV3TYBvwLndTBlkMFgae9LNqeyLbqvGdX6Q32N+Z1O55Rat1CZzCVCnIWD4WiOrApgl2ydwg==","signatures":[{"sig":"MEYCIQCGQ4+Zl8C2aEFfJWH3ty2Rc+tR6wHY1AwHCj6sNyB9ZQIhALZT610dBdCPm5RelyrWrCbiXhOaa4+/eNInPJAHy6+r","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74153},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"570056ac8ef0bef6185728e0ef55e09deb14c639","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"},"repository":{"url":"git+https://github.com/compass-food/compass-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Compass DaaS - explainable dietary decision layer for AI agents","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.9.0","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1777643919597_0.48487996491755125","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@compass-food/mcp","version":"0.2.1","keywords":["mcp","model-context-protocol","compass","dietary","vegan","restaurant","ai-agent","anthropic","claude"],"license":"MIT","_id":"@compass-food/mcp@0.2.1","maintainers":[{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"}],"homepage":"https://compassfoodtechnologies.com","bugs":{"url":"https://github.com/compass-food/compass-mcp/issues"},"bin":{"compass-mcp":"dist/index.js"},"dist":{"shasum":"bbc52252147879b9af4d01c6c3a9ca5baead6758","tarball":"https://registry.npmjs.org/@compass-food/mcp/-/mcp-0.2.1.tgz","fileCount":30,"integrity":"sha512-S5uu81pQJMwbbhDSobG5uleHmI6O8wHxNsS8Pu8gZnDjtbm5VCnIcXexX5HiuRtE00E4KcyUEaSjv93RqYAfsA==","signatures":[{"sig":"MEQCIFwB997SuRryEIM1H7N23EpazG0RMPv8ZspXz8o56P2/AiBeZVetkxcDBJp+g/WNpQdTb55sU0wIMNZ8W/yITMsljA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74327},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"402d471db10876074aa1c3aa292e03e3300a07c1","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"},"repository":{"url":"git+https://github.com/compass-food/compass-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Compass DaaS - explainable dietary decision layer for AI agents","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.9.0","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.1_1777796383525_0.4217124029435033","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@compass-food/mcp","version":"0.2.2","keywords":["mcp","model-context-protocol","compass","dietary","vegan","restaurant","ai-agent","anthropic","claude"],"license":"MIT","_id":"@compass-food/mcp@0.2.2","maintainers":[{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"}],"homepage":"https://compassfoodtechnologies.com","bugs":{"url":"https://github.com/compass-food/compass-mcp/issues"},"bin":{"compass-mcp":"dist/index.js"},"dist":{"shasum":"96a6c9537f1abaa042dd35a9ea465ae647b92a46","tarball":"https://registry.npmjs.org/@compass-food/mcp/-/mcp-0.2.2.tgz","fileCount":30,"integrity":"sha512-BfiE90p3+tlug3sQdgw5IXhr1r32f3gJ1xFcUFUqxpjt23R8B5WlsMfN5iI8JcVn4gbuoRBYF+L6sqQp3fkRDw==","signatures":[{"sig":"MEUCID1mf+VprMp4bmzDUavsQ2dSgIPbgCxuu7Zihg/x+mzcAiEA917iVHvr3+sIi7fawd69jRF3JYFHmjjnPml7jAzBiHo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":76435},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"9e1b63bae81f50c498f7a502e339b296a9256693","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"},"repository":{"url":"git+https://github.com/compass-food/compass-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Compass DaaS - explainable dietary decision layer for AI agents","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.9.0","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.2_1777807721770_0.7824295083637356","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@compass-food/mcp","version":"0.3.0","keywords":["mcp","model-context-protocol","compass","dietary","vegan","restaurant","ai-agent","anthropic","claude"],"license":"MIT","_id":"@compass-food/mcp@0.3.0","maintainers":[{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"}],"homepage":"https://compassfoodtechnologies.com","bugs":{"url":"https://github.com/compass-food/compass-mcp/issues"},"bin":{"compass-mcp":"dist/index.js"},"dist":{"shasum":"f9a5aa06d4c687914cc72afd856433401e9593e6","tarball":"https://registry.npmjs.org/@compass-food/mcp/-/mcp-0.3.0.tgz","fileCount":33,"integrity":"sha512-Y0p+PkqNI3BbFBrlWtoffLOzKNzfYL7LV7Ekhw/81AfA7HszlymCcAw/r0IeXXpocDHPLAfAssUFB/rombU3Wg==","signatures":[{"sig":"MEUCIQDAgl+8pzijIK5V+Oz7dap6D19uBvokcrRNEta/E8URPwIgDjIyZkxb/OKeN/6eCS4rGPrTgfXv4+c3zhdcSoJihWg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97652},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"d88ac8ecd5a8e7958aa8dcc43e56b723b0a17ee7","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"},"repository":{"url":"git+https://github.com/compass-food/compass-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Compass DaaS - explainable dietary intelligence for AI agents","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.9.0","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.0_1778039172281_0.7977478132028344","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@compass-food/mcp","version":"0.3.1","license":"MIT","description":"MCP server for Compass DaaS - explainable dietary intelligence for AI agents","type":"module","main":"dist/index.js","bin":{"compass-mcp":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/compass-food/compass-mcp.git"},"homepage":"https://compassfoodtechnologies.com","bugs":{"url":"https://github.com/compass-food/compass-mcp/issues"},"scripts":{"build":"tsc","start":"node dist/index.js","test":"vitest run"},"engines":{"node":">=18"},"keywords":["mcp","model-context-protocol","compass","dietary","vegan","restaurant","ai-agent","anthropic","claude"],"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^24.0.0","typescript":"^5.9.0","vitest":"^4.0.0"},"publishConfig":{"access":"public"},"gitHead":"582986439eabb0e1813bad61cc250d8e9353f1fb","types":"./dist/index.d.ts","_id":"@compass-food/mcp@0.3.1","_nodeVersion":"24.13.1","_npmVersion":"11.10.1","dist":{"integrity":"sha512-HhmT8ythHG1rkngU7IWdKCBUk4KlH7N/ylwK6gNabanNic347TRBJp5ym9dk2IhfvvNYHY3gU3KYP1t3EO6xvA==","shasum":"4897f935b699be257c217ce1f04d4ff487b598ed","tarball":"https://registry.npmjs.org/@compass-food/mcp/-/mcp-0.3.1.tgz","fileCount":33,"unpackedSize":220298,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAWXZJXQvfcwEe4DcUV1VYwvlWK3e72wSiTt9QI/phDvAiAmeEbM7pOEVL2c20bnY1UwLuiCSm75FK60r4FvT7zs5Q=="}]},"_npmUser":{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"},"directories":{},"maintainers":[{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.3.1_1778682026010_0.2888781232105522"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-01T13:58:39.487Z","modified":"2026-05-13T14:20:26.303Z","0.2.0":"2026-05-01T13:58:39.729Z","0.2.1":"2026-05-03T08:19:43.670Z","0.2.2":"2026-05-03T11:28:41.926Z","0.3.0":"2026-05-06T03:46:12.443Z","0.3.1":"2026-05-13T14:20:26.150Z"},"bugs":{"url":"https://github.com/compass-food/compass-mcp/issues"},"license":"MIT","homepage":"https://compassfoodtechnologies.com","keywords":["mcp","model-context-protocol","compass","dietary","vegan","restaurant","ai-agent","anthropic","claude"],"repository":{"type":"git","url":"git+https://github.com/compass-food/compass-mcp.git"},"description":"MCP server for Compass DaaS - explainable dietary intelligence for AI agents","maintainers":[{"name":"veganmapai","email":"b.kozarev@raicommerce.bg"}],"readme":"# Compass DaaS MCP\r\n\r\n[![Smithery badge](https://smithery.ai/badge/compassfoodtech/compass-mcp)](https://smithery.ai/servers/compassfoodtech/compass-mcp)\r\n\r\nMCP server for Compass DaaS. It exposes three restaurant dietary decision tools over the Model Context Protocol and calls the Compass REST API with your API key.\r\n\r\n## Quick Start\r\n\r\n```bash\r\nnpx -y @compass-food/mcp\r\n```\r\n\r\nSet `COMPASS_API_KEY` before starting the server:\r\n\r\n```bash\r\nexport COMPASS_API_KEY=cmp_test_your_sandbox_key\r\n```\r\n\r\nFor staging or local testing, set:\r\n\r\n```bash\r\nexport COMPASS_BASE_URL=https://daas-api-veganmapai-1a8b7.a.run.app\r\n```\r\n\r\n## Install\r\n\r\n### Claude Desktop\r\n\r\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"compass\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@compass-food/mcp\"],\r\n      \"env\": {\r\n        \"COMPASS_API_KEY\": \"cmp_test_your_sandbox_key\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Cursor\r\n\r\nAdd to Cursor MCP settings (`~/.cursor/mcp.json` globally, or `.cursor/mcp.json` in a workspace):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"compass\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@compass-food/mcp\"],\r\n      \"env\": {\r\n        \"COMPASS_API_KEY\": \"cmp_test_your_sandbox_key\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Codex CLI\r\n\r\nEdit `~/.codex/config.toml`:\r\n\r\n```toml\r\n[mcp_servers.compass]\r\ncommand = \"npx\"\r\nargs = [\"-y\", \"@compass-food/mcp\"]\r\n\r\n[mcp_servers.compass.env]\r\nCOMPASS_API_KEY = \"cmp_test_your_sandbox_key\"\r\n```\r\n\r\n### Get an API key\r\n\r\n[Sign up free](https://compassfoodtechnologies.com/signup) — 1,000 Compass credits/month, no credit card required.\r\n\r\n## Tools\r\n\r\n### `compass_search`\r\n\r\nWraps `POST /v1/search`.\r\nThe `mode` tool argument is sent to the REST API as the `X-Compass-Mode` header.\r\n\r\n```json\r\n{\r\n  \"query\": \"strict vegan ramen in Brooklyn under $20\",\r\n  \"user_profile\": {\r\n    \"diet\": \"strict_vegan\",\r\n    \"allergens\": [\"peanut\"],\r\n    \"exclude_cross_contamination\": true\r\n  },\r\n  \"location\": {\r\n    \"lat\": 40.6782,\r\n    \"lng\": -73.9442,\r\n    \"radius_m\": 5000\r\n  },\r\n  \"limit\": 10,\r\n  \"mode\": \"rich\"\r\n}\r\n```\r\n\r\n### `compass_enrich_restaurant`\r\n\r\nWraps `POST /v1/enrich/restaurant`.\r\nUse `compass_id` for direct lookup, or `name` plus `address` or `google_place_id` for fuzzy match.\r\n\r\n```json\r\n{\r\n  \"name\": \"Buddha Bodai\",\r\n  \"address\": \"5 Mott St, New York, NY\"\r\n}\r\n```\r\n\r\n### `compass_decide_fit`\r\n\r\nWraps `POST /v1/decision/restaurant-fit`.\r\nThe `mode` tool argument is sent to the REST API as the `X-Compass-Mode` header.\r\n\r\n```json\r\n{\r\n  \"compass_id\": \"rest_xyz789\",\r\n  \"user_profile\": {\r\n    \"diet\": \"strict_vegan\",\r\n    \"exclude_cross_contamination\": true\r\n  },\r\n  \"mode\": \"rich\"\r\n}\r\n```\r\n\r\n## API Key Resolution\r\n\r\nThe server checks:\r\n\r\n1. `COMPASS_API_KEY`\r\n2. `~/.compass/config.json`\r\n\r\nConfig file:\r\n\r\n```json\r\n{\r\n  \"api_key\": \"cmp_live_abc123\",\r\n  \"base_url\": \"https://api.compassfoodtechnologies.com\"\r\n}\r\n```\r\n\r\n## Privacy\r\n\r\nThis package sends tool calls only to the configured Compass API base URL. It does not send secondary usage data.\r\n\r\n## Links\r\n\r\n- Site: https://compassfoodtechnologies.com\r\n- Signup: https://compassfoodtechnologies.com/signup\r\n- API docs: https://api.compassfoodtechnologies.com/openapi\r\n- Source: https://github.com/compass-food/compass-mcp\r\n- npm: https://www.npmjs.com/package/@compass-food/mcp\r\n- Support: support@compassfoodtechnologies.com\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}