Skip to main content
Glama

Rami Levy MCP Server

by shilomagen

Rami Levy MCP Server

MCP Server for the Rami Levy Online Grocery Store API. This is a proof of concept implementation that demonstrates how to integrate Rami Levy's e-commerce platform with MCP-enabled LLMs.

Tools

  1. search_items
    • Search for products in Rami Levy's catalog
    • Inputs:
      • q (string): Search query
      • store (string, optional): Store identifier (default: "331")
      • aggs (number, optional): Aggregation flag (default: 1)
    • Returns: Array of products with name, price, image URL, and ID
  2. add_to_cart
    • Add one or more items to the shopping cart
    • Inputs:
      • store (string): Store identifier (e.g., "331")
      • items (array): List of items to add, each containing:
        • id (number): Product identifier
        • quantity (number): Quantity to add (minimum: 1)
    • Returns: Updated cart contents with prices and discounts
  3. remove_from_cart
    • Remove items from the cart by providing an updated list of items to keep
    • Inputs:
      • store (string): Store identifier
      • items (array): Updated list of items to keep in cart
    • Returns: Updated cart contents
  4. update_quantity
    • Update the quantity of an item in the cart
    • Inputs:
      • store (string): Store identifier
      • id (number): Product identifier
      • newQuantity (number): New quantity for the product (minimum: 1)
    • Returns: Updated cart contents

Resources

  1. rami-levy://checkout
    • Get the URL for the Rami Levy checkout page
    • Returns: Checkout page URL

Setup

Authentication

This MCP server requires authentication tokens from an active Rami Levy session. To obtain these:

  1. Log in to Rami Levy's website
  2. Open your browser's developer tools (F12)
  3. Go to the Network tab
  4. Make any request (e.g., search for a product)
  5. From the request headers, extract:
    • RAMI_LEVY_API_KEY: The token after "Bearer" in the Authorization header
    • ECOM_TOKEN: The full ecomtoken header value
    • COOKIE: The complete cookie header value

Environment Variables

Create a .env file with the following variables:

RAMI_LEVY_API_KEY=your_api_key_here ECOM_TOKEN=your_ecom_token_here COOKIE=your_cookie_string_here

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

{ "mcpServers": { "rami-levy": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-rami-levy" ], "env": { "RAMI_LEVY_API_KEY": "<YOUR_API_KEY>", "ECOM_TOKEN": "<YOUR_ECOM_TOKEN>", "COOKIE": "<YOUR_COOKIE>" } } } }

Development

  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. Start the server:
npm start

Security Considerations

⚠️ Important: This is a proof of concept implementation. Please note:

  1. The authentication tokens provide full access to your Rami Levy account
  2. Tokens should be kept secure and never committed to version control
  3. Tokens expire periodically and will need to be refreshed
  4. This implementation is not intended for production use without proper security review

Limitations

  1. Session tokens expire and need to be manually refreshed
  2. Some features of the Rami Levy API are not implemented (e.g., user profile, order history)
  3. Error handling for expired sessions could be improved
  4. No rate limiting implementation

Contributing

Issues and pull requests are welcome! Please ensure you don't commit any sensitive information like authentication tokens.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Disclaimer

This is an unofficial project and is not affiliated with or endorsed by Rami Levy Chain Stores Ltd. All product names, logos, and brands are property of their respective owners.

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables interaction with the Rami Levy Online Grocery Store API, allowing users to perform product searches, add or remove items from their cart, and prepare for checkout, all while integrating with MCP-enabled LLMs.

  1. Tools
    1. Resources
      1. Setup
        1. Authentication
        2. Environment Variables
        3. Usage with Claude Desktop
      2. Development
        1. Security Considerations
          1. Limitations
            1. Contributing
              1. License
                1. Disclaimer

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    Integrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.
                    Last updated -
                    3
                    569
                    9
                    JavaScript
                    MIT License
                    • Linux
                  • A
                    security
                    A
                    license
                    A
                    quality
                    An MCP server implementation that integrates the Tavily Search API, providing optimized search capabilities for LLMs.
                    Last updated -
                    1
                    2
                    TypeScript
                    MIT License
                    • Apple
                  • A
                    security
                    A
                    license
                    A
                    quality
                    Enables interaction with MercadoLibre's API for product search, reviews, descriptions, and seller reputation insights.
                    Last updated -
                    4
                    553
                    7
                    TypeScript
                    MIT License
                  • -
                    security
                    A
                    license
                    -
                    quality
                    Enables interaction with Shopify stores through GraphQL API, providing tools for managing products, customers, orders, and more.
                    Last updated -
                    655
                    7
                    TypeScript
                    MIT License

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/shilomagen/rami-levy-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server