Periskop — Product Discovery for AI Agents

Product discovery for AI agents. One MCP call turns a natural-language shopping intent into structured, ranked product results — best picks, alternatives, bundles, caveats, prices, and merchant links — from across independent stores on the open merchant web.

Periskop is a hosted, remote MCP server (closed source). You connect over the public HTTPS endpoint with a Periskop API key — nothing to install or run. It's the discovery layer for agentic commerce: an agent asks in natural language and Periskop returns ranked products with links back to the merchant. It stops at discovery — no checkout, no payments, no orders.

• Website: https://periskop.ai
• Developer portal / get an API key: https://periskop.ai/developer
• Docs: https://periskop.ai/developer/docs
• MCP endpoint: https://mcp.periskop.ai/v1/mcp (Streamable HTTP, JSON-RPC 2.0)

Who it's for

Any product that needs to turn intent into reliable product results without owning checkout — agent platforms and orchestrators, AI worker platforms, AI shopping assistants, browser agents, commerce copilots, recommendation systems, procurement and B2B sourcing workflows, price and deal monitors, restock/reorder bots, gifting apps, resale and arbitrage workflows, and accessibility shopping tools. Concretely: an agent that plans a camping trip and returns the gear, a procurement copilot comparing options across suppliers, or a voice assistant surfacing the right product from a single sentence.

What it does (and does not) do

Periskop returns product results and merchant links only. It does not complete checkout, create merchant carts, process payment, reserve inventory, or purchase items. The user always completes any purchase on the merchant's own website. Every response carries a purchase_boundary block restating this.

Connection

Endpoint	https://mcp.periskop.ai/v1/mcp
Transport	Streamable HTTP — JSON-RPC 2.0 over HTTP POST (one JSON response per POST; no SSE)
Wire protocol	2024-11-05
Auth	Authorization: Bearer <YOUR_PERISKOP_API_KEY> (keys look like dp_…)
Get a key	https://periskop.ai/developer

Unauthenticated requests receive 401 with a WWW-Authenticate: Bearer header.

Note: Periskop also supports OAuth 2.1 (Authorization Code + PKCE) for hosts that prefer it (tokens look like dpo_…). API key is the simplest path and is all you need for the configs below.

Tools

All tools take a single JSON object argument. Schemas below are the public tool surface.

run_shopping_discovery

Find, choose, browse, recommend, get the best product, or build a bundle from a natural-language request. The only required field is prompt.

Field	Type	Required	Notes
prompt	string	✅	Natural-language shopping intent
mode	string | null		auto | browse | recommend | best | bundle (default auto)
store	string | null		auto, a store id, or a store name/hint
country	string | null		e.g. PT, ES
currency	string | null		e.g. EUR
language	string | null		e.g. en, pt
max_results	integer | null		Cap on returned products
response_format	string | null		full (default) | simple

get_discovery_result

Retrieve a previous result by result_id. Results are temporary and may expire.

Field	Type	Required
result_id	string	✅
response_format	string | null

discover_supported_stores

Inspect the public stores Periskop can use. Returns public store capabilities only.

Field	Type	Required
country	string | null
category	string | null
capability	string | null (search | bundle | product_links)

report_result_feedback

Report whether a result was good, bad, or mixed.

| Field | Type | Req

... View full README on GitHub