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:
- Enter the email that belongs to your Developer organization.
- Authenticate using your organization’s configured method (password, SSO, or magic link).
- If your account belongs to multiple organizations, select the Developer organization you want to act as.
- Consent to the requested scopes.
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 storerouterand check that the URL ishttps://mcp.dev.storerouter.ai/mcp. If it is not, runcodex mcp remove storerouterand register the server again. - Codex reports an invalid token. Run
codex mcp login storerouteragain.
What your agent can do
Once connected, your agent can use these tool groups:- Products:
lookup_productandlookup_productsresolve product page URLs to full product records;search_productssearches across all covered stores, with optional catalog, facet, price, store, and brand-style filters. - Taxonomy:
taxonomy_treeandtaxonomy_attributefind the category and attribute filters that search accepts. - Brands:
search_brands,similar_brands,brand_prefix,get_brand,browse_brand_products, andget_brand_top_categories. - Stores:
search_stores,similar_stores, andget_storefind retailers and describe what they sell. - BigQuery: subscription tools for organizations with BigQuery access.