{"_id":"@atlas-kitchen/atlas-mcp","_rev":"7-696a0cd06c9d4d5aa5f4ebebdba03455","name":"@atlas-kitchen/atlas-mcp","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@atlas-kitchen/atlas-mcp","version":"1.0.0","keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"author":{"name":"Atlas Kitchen"},"license":"MIT","_id":"@atlas-kitchen/atlas-mcp@1.0.0","maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"bin":{"atlas-mcp":"dist/index.js"},"dist":{"shasum":"858e1d3a6c4b225ae4fa4ebe1baf84733dee23e9","tarball":"https://registry.npmjs.org/@atlas-kitchen/atlas-mcp/-/atlas-mcp-1.0.0.tgz","fileCount":38,"integrity":"sha512-TO4PcFXOLQ+diFwKatRB5rWnzY3IvlZal3VcqO4oLmWKZ7FCPDhY0EApU6CzNr6cR8BQ1qTz7JaBtCB43qAUUg==","signatures":[{"sig":"MEUCICtsQcXALRVQ9GrgZq8qeEb+BIXN7viagKIQs4zR0GtwAiEA/5rxESDrZU8fySUIfc6SWLN91PXM1zIgDRYF4uB5iYI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":112423},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c97d5eab56aac27e7282bf5c8c15f53ea2e90a90","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"atlas-kitchen","actor":{"name":"atlas-kitchen","type":"user","email":"product@atlas.kitchen"},"email":"product@atlas.kitchen"},"repository":{"url":"git+https://github.com/atlas-kitchen/atlas-mcp.git","type":"git"},"_npmVersion":"10.7.0","description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","directories":{},"_nodeVersion":"18.20.4","dependencies":{"tsx":"^4.20.3","zod":"^3.25.75","uuid":"^11.1.0","dotenv":"^17.0.1","graphql":"^16.11.0","typescript":"^5.8.3","@types/node":"^24.0.10","@types/uuid":"^10.0.0","graphql-request":"^7.2.0","@modelcontextprotocol/sdk":"^1.15.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlas-mcp_1.0.0_1752002247260_0.5134927703781111","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@atlas-kitchen/atlas-mcp","version":"1.0.1","keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"author":{"name":"Atlas Kitchen"},"license":"MIT","_id":"@atlas-kitchen/atlas-mcp@1.0.1","maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"bin":{"atlas-mcp":"dist/index.js"},"dist":{"shasum":"e77a0682166431414a4baa0714a4f78b470416f9","tarball":"https://registry.npmjs.org/@atlas-kitchen/atlas-mcp/-/atlas-mcp-1.0.1.tgz","fileCount":38,"integrity":"sha512-8B0X3HNX9UXpRYhGv9kaU8bz4mttZd/RsKd2d704zxDnKAh+oPSok976ih75tp0gaXxnVgZUUe4kQm7069srXA==","signatures":[{"sig":"MEUCIQDljzwobKmM19MFsHa1IBXE+w/otZ15MSdo/VStMA3OQAIgBlJcU5q8gdSjEqs5c8+7U45hiitqp0Xv9ZA5XITUumU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":112423},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"0d954e20ee746754f7aa17008e53e377ac6d4f3f","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"atlas-kitchen","actor":{"name":"atlas-kitchen","type":"user","email":"product@atlas.kitchen"},"email":"product@atlas.kitchen"},"repository":{"url":"git+https://github.com/atlas-kitchen/atlas-mcp.git","type":"git"},"_npmVersion":"10.7.0","description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","directories":{},"_nodeVersion":"18.20.4","dependencies":{"tsx":"^4.20.3","zod":"^3.25.75","uuid":"^11.1.0","dotenv":"^17.0.1","graphql":"^16.11.0","typescript":"^5.8.3","@types/node":"^24.0.10","@types/uuid":"^10.0.0","graphql-request":"^7.2.0","@modelcontextprotocol/sdk":"^1.15.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlas-mcp_1.0.1_1752002535520_0.904905899795555","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@atlas-kitchen/atlas-mcp","version":"1.0.2","keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"author":{"name":"Atlas Kitchen"},"license":"MIT","_id":"@atlas-kitchen/atlas-mcp@1.0.2","maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"bin":{"atlas-mcp":"dist/index.js"},"dist":{"shasum":"90cbd3b9738705b63addc5a69068e80a54557757","tarball":"https://registry.npmjs.org/@atlas-kitchen/atlas-mcp/-/atlas-mcp-1.0.2.tgz","fileCount":38,"integrity":"sha512-+u8v5t8fakFbPtbrduTyGXW60JZ8ZJiIxIkPY1OopQ0tcaZ+UDKqZoIWvlodTVrwy9NHhLkC9jS7zVXP1+Cinw==","signatures":[{"sig":"MEYCIQCg2n9omLEV6k+2/L1d6QEpZ0C65wBbnyIHlrxFqskWjwIhAKzBpUXNnR3ACW7AZUYdp3AUDfeT4+0XnbEUuMPaNoOG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":115414},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7b1ec15cf215db4b01d335b0f2e9e411a6dfd1dd","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"atlas-kitchen","actor":{"name":"atlas-kitchen","type":"user","email":"product@atlas.kitchen"},"email":"product@atlas.kitchen"},"repository":{"url":"git+https://github.com/atlas-kitchen/atlas-mcp.git","type":"git"},"_npmVersion":"10.7.0","description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","directories":{},"_nodeVersion":"18.20.4","dependencies":{"tsx":"^4.20.3","zod":"^3.25.75","uuid":"^11.1.0","dotenv":"^17.0.1","graphql":"^16.11.0","typescript":"^5.8.3","@types/node":"^24.0.10","@types/uuid":"^10.0.0","graphql-request":"^7.2.0","@modelcontextprotocol/sdk":"^1.15.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlas-mcp_1.0.2_1752003265705_0.8163571350139307","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@atlas-kitchen/atlas-mcp","version":"1.0.3","keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"author":{"name":"Atlas Kitchen"},"license":"MIT","_id":"@atlas-kitchen/atlas-mcp@1.0.3","maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"bin":{"atlas-mcp":"dist/index.js"},"dist":{"shasum":"1fddb6090d2f47ed54c2089894044260e5b973a5","tarball":"https://registry.npmjs.org/@atlas-kitchen/atlas-mcp/-/atlas-mcp-1.0.3.tgz","fileCount":38,"integrity":"sha512-SVGXtZoWC0wYpbev0U4FM6C8BfUuQMlEJ0nED/ucaKm0zMBgRPG/MCe8dgvOD+/MUO/o+YQc4lZsgyKQT1a0oQ==","signatures":[{"sig":"MEQCIDD8bULZKSDyZyNQh3Sd+9zCFCgLZj7IRdIK9EgWwZkSAiBHVq8LWH1XqHMC84nXg3EHPt143hQ+/eYsw0Da+Xr/zw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":113986},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"80d7ca013090f3edea0f414c35389e3f634113bf","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"atlas-kitchen","actor":{"name":"atlas-kitchen","type":"user","email":"product@atlas.kitchen"},"email":"product@atlas.kitchen"},"repository":{"url":"git+https://github.com/atlas-kitchen/atlas-mcp.git","type":"git"},"_npmVersion":"10.7.0","description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","directories":{},"_nodeVersion":"18.20.4","dependencies":{"tsx":"^4.20.3","zod":"^3.25.75","uuid":"^11.1.0","dotenv":"^17.0.1","graphql":"^16.11.0","typescript":"^5.8.3","@types/node":"^24.0.10","@types/uuid":"^10.0.0","graphql-request":"^7.2.0","@modelcontextprotocol/sdk":"^1.15.0"},"engineStrict":true,"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/atlas-mcp_1.0.3_1752003495291_0.1574516053959285","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@atlas-kitchen/atlas-mcp","version":"1.1.0","keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"author":{"name":"Atlas Kitchen"},"license":"MIT","_id":"@atlas-kitchen/atlas-mcp@1.1.0","maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"bin":{"atlas-mcp":"dist/index.js"},"dist":{"shasum":"fbf5ff7d96d815c0ead75de0f7dd1fb5c09d59da","tarball":"https://registry.npmjs.org/@atlas-kitchen/atlas-mcp/-/atlas-mcp-1.1.0.tgz","fileCount":40,"integrity":"sha512-QpNG6zJMVzLC0eDpKTLFM4KrKOJuacsSvI96Z9ZPNVTXIz5t7lD3UYMgy5SZcxHk7urnIVE5WRzNGVbgqcyFeg==","signatures":[{"sig":"MEQCID/KDoFc96LGE2VS1yp6vOxReAAXPEhorF8vUpkItFliAiB686ahZyjS7jBZi9OEjrVtRj9Ao5NiYM5KLVrD/Vozkw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92141},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"4372a6865e7db1779b06a8421d557e772da36341","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build","release":"npm version patch && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","test:watch":"vitest","release:major":"npm version major && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","release:minor":"npm version minor && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"atlas-kitchen","email":"product@atlas.kitchen"},"repository":{"url":"git+https://github.com/atlas-kitchen/atlas-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","directories":{},"_nodeVersion":"20.20.0","dependencies":{"tsx":"^4.20.3","zod":"^3.25.75","uuid":"^11.1.0","dotenv":"^17.0.1","graphql":"^16.11.0","typescript":"^5.8.3","@types/node":"^24.0.10","@types/uuid":"^10.0.0","graphql-request":"^7.2.0","@modelcontextprotocol/sdk":"^1.15.0"},"engineStrict":true,"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","@vitest/coverage-v8":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/atlas-mcp_1.1.0_1770198543455_0.08067227165938329","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@atlas-kitchen/atlas-mcp","version":"1.2.0","keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"author":{"name":"Atlas Kitchen"},"license":"MIT","_id":"@atlas-kitchen/atlas-mcp@1.2.0","maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"bin":{"atlas-mcp":"dist/index.js"},"dist":{"shasum":"3e3fa8c23b5007d1dc185be5617beedd6b3ecc0d","tarball":"https://registry.npmjs.org/@atlas-kitchen/atlas-mcp/-/atlas-mcp-1.2.0.tgz","fileCount":40,"integrity":"sha512-eRjhNK/v7dNbYDFEwR2XaSHgfbqHaR1vQvx/e1ypY34QSoSeFa9inoROdF1Go+ziCfzx6uOuuNP8oYGiRRvLIQ==","signatures":[{"sig":"MEUCIHdbx8nQpcZ/DU1ENOdwVYHV7cnIsvJMSMN0COqJWA80AiEAlkXW8AzaVZH0fYEpbr4mwAg1dTsjturlbeelG2eN78I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":93255},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"347c7f96615832f2149492bb517fcb62e6a88ab2","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","prepare":"npm run build","release":"npm version patch && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","test:watch":"vitest","release:major":"npm version major && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","release:minor":"npm version minor && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"atlas-kitchen","email":"product@atlas.kitchen"},"repository":{"url":"git+https://github.com/atlas-kitchen/atlas-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","directories":{},"_nodeVersion":"20.20.0","dependencies":{"tsx":"^4.20.3","zod":"^3.25.75","uuid":"^11.1.0","dotenv":"^17.0.1","graphql":"^16.11.0","typescript":"^5.8.3","@types/node":"^24.0.10","@types/uuid":"^10.0.0","graphql-request":"^7.2.0","@modelcontextprotocol/sdk":"^1.15.0"},"engineStrict":true,"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","@vitest/coverage-v8":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/atlas-mcp_1.2.0_1772131998364_0.1637700538598108","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@atlas-kitchen/atlas-mcp","version":"1.3.0","description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","main":"dist/index.js","bin":{"atlas-mcp":"dist/index.js"},"engines":{"node":">=18.0.0"},"engineStrict":true,"scripts":{"build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","dev":"tsx src/index.ts","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","release":"npm version patch && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","release:minor":"npm version minor && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","release:major":"npm version major && git push && git push --tags && gh release create v$(node -p \"require('./package.json').version\") --generate-notes","prepublishOnly":"npm run build","prepare":"npm run build"},"keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"author":{"name":"Atlas Kitchen"},"license":"MIT","type":"module","repository":{"type":"git","url":"git+https://github.com/atlas-kitchen/atlas-mcp.git"},"homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.15.0","@types/node":"^24.0.10","@types/uuid":"^10.0.0","dotenv":"^17.0.1","graphql":"^16.11.0","graphql-request":"^7.2.0","tsx":"^4.20.3","typescript":"^5.8.3","uuid":"^11.1.0","zod":"^3.25.75"},"devDependencies":{"vitest":"^3.0.0","@vitest/coverage-v8":"^3.0.0"},"_id":"@atlas-kitchen/atlas-mcp@1.3.0","gitHead":"14d781575efec32ae50f42f47093b257cde76bc6","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-kWntW7CSsq4Xa6Vm/c+8noZMsXEgrqjsMDoNy7C1R+VGQR/uYi/FJE4nxMXy6T56IiQt93DZwc8aFoyH8BmZ6Q==","shasum":"fd9c07294759eff9be0fe96c5a92c9703c6362cb","tarball":"https://registry.npmjs.org/@atlas-kitchen/atlas-mcp/-/atlas-mcp-1.3.0.tgz","fileCount":40,"unpackedSize":99131,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIESWWBOiBkf+ojDxXsSv/l6P8OXtqXm6fUfyo8k6zcRkAiB+XzjSaWREwFpKl1G+V2dvKn8gzgQq1vI0Hkw+GXMpnQ=="}]},"_npmUser":{"name":"atlas-kitchen","email":"product@atlas.kitchen"},"directories":{},"maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/atlas-mcp_1.3.0_1772133957469_0.44379299786689463"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-08T19:17:27.157Z","modified":"2026-02-26T19:25:57.741Z","1.0.0":"2025-07-08T19:17:27.447Z","1.0.1":"2025-07-08T19:22:15.696Z","1.0.2":"2025-07-08T19:34:25.892Z","1.0.3":"2025-07-08T19:38:15.462Z","1.1.0":"2026-02-04T09:49:03.589Z","1.2.0":"2026-02-26T18:53:18.499Z","1.3.0":"2026-02-26T19:25:57.625Z"},"bugs":{"url":"https://github.com/atlas-kitchen/atlas-mcp/issues"},"author":{"name":"Atlas Kitchen"},"license":"MIT","homepage":"https://github.com/atlas-kitchen/atlas-mcp#readme","keywords":["mcp","modelcontextprotocol","atlas","restaurant","graphql","claude","ai"],"repository":{"type":"git","url":"git+https://github.com/atlas-kitchen/atlas-mcp.git"},"description":"Model Context Protocol server for Atlas restaurant management system - enables Claude to interact with restaurant orders, menus, and reports","maintainers":[{"name":"atlas-kitchen","email":"product@atlas.kitchen"}],"readme":"# Atlas MCP Server\n\nAn MCP (Model Context Protocol) server for integrating with the Atlas restaurant management system.\n\n## Requirements\n\n- Node.js 18.0.0 or higher (required for native fetch and Headers APIs)\n\n## Quick start with npx\n\n```bash\nnpx @atlas-kitchen/atlas-mcp\n```\n\n### Using with Claude Desktop\n\nAdd this to your Claude Desktop MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"atlas-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atlas-kitchen/atlas-mcp\"],\n      \"env\": {\n        \"ATLAS_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Environment variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `ATLAS_API_KEY` | Yes | API key for automatic authentication |\n| `ATLAS_GRAPHQL_ENDPOINT` | No | GraphQL API base URL (default: `https://api.atlas.kitchen`) |\n| `ATLAS_CLIENT_NAME` | No | Client identifier for API requests (default: `atlas-mcp-1.0.0`) |\n| `ATLAS_MERCHANT_ID` | No | Default merchant ID on first run |\n| `ATLAS_OUTLET_ID` | No | Default outlet ID on first run (defaults to `all`) |\n\n## Authentication\n\nThe server authenticates automatically on startup using `ATLAS_API_KEY`. No manual login is needed.\n\n- **Tokens are cached** to `~/.atlas-mcp/cache.json` and reused across restarts\n- **Merchant/outlet context persists** across sessions until explicitly switched\n- On auth failure, the server automatically refreshes tokens or re-authenticates\n\n## Local development\n\n```bash\nnpm install\ncp .env.example .env  # Configure with your API key\nnpm run dev            # Run with tsx (development)\nnpm run build          # Compile TypeScript\nnpm start              # Run compiled JavaScript\n```\n\n### Local development config\n\n```json\n{\n  \"mcpServers\": {\n    \"atlas-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"tsx\", \"/path/to/atlas-mcp/src/index.ts\"],\n      \"env\": {\n        \"ATLAS_API_KEY\": \"your-api-key-here\",\n        \"ATLAS_MERCHANT_ID\": \"1\"\n      }\n    }\n  }\n}\n```\n\n### Pointing to a local backend\n\nWhen iterating on Atlas APIs or developing new MCP tools, point the server to your local backend:\n\n```json\n{\n  \"mcpServers\": {\n    \"atlas-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"tsx\", \"/path/to/atlas-mcp/src/index.ts\"],\n      \"env\": {\n        \"ATLAS_API_KEY\": \"your-api-key-here\",\n        \"ATLAS_GRAPHQL_ENDPOINT\": \"http://localhost:3000\",\n        \"ATLAS_MERCHANT_ID\": \"1\"\n      }\n    }\n  }\n}\n```\n\nThe server appends `/graphql` automatically, so `http://localhost:3000` becomes `http://localhost:3000/graphql`.\n\n**Tip:** After changing MCP config, restart Claude Desktop (or run `/exit` in Claude Code) to pick up the changes.\n\n## Available tools\n\n### Authentication\n- `atlas_auth_status` - Show current authentication and merchant context\n- `atlas_list_merchants` - List all merchants the user can access\n- `atlas_list_outlets` - List outlets for the current merchant\n- `atlas_switch_merchant` - Switch merchant context (fuzzy matches by name, identifier, or ID)\n\n### Orders\n- `atlas_get_orders` - List orders with filters (paginated, max 100 per page)\n- `atlas_get_order` - Get detailed order information\n- `atlas_get_cart` - Get cart details by ID\n- `atlas_get_pos_carts` - List open POS carts (requires specific outlet)\n\n### Menu\n- `atlas_get_items` - Search and list item catalog (paginated, max 100 per page)\n\n### Reports\n- `atlas_get_sales_report` - Get sales analytics (max 90 day range)\n\n## Publishing to npm\n\nReleases are published automatically via GitHub Actions when you create a GitHub release.\n\n### One-time setup\n\n1. Go to [npmjs.com token settings](https://www.npmjs.com/settings/atlas-kitchen/tokens)\n2. Create a **Granular Access Token** with **Read and write** permission on packages, scoped to `@atlas-kitchen`\n3. In the GitHub repo, go to **Settings > Secrets and variables > Actions**\n4. Add a secret named `NPM_TOKEN` with the token value\n\n### Publishing a new version\n\n```bash\nnpm run release         # patch: 1.1.0 → 1.1.1\nnpm run release:minor   # minor: 1.1.0 → 1.2.0\nnpm run release:major   # major: 1.1.0 → 2.0.0\n```\n\nThis bumps the version, pushes the tag, and creates a GitHub release in one command. The GitHub Action then builds and publishes to npm automatically.\n\n### CI\n\nPull requests and pushes to `main` run a build check across Node.js 18, 20, and 22.\n\n### Usage example\n\n```\n# No login needed - authentication is automatic!\n\n# Check current status\natlas_auth_status()\n\n# Switch merchant by name (fuzzy matched)\natlas_switch_merchant({ merchant: \"My Restaurant\" })\n\n# Switch merchant with specific outlet for POS\natlas_switch_merchant({ merchant: \"My Restaurant\", outletId: \"5\" })\n\n# Query orders\natlas_get_orders({ startDate: \"2026-01-01\", endDate: \"2026-01-31\" })\n```\n","readmeFilename":"README.md"}