Mcp Merchant
Expose a search-only product catalog from Stripe test mode to your agent so it can recommend or look up commerce items without building a full storefront UI first.
Overview
mcp-merchant is a Build-phase MCP server that provides search-only access to a Stripe-backed product catalog for agents via SSE or npx stdio.
What is this MCP server?
- Search-only commerce MCP backed by Stripe (test mode documented)
- Dual access: SSE remote https://mcp.shawndurrani.ai/sse or npx mcp-merchant stdio
- Requires STRIPE_SECRET_KEY; optional PRODUCT_LIMIT (default 100) and REFRESH_INTERVAL_SEC (default 600)
- npm package mcp-merchant version 0.1.3 on MCP schema 2025-09-29
- Catalog cache refresh on an interval—agent queries products without hand-maintained JSON lists
- npm package version 0.1.3 (identifier mcp-merchant)
- Default PRODUCT_LIMIT: 100
- Default REFRESH_INTERVAL_SEC: 600
What problem does it solve?
You want your agent to answer product questions during a build spike, but wiring Stripe catalog search means custom scripts and stale manual exports.
Who is it for?
Solo builders prototyping AI commerce demos, agents that help pick SKUs, or internal tools that need read-only Stripe catalog search in test mode.
Skip if: Production checkout, inventory fulfillment, multi-merchant marketplaces, or teams that need write APIs to Stripe from the agent without additional hardening.
What do I get? / Deliverables
With Stripe test credentials and mcp-merchant registered, your agent can search a refreshed cache of Stripe products within your configured limit and interval.
- Agent-queryable search results over cached Stripe products
- Configurable catalog size up to PRODUCT_LIMIT (default 100)
- Periodic refresh behavior driven by REFRESH_INTERVAL_SEC (default 600)
Recommended MCP Servers
Journey fit
Build integrations is the right shelf for a Stripe-backed MCP that wires payment catalog data into agent workflows during product construction, especially ecommerce experiments. Integrations subphase covers third-party APIs; this server caches Stripe products with configurable refresh and exposes search tooling over SSE or stdio npm transport.
How it compares
Stripe catalog search MCP (read-only), not a hosted storefront SaaS or a payments onboarding skill.
Common Questions / FAQ
Who is mcp-merchant for?
Developers building agent-first ecommerce experiments who already use Stripe test products and want searchable catalog context in MCP clients.
When should I use mcp-merchant?
During build and validate spikes when you need agents to look up Stripe products while designing flows—before you invest in a full merchant admin or production keys.
How do I add mcp-merchant to my agent?
Either connect the SSE remote https://mcp.shawndurrani.ai/sse or run npx mcp-merchant with STRIPE_SECRET_KEY set; optionally set PRODUCT_LIMIT and REFRESH_INTERVAL_SEC.