@gera-services/mcp-geraeats

@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