Prisma Reviews API
透過一個 API 閱讀並回覆來自 84 個平台(Google Maps、Airbnb、Booking、App Store、Viator 等)的評論。允許的情況下,透過各平台的官方 API 回覆;其餘平台僅供讀取。
託管 MCP 伺服器
npx add-mcp 'https://api.prismareviews.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Open in…
Reviews MCP server
Prisma has a remote MCP server, so AI assistants such as Claude, Cursor and VS Code can use the Prisma Reviews API directly. Ask in plain language (“which 1- and 2-star reviews did we get this week?”, “reply to Laura’s review thanking her”) and the assistant calls Prisma for you, with your own API key.
- In Claude’s connector directory: Prisma Reviews is listed as a community connector at claude.ai/directory/prisma-reviews, so claude.ai users can add it from Connectors in one click. Also in the MCP Registry as
com.prismareviews/reviews. - URL:
https://api.prismareviews.com/mcp(Streamable HTTP) - Auth: sign in with your Prisma account (OAuth, for ChatGPT, claude.ai and other connector screens), or send your API key as
Authorization: Bearer <key>(orX-API-Key: <key>where a gateway reservesAuthorization). A test key (pk_test_…), or choosing Test when you sign in, returns sample data from every platform, so you can try it without connecting anything. - Cost: none on top of your plan. Each tool call is one API request and counts like any other.
New to MCP? Reviews MCP explains what the server does, with prompts that work and the platforms open today.
Prisma doesn’t write replies. The assistant you use drafts them, and Prisma publishes exactly the text it receives, through each platform’s official API. Check a reply before you let the assistant publish it.
Tools
| Tool | What it does | API route |
|---|---|---|
list_locations | Connected locations (a business, app, shop or listing on one platform), with your own reference and sync_status (queued, importing, waiting_for_reads, ready or error, with its reason); filter by reference | GET /v1/locations |
list_reviews | Reviews, newest first; filter by one or several locations, platform, date range, stars, reply status or a text search (q, whole words, commas for OR: “reviews of the Seattle office that mention John” is location_id + q: "John,Johnny"; each review says which names it matched in matched_terms; see reviews per employee; 20 per page unless you pass limit, where the REST API returns 50) | GET /v1/reviews |
list_deleted_reviews | Reviews found removed from their platform in one month, with the copy Prisma kept (Ledger) | GET /v1/deleted |
get_review | One review with its reply | GET /v1/reviews/{id} |
reply_to_review | Publishes a reply on the platform | POST /v1/reviews/{id}/reply |
get_stats | Average rating, counts, distribution and reply rate | GET /v1/stats |
list_connections | Connected platform accounts and their status | GET /v1/connections |
list_platforms | Every platform, whether it supports replies and how to connect it | GET /v1/platforms |
connect_locations | Connect many listings at once from their links (Google Maps by default), with each office’s name and your own ID; one result per row | POST /v1/connections/batch |
create_connect_link | A link the business owner opens to connect a platform | POST /v1/connect_links |
get_usage | Plan, locations, requests and paid reads this month | GET /v1/usage |
complete_onboarding | The sign-up answers for a new account: where you heard of Prisma, the platforms you need and how many locations | PUT /v1/onboarding |
Results are the same JSON as the API reference. Errors come back as tool errors with the API’s error codes. Read-only platforms (Yelp, Tripadvisor, Booking.com…) return reply_not_supported with the link to answer on the platform.
The same tool list, with their input schemas, is public at https://api.prismareviews.com/.well-known/mcp/server-card.json, for directories and agents that check the server before signing in. The server itself asks for a sign-in or an API key.
Set up
ChatGPT, claude.ai and other apps with “Add connector”
No key needed: add a custom connector with the URL https://api.prismareviews.com/mcp. The app sends you to Prisma to sign in, you choose Live (your real accounts) or Test (sample data) and click Allow. The connection appears in your API keys as ” (MCP)”; revoke it there to disconnect.
- claude.ai: Settings → Connectors → Add custom connector.
- ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode, then Create (custom connectors depend on your ChatGPT plan).
With an API key
Clients that take a header use your key instead. Get one in the dashboard. Start with the test key, then switch to the live one.
Claude Code
claude mcp add --transport http prisma-reviews https://api.prismareviews.com/mcp --header "Authorization: Bearer pk_test_YOUR_KEY"
Cursor
In ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"prisma-reviews": {
"url": "https://api.prismareviews.com/mcp",
"headers": { "Authorization": "Bearer pk_test_YOUR_KEY" }
}
}
}
VS Code
In .vscode/mcp.json:
{
"servers": {
"prisma-reviews": {
"type": "http",
"url": "https://api.prismareviews.com/mcp",
"headers": { "Authorization": "Bearer pk_test_YOUR_KEY" }
}
}
}
Claude Desktop
Claude Desktop connects to remote servers with a header through mcp-remote (needs Node.js). In Settings → Developer → Edit config:
{
"mcpServers": {
"prisma-reviews": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.prismareviews.com/mcp", "--header", "Authorization:${PRISMA_AUTH}"],
"env": { "PRISMA_AUTH": "Bearer pk_test_YOUR_KEY" }
}
}
}
Restart Claude Desktop and Prisma’s tools appear in the tools menu.
Any other client
Send JSON-RPC 2.0 with POST to the URL, with the Authorization header. The server is stateless and answers with application/json (no SSE stream, no session id), and supports protocol versions 2025-06-18, 2025-03-26 and 2024-11-05.
curl https://api.prismareviews.com/mcp \
-H "Authorization: Bearer $PRISMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_reviews","arguments":{"has_reply":false,"limit":5}}}'
Things to ask
- “Summarize what customers complained about in our App Store reviews this month.”
- “List the reviews without a reply, worst first.”
- “Draft a reply to the latest 2-star review. Show it to me before publishing.”
- “What’s our average rating per location this quarter?”
Limits
The MCP server uses your plan’s rate limit, locations and paid reads, exactly like the REST API. Tools that sign in to a platform with OAuth (eBay, and Google Business Profile and Trustpilot once each approves Prisma’s access) need a browser: use create_connect_link and open the link, or connect from the dashboard.