Superstore MCP Server

How to use

Start by starting the MCP server with your preferred client. You will authenticate using a bearer token obtained from the Real Canadian Superstore site, then use the available tools to fetch order history, order details, and product information. You can export orders to CSV or JSON for analysis, browse product categories, and fetch web content when needed. Use the authentication flow to log in, verify your session, and then perform reads like getting recent orders, fetching order details, and retrieving product lists. Each action is exposed as a tool you call through the MCP client, returning structured data you can process in your analytics pipeline.

Typical usage patterns include: authenticating once per session, listing orders, retrieving detailed order information, exporting data for reporting, and querying products by category or name. For web utilities, you can fetch page text or parse sitemap data to discover additional endpoints or categories. If your token expires, refresh it by obtaining a new token and updating your environment variable. Follow the practical steps to perform these actions from your MCP client, then handle the response data in your downstream systems.

How to install

Prerequisites: you need Node.js and npm installed on your machine. Ensure you have internet access to install dependencies and fetch the MCP package.

Option 1 — Quick install using the MCP client helper (recommended for ease of use): ensure the helper is running, then trigger the install flow for the Superstore MCP server, which will configure and run the server for you.

Option 2 — Manual installation: install and run the MCP server locally.

Run directly with npx

npx -y superstore-mcp@latest

Configuration and bearer token setup

To configure the MCP server, create or update your mcp.json with the following entry to run the server and supply your bearer token.

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

Getting Your Bearer Token

Obtain your bearer token from the Real Canadian Superstore site and place it in your environment variable. Copy the value that starts with eyJ and paste it into SUPERSTORE_BEARER_TOKEN. Tokens expire after about an hour; refresh by obtaining a new token and updating the environment variable.

login

Authenticate session with the MCP server to establish a bearer-token-based session.

logout

End the current session and clear authentication state.

check_auth_status

Check whether your session is currently authenticated and valid.

get_orders

Retrieve the user's order history with optional limits and offsets.

get_order_details

Fetch full details for a specific order, including items.

get_recent_orders

Filter orders by a date range or number of days.

export_orders_csv

Export orders to a CSV file, optionally including item details.

export_orders_json

Export orders to a JSON file, optionally including item details.

get_categories

List all product categories available in the catalog.

get_products

Retrieve products from specified categories, with paging control.

get_category

Get information for a single product category.

get_product

Search for products by name within a category.

search_products

Alias for product search within a category.

get_product_details

Obtain detailed information for a product from its URL.

get_product_details_by_name

Search and retrieve product details by name within a category.

fetch_txt

Fetch a web page and return its text content.

parse_sitemap

Parse a sitemap URL and extract product or category references.