UNDERCART MCP CONNECTOR
Query Undercart’s Shopify store intelligence from any MCP-compatible agent. Add one connector URL, sign in, and ask questions like “find beauty Shopify stores over $10M/yr that use Klaviyo” — no code to write.
- 1In your MCP client, open its connector/server settings and choose to add a remote (HTTP) MCP server. In Claude that’s Settings → Connectors → Add custom connector; other clients call it “add server” or use an
mcp.jsonentry. - 2Name it Undercart and paste this connector URL:
https://undercart.co/api/mcp - 3Save. The client opens an Undercart sign-in window over OAuth — sign in with your Google account and click Allow access. The Undercart tools appear and you can start asking questions.
Requires a client that supports remote MCP servers over Streamable HTTP with OAuth. If yours doesn’t do OAuth, use the API-key header below instead. Note that adding a connector inside a Claude organization (rather than a personal account) typically needs a Team or Enterprise plan and org-admin access.
What you get
The connector exposes read-only tools over the Model Context Protocol (Streamable HTTP). Your agent can search stores, pull full enriched profiles, list a store’s tech stack, find similar stores, view the actual ads a store is running, and read its captured marketing emails — all scoped to enriched Shopify stores in the Undercart database. Every result reports estimated revenue annual before monthly and links back to the store’s Undercart page. It’s the same data as the REST API, driven by natural language instead of HTTP.
Alternative: API key
For MCP Inspector, scripted clients, or any tool that lets you set a custom request header, authenticate with an Undercart API key instead of OAuth. Create a key in Settings → API keys (shown once), then send it as an X-API-Key header on requests to https://undercart.co/api/mcp. Same key scheme as the Undercart REST API.
Tools
Filter enriched stores by category, country, annual revenue range, and technology/app used. Returns concise profiles ranked by estimated revenue.
Full enriched profile for one store by domain: revenue and order estimates, Shopify plan, category, country, founding year, growth, catalog stats, technology stack, ad presence, and social profiles.
The detected app/technology stack for a store, grouped by category (email, reviews, subscriptions, analytics, and more).
Peers in the same category and revenue band as a given store — useful for competitive sets and lookalikes.
Per-platform ad presence (active, ad count, estimated spend) and the actual ads in a platform’s public ad library — headline, copy, CTA, landing page, and first/last seen dates for Meta, Google, TikTok, and LinkedIn. In clients that support MCP Apps, results render as an ad gallery with image and video previews right in the conversation.
The marketing emails Undercart has captured from a store’s newsletter: subject, snippet, discount codes, and send cadence.
The full body of a single captured email, by id — plain text plus the sanitized HTML source on request. In clients that support MCP Apps, the email renders visually, images included, right in the conversation.
All store categories with store counts — the valid values for the search_stores category filter.
Example prompts
Usage & limits
Each store-data tool call counts as one store access against your monthly plan quota, exactly like the REST API (list_store_categories and get_store_email are free). When you reach your cap, tools return a clear “monthly store limit reached” message with the reset date. Only enriched stores are returned; dormant or unverified domains are never exposed.
X-API-Key header.