Periskop
About
Open web Product Discovery for AI Agents
Details
- Author
- periskop-ai
- Categories
- Search, Knowledge Base, Other
Jump to
Setup
Install Periskop in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/periskop-ai/periskop-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
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)
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.
Periskop returns productresults and merchant links only. Itdoes 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 apurchase_boundaryblock restating this.
Unauthenticated requests receive401with aWWW-Authenticate: Bearerheader.
Note: Periskop also supports OAuth 2.1 (Authorization Code + PKCE) for hosts that prefer it (tokens look likedpo_…). API key is the simplest path and is all you need for the configs below.
All tools take a single JSON object argument. Schemas below are the public tool surface.
Find, choose, browse, recommend, get the best product, or build a bundle from a natural-language request. The only required field isprompt.
Retrieve a previous result byresult_id. Results are temporary and may expire.
Inspect the public stores Periskop can use. Returns public store capabilities only.
Report whether a result was good, bad, or mixed.
Suggest a store/merchant/marketplace Periskop should support in the future.Non-billable.Does not search or scrape the store and does not guarantee future support.
curl -sS -X POST https://mcp.periskop.ai/v1/mcp \ -H "Authorization: Bearer YOUR_PERISKOP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "run_shopping_discovery", "arguments": { "prompt": "wireless noise-cancelling headphones for travel under 200€", "mode": "best" } } }'
Response (trimmed — sample/fake data, not real)
{ "jsonrpc": "2.0", "id": 1, "result": { "content": [ { "type": "text", "text": "{\"result_id\":\"res_example_8f2a1c\",\"mode_used\":\"best\",\"products\":[{\"title\":\"SampleAudio Aero NC\",\"price\":\"€179.00\",\"currency\":\"EUR\",\"merchant\":\"Example Store\",\"url\":\"https://store.example/p/aero-nc\",\"role\":\"best_pick\"},{\"title\":\"Acme Quietline 2\",\"price\":\"€149.00\",\"currency\":\"EUR\",\"merchant\":\"Example Store\",\"url\":\"https://store.example/p/quietline-2\",\"role\":\"alternative\"}],\"caveats\":[\"Prices and availability may change on the merchant site.\"],\"purchase_boundary\":{\"checkout_created\":false,\"payment_processed\":false,\"stock_reserved\":false,\"user_must_complete_purchase_on_merchant_site\":true}}" } ] } }
The structured payload is returned as text inresult.content[0].text. Every response and theX-Request-IDresponse header carry a per-call request id.
Prepaid wallet, billed only onsuccessfuldiscovery requests. Auth errors, malformed requests, internal/runtime failures, rate limits, and hard no-match arenever billed. See the live rate athttps://periskop.ai/developer/billing.
Copy-paste configs are inconfig-snippets/: Cursor (.cursor/mcp.json), Claude Desktop, Claude Code, and a rawcurlexample.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Fetch, convert, and search AWS documentation pages, with recommendations for related content.
Search campgrounds around the world on campertunity, check availability, and provide booking links.
The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.
All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.
MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.
At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.
Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/
Research tools, including a Sqlite-backed document stash
Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.
SerpApi MCP Server for Google and other search engine results
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




