Skip to main content
Codex CLI connects to the StoreRouter MCP server at https://mcp.dev.storerouter.ai/mcp. You register the server, sign in once in your browser, and Codex caches and refreshes the tokens for you. No API keys, client IDs, or manual credential management are required.
1

Register the StoreRouter MCP server

Run the following command in your terminal:
This registers a server named storerouter in your Codex configuration.Alternatively, add the entry manually to your Codex config file at ~/.codex/config.toml:
2

Sign in to StoreRouter

Start the OAuth sign-in flow:
Codex opens a browser tab with the StoreRouter sign-in page. Complete the sign-in flow:
  1. Enter the email that belongs to your Developer organization.
  2. Authenticate using your organization’s configured method (password, SSO, or magic link).
  3. If your account belongs to multiple organizations, select the Developer organization you want to act as.
  4. Consent to the requested scopes.
After you complete sign-in, the browser redirects back to Codex, which stores the resulting tokens locally.
Access tokens are valid for approximately five minutes. Codex refreshes them transparently. You are not prompted again unless your StoreRouter sign-in session expires.
3

Verify the registration

Confirm the server is registered with the correct URL:
The output should show url = "https://mcp.dev.storerouter.ai/mcp".

Troubleshooting

  • Codex can’t connect. Run codex mcp get storerouter and check that the URL is https://mcp.dev.storerouter.ai/mcp. If it is not, run codex mcp remove storerouter and register the server again.
  • Codex reports an invalid token. Run codex mcp login storerouter again.

What your agent can do

Once connected, your agent can use these tool groups:
  • Products: lookup_product and lookup_products resolve product page URLs to full product records; search_products searches across all covered stores, with optional catalog, facet, price, store, and brand-style filters.
  • Taxonomy: taxonomy_tree and taxonomy_attribute find the category and attribute filters that search accepts.
  • Brands: search_brands, similar_brands, brand_prefix, get_brand, browse_brand_products, and get_brand_top_categories.
  • Stores: search_stores, similar_stores, and get_store find retailers and describe what they sell.
  • BigQuery: subscription tools for organizations with BigQuery access.
For arguments and error codes, see the MCP overview.