Atlas MCP Server

An MCP (Model Context Protocol) server for integrating with the Atlas restaurant management system.

Requirements

• Node.js 18.0.0 or higher (required for native fetch and Headers APIs)
• If you encounter "fetch is not defined" errors, ensure you're using Node.js 18+ and not an older version

Quick Start with npx

The easiest way to use this MCP server is with npx (no installation required):

1npx @atlas-kitchen/atlas-mcp

Using with Claude Desktop

Add this to your Claude Desktop MCP configuration:

1{
2  "atlas-mcp": {
3    "command": "npx",
4    "args": ["-y", "@atlas-kitchen/atlas-mcp"],
5    "env": {
6      "ATLAS_GRAPHQL_ENDPOINT": "https://api.atlas.kitchen/v1/restaurants/graphql",
7      "ATLAS_CLIENT_NAME": "atlas-mcp",
8      "ATLAS_PLATFORM": "mcp"
9    }
10  }
11}

Environment Variables

The following environment variables can be configured:

• ATLAS_GRAPHQL_ENDPOINT - GraphQL API base URL (default: https://api.atlas.kitchen)
• ATLAS_CLIENT_NAME - Client identifier for API requests (default: atlas-mcp)
• ATLAS_PLATFORM - Platform identifier (default: mcp)

Local Installation

1npm install atlas-mcp
2# or globally
3npm install -g atlas-mcp
4
5# Then run
6atlas-mcp

Configuration

Environment Variables

The server accepts the following environment variables:

• ATLAS_GRAPHQL_ENDPOINT - Atlas GraphQL API endpoint (default: https://atlas-api.food.wearelion.com/v1/restaurants/graphql)
• ATLAS_CLIENT_NAME - Client identifier for API requests (default: atlas-mcp)
• ATLAS_PLATFORM - Platform identifier (default: mcp)

Local Development

For local development, copy .env.example to .env and configure as needed:

1cp .env.example .env

Adding to Claude Desktop

To use this MCP server with Claude Desktop, update your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 1: Using npx (Recommended)

1{
2  "mcpServers": {
3    "atlas-mcp": {
4      "command": "npx",
5      "args": ["-y", "@atlas-kitchen/atlas-mcp"],
6      "env": {
7        "ATLAS_GRAPHQL_ENDPOINT": "https://atlas-api.food.wearelion.com/v1/restaurants/graphql",
8        "ATLAS_CLIENT_NAME": "atlas-mcp",
9        "ATLAS_PLATFORM": "mcp"
10      }
11    }
12  }
13}

Option 2: Local Development

For development with source code:

1{
2  "mcpServers": {
3    "atlas-mcp": {
4      "command": "npx",
5      "args": ["tsx", "/path/to/atlas-mcp/src/index.ts"],
6      "env": {
7        "ATLAS_GRAPHQL_ENDPOINT": "https://atlas-api.food.wearelion.com/v1/restaurants/graphql",
8        "ATLAS_CLIENT_NAME": "atlas-mcp",
9        "ATLAS_PLATFORM": "mcp"
10      }
11    }
12  }
13}

Note: Ensure you have Node.js 18+ installed. You can verify with node --version.

Development

1npm run dev

Building

1npm run build

Available Tools

Authentication

• atlas_login - Login to Atlas with email/password
• atlas_logout - Logout and clear authentication
• atlas_refresh_token - Refresh access token
• atlas_switch_merchant - Switch active merchant context (⚠️ IMPORTANT: Always provide outletId for POS operations)

Usage Example

1// 1. Login first
2atlas_login({ email: "user@example.com", password: "password" })
3
4// 2. CRITICAL: Switch merchant WITH outlet ID
5atlas_switch_merchant({ 
6  merchantId: "1", 
7  outletId: "1"  // Required for POS carts, product insights, etc.
8})
9
10// 3. Now you can use POS endpoints
11atlas_get_pos_carts()

• atlas_get_orders - List orders with filters
• atlas_get_order - Get detailed order information
• atlas_get_cart - Get cart information
• atlas_get_pos_carts - List open POS carts
• atlas_get_menus - List available menus
• atlas_get_optimized_menus - Get optimized menu structure with sections and items
• atlas_get_items - List menu items
• atlas_get_sales_report - Get sales analytics
• atlas_get_product_insights - Product performance data