MCP & API
Store data for your agents and your code.
Ask Claude or ChatGPT what theme a store runs, what it launched this month or which Shopify stores use Klaviyo in Germany. The Storelens MCP server and REST API run on your plan, with the same allowances as the dashboard.
MCP server
Add it as a custom connector (Claude: Settings → Connectors → Add custom connector; ChatGPT: developer mode → Add app). You sign in to Storelens and approve access.
https://storelensapp.com/mcp
Claude Code:
claude mcp add --transport http storelens https://storelensapp.com/mcp
Apps without OAuth can send an API key:
{
"mcpServers": {
"storelens": {
"url": "https://storelensapp.com/mcp",
"headers": { "Authorization": "Bearer sl_live_…" }
}
}
}REST API
Create a key in Settings and send it as a Bearer token. JSON in, JSON out.
curl https://storelensapp.com/v1/detect?url=allbirds.com \ -H "Authorization: Bearer sl_live_…"
GET /v1/detect?url=allbirds.comTheme, apps and stackGET /v1/stores/{domain}Store spy reportGET /v1/stores/{domain}/adsLive Meta adsPOST /v1/stores/{domain}/contactsOwner contactsGET /v1/leads?theme=Dawn&app=klaviyo&country=USLead search (page=0, 50 rows a page)GET /v1/leads/filtersAvailable filter valuesGET /v1/tracked · POST /v1/tracked · DELETE /v1/tracked/{domain}Tracked storesGET /v1/alerts?days=7Changes in tracked storesGET /v1/accountPlan and usage
Tools
Each tool mirrors a dashboard feature and counts toward the same monthly allowance.
| Tool | Returns | Uses |
|---|---|---|
| detect_store | Theme, apps, tech stack, country and product count of any store | Free |
| get_store_report | Catalog, prices, launches in 30 days, best sellers, price and stock changes | 1 spy report |
| get_store_ads | The Meta ads a store is running now, with creative, copy and start date | 1 ad lookup |
| search_leads | Shopify stores by theme, app, country, niche and catalog size | Free (plan rows) |
| get_lead_filters | Themes, apps, countries and niches in the index, with counts | Free |
| reveal_store_contacts | Owners and executives of a store: name, title, email, LinkedIn | 1 reveal, refunded on a miss |
| track_store / untrack_store | Daily price, launch and stock alerts for a store | Plan's tracked-store limit |
| list_tracked_stores / get_alerts | Your tracked stores and their recent changes | Free |
| get_account | Plan, monthly limits and usage | Free |
Agent instructions: skill.md · Server card: server-card.json · Allowances per plan: pricing