Skip to main content
Glama

Superstore MCP Server

by ai-protocols
GitHub
TypeScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Superstore MCP Server

An MCP server for Real Canadian Superstore that extracts orders and product data with authentication.

Features

  • Order Management: Full order history with item details, dates, prices, images

  • DirectAuth: Fast bearer token authentication (no browser needed)

  • Data Export: Export orders to CSV or JSON for analysis

  • Product Discovery: Browse categories and search products

  • Web Content: Fetch and parse web pages

Installation

Quick Install to Cursor

Install MCP Server

Note: Make sure Cursor is running before clicking the install button.

Manual Installation

# Run directly with npx npx -y superstore-mcp@latest # Or clone from GitHub git clone https://github.com/ai-protocols/superstore-mcp.git cd superstore-mcp npm install npm run build

Configuration

Add to your mcp.json:

{ "superstore-mcp": { "command": "npx", "args": ["-y", "superstore-mcp@latest"], "env": { "SUPERSTORE_BEARER_TOKEN": "your-token-here" } } }

Getting Your Bearer Token

  1. Log in to https://www.realcanadiansuperstore.ca

  2. Open DevTools (F12) → Application → Cookies → www.realcanadiansuperstore.ca

  3. Find AccessToken cookie and copy its value (starts with eyJ)

  4. Paste into SUPERSTORE_BEARER_TOKEN

Tokens expire after ~1 hour. Refresh by copying a new token from your browser.

Available Tools

Authentication

login - Authenticate session

{}

logout - End session

{}

check_auth_status - Check authentication state

{}

Orders

get_orders - Get order history

{ "limit": 10, "offset": 0 }

get_order_details - Get full order with items

{ "order_id": "531900014110869" }

get_recent_orders - Filter orders by date

{ "days": 90 }

export_orders_csv - Export to CSV

{ "include_items": true, "filepath": "./orders.csv" }

export_orders_json - Export to JSON

{ "include_items": true, "filepath": "./orders.json" }

Products

get_categories - Get all categories

{}

get_products - Get products from categories

{ "category_ids": ["28251"], "max_pages_per_category": 1 }

get_category - Get single category

{ "category_id": "28251" }

get_product - Search for product

{ "category_id": "28251", "product_name": "bread" }

search_products - Search products (alias)

{ "category_id": "28251", "product_name": "milk" }

get_product_details - Get product details from URL

{ "product_url": "https://www.realcanadiansuperstore.ca/..." }

get_product_details_by_name - Search and get details

{ "category_id": "28251", "product_name": "butter" }

Web Utilities

fetch_txt - Fetch web page as text

{ "url": "https://www.realcanadiansuperstore.ca" }

parse_sitemap - Parse sitemap

{ "sitemap_url": "https://www.realcanadiansuperstore.ca/sitemap_index.xml" }

Example Usage

Export All Orders

// Login await mcp.call("login", {}); // Export with full item details await mcp.call("export_orders_csv", { "include_items": true, });

Analyze Spending

// Get recent orders const orders = await mcp.call("get_recent_orders", { "days": 90 }); // Get details for each for (const order of orders.orders) { const details = await mcp.call("get_order_details", { "order_id": order.id, }); console.log(`${order.id}: ${details.items.length} items`); }

Architecture

  • DirectAuth: Uses bearer token from browser (recommended)

  • API Integration: Calls api.pcexpress.ca/pcx-bff with proper headers

  • Fallback Mode: Puppeteer browser automation if no bearer token provided

  • HTML Parsing: JSDOM for product pages

Documentation

License

MIT

Disclaimer

Unofficial tool. Not affiliated with Loblaw Companies or Real Canadian Superstore. Use responsibly.

Repository: https://github.com/ai-protocols/superstore-mcp\ Version: 2.0.0

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

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 Real Canadian Superstore to extract order history, browse products, and export purchase data. Supports authentication via bearer token and provides comprehensive order management and product discovery capabilities.

  1. Features
    1. Installation
      1. Quick Install to Cursor
      2. Manual Installation
    2. Configuration
      1. Getting Your Bearer Token
    3. Available Tools
      1. Authentication
      2. Orders
      3. Products
      4. Web Utilities
    4. Example Usage
      1. Export All Orders
      2. Analyze Spending
    5. Architecture
      1. Documentation
        1. License
          1. Disclaimer

            New 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/ai-protocols/superstore-mcp'

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