ClariShelf MCP: competitor data
in ChatGPT, Claude and n8n
ClariShelf MCP opens the shelf rank, price, campaign, stock, review topic, market event and AI visibility data of the products and competitors a brand tracks to ChatGPT, Claude, Cursor, Claude Code and n8n through the Model Context Protocol. It only reads your data and never changes anything; it connects with your ClariShelf account (OAuth 2.1) or an API key.
https://app.clarishelf.com/api/public/v1/mcpConnect your client
| Client | Auth | How |
|---|---|---|
| Claude | OAuth | Add the address as a custom connector, sign in to ClariShelf and approve. The same connection works on web, desktop and mobile. |
| ChatGPT | OAuth | Add the address from the apps or connectors settings; availability depends on your account and organisation settings. |
| Cursor | OAuth | Add the address as an MCP server; approval opens in the browser on the first call. |
| Claude Code | OAuth | Add the address as an HTTP MCP server; approval opens in the browser on the first call. |
| n8n | API key | Create a key in the app under Bağlantılar › Erişim (Connections › Access) and send it as an Authorization: Bearer cs_live_… header. |
Tools
| Data | Returns | Time |
|---|---|---|
Workspaceget_workspace | Brand, package and how many own and competitor products are tracked. The starting point. | — |
Products and competitorslist_products | Your own products, the competitors tracked against each, their shelf and product link. | — |
Price, rank and stock historyget_product_pulse | Shelf rank, list/sale/basket price, campaigns and stock; only the hours or days that changed. Every value carries its reading time. | Hourly up to 7 days, daily beyond |
Review topicsget_product_aspects | Weekly topic scores (0–100) from your own product's reviews, beside the same score for the product and competitor set, with evidence counts. | Weekly |
Market eventslist_signals | Competitor discounts and undercuts, rank drops and rises, stock-outs, buy box changes, sponsored listings, rating and review shifts; with family, severity, start and end. | Date range |
AI visibilityget_ai_visibility | How often AI assistants mention the brand in category questions, its share against the leader, per engine. | Date range |
Without dates the last 30 days are read. An unmeasured hour comes back as a gap, never filled with the previous value. History starts on the day the product started being tracked.
Data scope
Provides
- Measured history of the products and competitors your workspace tracks
- Market events produced by the catalogue's thresholds
- Topic scores and evidence counts from reviews
- An AI visibility summary
Does not provide
- Writes, price changes or order operations
- Data for products that are not tracked
- Sales volume or revenue estimates
- The raw text of individual reviews
- Ad spend, budgets or recommendations
Example requests
Which of my competitors started a discount in the last 7 days, and where was our rank in those hours? Put it in an hourly table.
Compare our product's review topics with the competitor set; list the three topics with the largest gap and their evidence counts.
Group this month's signals by family and prepare a one-page summary for management.
Detailed guide (Turkish): E-commerce MCP: competitor research with ChatGPT and Claude
Security
A connection is per user, workspace and client; each member connects for themselves and membership is checked on every request. It uses OAuth 2.1 with PKCE; access tokens last one hour. Workspace admins create and revoke API keys. Each key and connection is limited to 60 requests a minute.
Frequently asked questions
Which AI assistants does it work with?
Clients that support MCP: Claude, ChatGPT, Cursor, Claude Code and n8n. Other clients that can add a remote MCP server use the same address.
Can it change my data?
No. ClariShelf MCP only reads your data; it never changes a price, listing or setting.
How much history is there?
From the day the product started being tracked. Hour by hour up to 7 days, day by day for longer ranges.
Can a competitor see my data?
No. Every connection reads only your own workspace's data.
How do I start?
ClariShelf accounts open through a demo. Once your account is open, add the address to your client.
Try it with your own category's data.
In the demo, see your data by asking ChatGPT or Claude.