@gera-services/mcp-geraeats

MCP (Model Context Protocol) server for GeraEats -- the food delivery marketplace by Gera Services.

Enables AI assistants (Claude, ChatGPT, etc.) to browse restaurants, view menus, search dishes by cuisine or dietary preference, place delivery orders, and track deliveries across 50+ countries.

Tools

| Tool | Description | Auth Required | |------|-------------|:---:| | search_restaurants | Search restaurants by cuisine, location, and rating | No | | get_restaurant_details | Get full restaurant details (hours, delivery zones, minimum order) | No | | get_menu | Get a restaurant's full menu with categories, prices, and dietary tags | No | | search_menu_items | Search dishes across all restaurants by name or dietary preference | No | | place_order | Place a food delivery order | Yes | | track_order | Track order status with rider location and ETA | Yes | | get_order_history | Get past orders for the user with pagination and date filtering | Yes |

Installation

npm install @gera-services/mcp-geraeats

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "geraeats": {
      "command": "npx",
      "args": ["@gera-services/mcp-geraeats"]
    }
  }
}

With a custom API endpoint

{
  "mcpServers": {
    "geraeats": {
      "command": "npx",
      "args": ["@gera-services/mcp-geraeats"],
      "env": {
        "GERAEATS_API_URL": "https://your-api-url.example.com"
      }
    }
  }
}

Standalone

npx @gera-services/mcp-geraeats

Configuration

| Environment Variable | Description | Default | |---------------------|-------------|---------| | GERAEATS_API_URL | Base URL for the GeraEats API | https://api.geraeats.com |

Multi-Country Support

GeraEats operates across 50+ countries. Pass a country code (ISO 3166-1 alpha-2) to any tool to scope results to that country. Supports proximity search via latitude/longitude for finding nearby restaurants.

Dietary Filtering

The search_menu_items tool supports filtering by dietary preference: vegetarian, vegan, halal, gluten-free, and dairy-free.

Authentication

Browse, search, and menu tools work without authentication. Placing orders and tracking require a user bearer token passed via the auth_token parameter.

License

MIT