Claude
How did all our locations do last month?
58 new reviews, average 4.6. Eastside dipped to 4.3 on wait times.
9 reviews need a reply
Grades.com Reviews MCP
Add one address and your AI answers from every review you have, then drafts the reply, the report or the ad and posts what you approve.
Claude, connected to Grades.com
Which reviews from this week still need a reply?
Two: a 2-star review on Google and a 1-star review on Facebook. I drafted a reply to each.
2 replies ready
Ask
Type it the way you would say it. Your AI does the work from your own reviews, across all your sites and locations.
Claude
How did all our locations do last month?
58 new reviews, average 4.6. Eastside dipped to 4.3 on wait times.
9 reviews need a reply
ChatGPT
Write ad headlines from our 5-star reviews.
"The Price They Quoted", "Same-Day Oil Changes" and "They Explain Every Repair".
From 30 reviews
Cursor
Put our newest 5-star reviews on the homepage.
Done. The homepage shows your six newest 5-star reviews and stays current.
Showcase added
Act with your approval
Ask for a reply and your AI writes it in your voice. Say yes and it posts the reply on Google, from the chat you already have open.
Claude
Looks good. Post it.
Done. Your reply to Dana's 2-star review at Eastside is live.
Posted on Google
AI approvals
Grades.com AI drafts a reply to every new review. Ask your AI what is waiting, change a line and approve the ones you like.
Approve the two 5-star draftsPosted
Shorten the reply to DanaPostedWhat it covers
Everything you do in the dashboard, your AI can do in the chat, for every location and every client you manage.
Every review from every site, by rating, location, topic or service, quoted with its site and date.
Drafts in your voice, posting the ones you confirm, and reports for reviews that break a site's rules.
What is waiting in AI approvals, the voice, the rules and who approves.
What ChatGPT and Gemini say about you, and where you lead on your Competitor Map.
Your review page and QR code, website widgets, showcases and Social Posts.
Agencies ask across all the businesses they manage, or one at a time.
Setup
https://mcp.grades.com/mcp
Choose all your businesses or only some.
"Which reviews still need a reply?"
Set up grades.com in this assistant. 1. Add the grades.com MCP server: https://mcp.grades.com/mcp (Streamable HTTP, OAuth 2.1). Sign in to grades.com when prompted and approve the scopes it asks for. 2. If this client cannot do OAuth, use an API key from https://my.grades.com/connect as a Bearer token instead. 3. Once it is connected, call plan_overview, then reviews_summary_period for the last 30 days, then agent_actions and dispute_cases. 4. Show me what needs my attention: pending approvals, new negative reviews and open Review Disputes cases. Docs: https://www.grades.com/developers
https://mcp.grades.com/mcp and click Add.Tested on ChatGPT Plus on the web: reading and drafting. ChatGPT asks before anything that changes something; posting replies from ChatGPT was not part of our test. Setup and FAQ
Add a server in Cursor Settings under MCP, or put this in ~/.cursor/mcp.json, then click the server to sign in:
{ "mcpServers": { "grades": { "url": "https://mcp.grades.com/mcp" } } }Run this, then type /mcp, pick grades and choose Authenticate:
claude mcp add --transport http grades https://mcp.grades.com/mcp
Create a secret key for all your businesses in Reviews MCP in your dashboard, put it in GRADES_API_KEY and add this under mcpServers in ~/.gemini/settings.json:
"grades": { "httpUrl": "https://mcp.grades.com/mcp", "headers": { "Authorization": "Bearer $GRADES_API_KEY" } }Start gemini in a folder you trust and check that /mcp list shows grades Connected. Setup and FAQ
Any client that connects to a remote MCP server with OAuth 2.1 uses the same sign-in. An agent that cannot open a browser sends a secret API key instead:
Authorization: Bearer gk_live_...
Trust
For developers
The MCP tools and the REST API read and write the same reviews with the same scopes, and an OAuth token works on both.
A standard way for AI assistants such as Claude and ChatGPT to use another app. Add the Grades.com address once, sign in, and your AI can read your reviews and act on them with your own Grades.com access.
Your AI posts a reply only when you confirm the exact text. Replies post on Google; for other sites you get the text and a link to paste it.
Claude.ai, Claude Desktop, Claude Code, Cursor and ChatGPT, Gemini CLI with a secret API key, and any client that connects to a remote MCP server. ChatGPT is tested on ChatGPT Plus on the web. Agents that cannot sign in use a secret API key.
What you can see, in the businesses you choose when you sign in. It signs in through Grades.com, so it never gets your password, and a Yelp review comes with its rating, date and link, without its words. The Security page has the details.
Every plan, from Starter, and reading and asking are unlimited on every plan. Replies your AI posts through Grades.com: 5 a month on Starter, every review on Pro and Premium. Starter covers Google reviews, Pro and Premium every site; webhooks and the automation platforms come with Pro and Premium.
14-day free trial of Pro, no card needed.