{"serverInfo":{"name":"prisma-reviews","title":"Prisma Reviews","version":"1.0.0"},"description":"Read reviews from 60+ platforms in one format and reply where the platform allows it.","instructions":"Prisma Reviews reads reviews from many platforms (Google Maps, the App Store, Google Play, Judge.me, Airbnb, Booking.com, Tripadvisor…) in one format and publishes replies where the platform allows it. list_locations gives the location ids that list_reviews and get_stats filter by. Test keys (pk_test_…) and the Test choice at sign-in return sample data. reply_to_review publishes publicly with the exact text it receives; read-only platforms return the link to answer on the platform instead.","protocolVersions":["2025-06-18","2025-03-26","2024-11-05"],"transport":{"type":"streamable-http","url":"https://api.prismareviews.com/mcp"},"authentication":{"required":true,"schemes":["oauth2","bearer"],"protectedResourceMetadata":"https://api.prismareviews.com/.well-known/oauth-protected-resource/mcp","apiKeys":"https://app.prismareviews.com/api-keys"},"capabilities":{"tools":{"listChanged":false}},"tools":[{"name":"list_locations","title":"List locations","description":"The connected locations (a business, app, shop or listing on one platform), with their id, platform, status and reference (the customer’s own id for it, like an office number). sync_status says what each is doing: queued, importing, waiting_for_reads, ready or error, with sync_status_reason, estimated_ready_at and reviews_imported. A location that is not ready yet has no reviews because its import hasn’t finished, not because something broke: tell the user its reason.","inputSchema":{"type":"object","properties":{"reference":{"type":"string","description":"Only locations with this reference (several separated by commas)."}}},"annotations":{"title":"List locations","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"list_reviews","title":"List reviews","description":"Reviews, newest first, in the same format for every platform. Filter by location(s), platform, dates, stars, a text search or whether they have a reply; filters combine. Use next_cursor for the next page. Each review carries its location_name and location_url; with q, matched_terms lists the names it matched. meta.pending_locations lists locations whose reviews haven't loaded yet (sync_status queued, importing, waiting_for_reads or error): say they are loading, not that they have no reviews. Example, reviews of the Seattle office that mention John: find its id with list_locations, then location_id=\"loc_abc\", q=\"John,Johnny\".","inputSchema":{"type":"object","properties":{"location_id":{"type":"string","description":"Only this location (from list_locations), or several ids separated by commas (up to 500): loc_a,loc_b."},"platform":{"type":"string","enum":["google","app_store","google_play","judge_me","trustpilot","google_maps","yelp","tripadvisor","booking","yotpo","reviews_io","g2","ebay","etsy","steam","okendo","feefo","trusted_shops","ekomi","loox","proven_expert","shopper_approved","wordpress","appexchange","shopify_apps","atlassian","klaviyo","woocommerce","wix","microsoft_store","junip","fera","bigcommerce","shopware","ecwid","hostaway","mercadolibre","hospitable","guesty","appgallery","vtex","mozilla","openvsx","jetbrains","beds24","thunderbird","thinkific","phorest","viator","webwinkelkeur","feedaty","lightspeed","kiyoh","verified_reviews","udemy","stamped","yext","galaxy_store","chrome_web_store","vscode","adobe_commerce","bazaarvoice","dealerrater","apple_podcasts","naver","lazada","ausgezeichnet","facebook","opentable","doordash","angi","checkatrade","avvo","capterra","apartments","gartner","healthgrades","vitals","classpass","expedia","airbnb","bbb","software_advice","deliveroo"]},"since":{"type":"string","description":"Only reviews created on or after this date."},"until":{"type":"string","description":"Only reviews created on or before this date (a date covers that whole day, UTC)."},"q":{"type":"string","description":"Search the review text and title for whole words, ignoring case and accents. Separate up to 10 terms with commas to match any of them (OR): \"John,Johnny\". A term with spaces is a phrase (\"John Smith\"). \"Ann\" does not match \"Annual\"."},"q_in":{"type":"string","description":"Where q looks, comma separated: text, title, author. Default: text,title. Add author to find reviews written by someone named like q."},"min_rating":{"type":"integer","minimum":1,"maximum":5,"description":"Only reviews with at least this many stars (reviews with no stars are left out)."},"max_rating":{"type":"integer","minimum":1,"maximum":5,"description":"Only reviews with at most this many stars."},"has_reply":{"type":"boolean","description":"true: reviews with a reply in any status (a failed one included); false: reviews with no reply at all. For reviews that still need an answer use reply_status \"none,failed\"."},"reply_status":{"type":"string","description":"Comma separated, any of: none, queued, published, failed, unknown. \"none,failed\" = still needs an answer."},"ingested_since":{"type":"string","description":"Only reviews Prisma stored on or after this time, whenever they were written: to poll for new ones without missing a late import (a newly connected office’s history)."},"include_deleted":{"type":"boolean","description":"true: also reviews Prisma found removed from the platform (they carry deleted_at)."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Page size. 20 here (the REST API defaults to 50)."},"cursor":{"type":"string","description":"next_cursor from the previous page."}}},"annotations":{"title":"List reviews","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"list_deleted_reviews","title":"List deleted reviews (Ledger)","description":"Reviews Prisma found removed from their platform during one month, with the copy it kept (text, author, stars), when it first and last saw each one, and whether it left in a mass removal. Evidence to show a client or to back a claim to the platform; Prisma can’t restore reviews.","inputSchema":{"type":"object","properties":{"month":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"The month, YYYY-MM (UTC). Default: the current month."},"location_id":{"type":"string","description":"Only this location (from list_locations)."},"platform":{"type":"string","enum":["google","app_store","google_play","judge_me","trustpilot","google_maps","yelp","tripadvisor","booking","yotpo","reviews_io","g2","ebay","etsy","steam","okendo","feefo","trusted_shops","ekomi","loox","proven_expert","shopper_approved","wordpress","appexchange","shopify_apps","atlassian","klaviyo","woocommerce","wix","microsoft_store","junip","fera","bigcommerce","shopware","ecwid","hostaway","mercadolibre","hospitable","guesty","appgallery","vtex","mozilla","openvsx","jetbrains","beds24","thunderbird","thinkific","phorest","viator","webwinkelkeur","feedaty","lightspeed","kiyoh","verified_reviews","udemy","stamped","yext","galaxy_store","chrome_web_store","vscode","adobe_commerce","bazaarvoice","dealerrater","apple_podcasts","naver","lazada","ausgezeichnet","facebook","opentable","doordash","angi","checkatrade","avvo","capterra","apartments","gartner","healthgrades","vitals","classpass","expedia","airbnb","bbb","software_advice","deliveroo"]}}},"annotations":{"title":"List deleted reviews (Ledger)","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"get_review","title":"Get a review","description":"One review by id, with its reply and the reply status.","inputSchema":{"type":"object","properties":{"review_id":{"type":"string"}},"required":["review_id"]},"annotations":{"title":"Get a review","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"reply_to_review","title":"Reply to a review","description":"Publishes a public reply to a review on its platform, through the platform’s official API, with exactly the text given. Where the platform allows editing it replaces an existing reply. Read-only platforms return reply_not_supported with the link to answer there.","inputSchema":{"type":"object","properties":{"review_id":{"type":"string"},"text":{"type":"string","minLength":1,"maxLength":10000,"description":"The reply, exactly as it will be published."}},"required":["review_id","text"]},"annotations":{"title":"Reply to a review","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"get_stats","title":"Review stats","description":"Average rating, review count, rating distribution and reply rate, for everything or one location or platform. Default period: the last 12 months.","inputSchema":{"type":"object","properties":{"location_id":{"type":"string","description":"Only this location (from list_locations)."},"platform":{"type":"string","enum":["google","app_store","google_play","judge_me","trustpilot","google_maps","yelp","tripadvisor","booking","yotpo","reviews_io","g2","ebay","etsy","steam","okendo","feefo","trusted_shops","ekomi","loox","proven_expert","shopper_approved","wordpress","appexchange","shopify_apps","atlassian","klaviyo","woocommerce","wix","microsoft_store","junip","fera","bigcommerce","shopware","ecwid","hostaway","mercadolibre","hospitable","guesty","appgallery","vtex","mozilla","openvsx","jetbrains","beds24","thunderbird","thinkific","phorest","viator","webwinkelkeur","feedaty","lightspeed","kiyoh","verified_reviews","udemy","stamped","yext","galaxy_store","chrome_web_store","vscode","adobe_commerce","bazaarvoice","dealerrater","apple_podcasts","naver","lazada","ausgezeichnet","facebook","opentable","doordash","angi","checkatrade","avvo","capterra","apartments","gartner","healthgrades","vitals","classpass","expedia","airbnb","bbb","software_advice","deliveroo"]},"since":{"type":"string","description":"Start of the period, on or after. Default: 12 months before until."},"until":{"type":"string","description":"End of the period, before this date or time. Default: now."}}},"annotations":{"title":"Review stats","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"list_connections","title":"List connections","description":"Platform accounts connected to Prisma and their status (active, pending, reauth_required…).","inputSchema":{"type":"object","properties":{}},"annotations":{"title":"List connections","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"list_platforms","title":"List platforms","description":"Supported platforms: id, name, how each connects, whether replies are supported (reply: \"read\" means read-only) and whether this account can connect it now. Pass platform for one platform’s full setup: fields, steps and an example.","inputSchema":{"type":"object","properties":{"platform":{"type":"string","enum":["google","app_store","google_play","judge_me","trustpilot","google_maps","yelp","tripadvisor","booking","yotpo","reviews_io","g2","ebay","etsy","steam","okendo","feefo","trusted_shops","ekomi","loox","proven_expert","shopper_approved","wordpress","appexchange","shopify_apps","atlassian","klaviyo","woocommerce","wix","microsoft_store","junip","fera","bigcommerce","shopware","ecwid","hostaway","mercadolibre","hospitable","guesty","appgallery","vtex","mozilla","openvsx","jetbrains","beds24","thunderbird","thinkific","phorest","viator","webwinkelkeur","feedaty","lightspeed","kiyoh","verified_reviews","udemy","stamped","yext","galaxy_store","chrome_web_store","vscode","adobe_commerce","bazaarvoice","dealerrater","apple_podcasts","naver","lazada","ausgezeichnet","facebook","opentable","doordash","angi","checkatrade","avvo","capterra","apartments","gartner","healthgrades","vitals","classpass","expedia","airbnb","bbb","software_advice","deliveroo"],"description":"Optional: the full setup of this platform."}}},"annotations":{"title":"List platforms","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"connect_locations","title":"Connect many listings","description":"Connects many listings at once from their public links (Google Maps by default: one link per office or shop), up to 100 per call (send more in several calls). Each row may carry the office name and a reference (the customer’s own id, to match and filter later). Google Maps needs owner_attestation true: only send it if the user confirmed they own or manage these businesses or are authorized by their owner. Returns one result per row (connected, already_connected or error with the reason). If the batch is bigger than the plan allows, nothing is connected and the error says how many fit and how to make room; partial true connects the ones that fit. dry_run true checks everything without connecting. Needs a full API key: a key from the MCP sign-in (OAuth) can’t connect locations, so answer insufficient_scope by asking the user to add them in the dashboard (Connections → Add many locations) or to use an API key.","inputSchema":{"type":"object","properties":{"platform":{"type":"string","description":"A platform connected with a listing link. Default google_maps."},"owner_attestation":{"type":"boolean","description":"Google Maps: the user confirmed they own or manage these businesses, or are authorized by their owner."},"locations":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"listing_url":{"type":"string"},"name":{"type":"string"},"reference":{"type":"string"}},"required":["listing_url"]}},"partial":{"type":"boolean","description":"Connect the rows that fit in the plan and report the rest. Default false: all or nothing."},"dry_run":{"type":"boolean","description":"Check every row and the plan limit without connecting anything."}},"required":["locations"]},"annotations":{"title":"Connect many listings","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_connect_link","title":"Create a connect link","description":"A link the business owner opens in a browser to connect a platform themselves (sign in with the platform, no Prisma account needed). Valid for a few days. For Google Maps the owner must tick, on that page, that they own or manage the business or are authorized by its owner.","inputSchema":{"type":"object","properties":{"platform":{"type":"string","enum":["google","app_store","google_play","judge_me","trustpilot","google_maps","yelp","tripadvisor","booking","yotpo","reviews_io","g2","ebay","etsy","steam","okendo","feefo","trusted_shops","ekomi","loox","proven_expert","shopper_approved","wordpress","appexchange","shopify_apps","atlassian","klaviyo","woocommerce","wix","microsoft_store","junip","fera","bigcommerce","shopware","ecwid","hostaway","mercadolibre","hospitable","guesty","appgallery","vtex","mozilla","openvsx","jetbrains","beds24","thunderbird","thinkific","phorest","viator","webwinkelkeur","feedaty","lightspeed","kiyoh","verified_reviews","udemy","stamped","yext","galaxy_store","chrome_web_store","vscode","adobe_commerce","bazaarvoice","dealerrater","apple_podcasts","naver","lazada","ausgezeichnet","facebook","opentable","doordash","angi","checkatrade","avvo","capterra","apartments","gartner","healthgrades","vitals","classpass","expedia","airbnb","bbb","software_advice","deliveroo"],"description":"Optional: open the link on this platform."}}},"annotations":{"title":"Create a connect link","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"complete_onboarding","title":"Complete the sign-up answers","description":"Gives the three answers every new Prisma account gives after signing up: where you heard of Prisma, the review platforms you need and how many locations or apps you have. Use it when you created or opened the account for someone. Call again to correct them. Leave origin out if you don’t know it: it is recorded as an AI agent, or keeps the one the owner already gave.","inputSchema":{"type":"object","properties":{"origin":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","copilot","other_ai","google","bing","duckduckgo","other_search","linkedin","x","reddit","youtube","tiktok","instagram","facebook","hacker_news","stack_overflow","n8n","zapier","make","mcp_directory","chatgpt_app","rapidapi","postman","product_hunt","builtbyindies","g2_capterra","github","other_directory","word_of_mouth","blog","newsletter","event","other"],"description":"Where the account owner heard of Prisma. Omit if unknown."},"origin_detail":{"type":"string","maxLength":200,"description":"Required when origin is other_ai, other_search, other_directory or other: the exact name."},"platforms":{"type":"array","minItems":1,"items":{"type":"string","enum":["google","app_store","google_play","trustpilot","yelp","tripadvisor","booking","airbnb","judge_me","shopify_apps","g2","capterra","facebook","yotpo","reviews_io","ebay","etsy","steam","okendo","feefo","trusted_shops","ekomi","loox","proven_expert","shopper_approved","wordpress","appexchange","atlassian","klaviyo","woocommerce","wix","microsoft_store","junip","fera","bigcommerce","shopware","ecwid","mercadolibre","hospitable","guesty","appgallery","vtex","mozilla","openvsx","jetbrains","beds24","thunderbird","thinkific","phorest","viator","webwinkelkeur","feedaty","lightspeed","kiyoh","verified_reviews","udemy","stamped","yext","galaxy_store","chrome_web_store","vscode","adobe_commerce","bazaarvoice","dealerrater","apple_podcasts","naver","lazada","ausgezeichnet","opentable","doordash","angi","checkatrade","avvo","apartments","gartner","healthgrades","vitals","classpass","expedia","bbb","software_advice","deliveroo","hostaway","other"]},"description":"Review platforms to connect (google is Google Business Profile). At least one."},"platforms_other":{"type":"string","maxLength":200,"description":"Required when platforms includes other: which platform."},"locations_count":{"type":"integer","minimum":1,"description":"How many locations, apps or listings."}},"required":["platforms","locations_count"]},"annotations":{"title":"Complete the sign-up answers","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_usage","title":"Plan usage","description":"Plan, locations used and allowed, requests and replies this month, and paid reads.","inputSchema":{"type":"object","properties":{}},"annotations":{"title":"Plan usage","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}}],"documentation":"https://prismareviews.com/docs/mcp","icon":"https://prismareviews.com/logo-512.png"}