Use case · Paid ads & conversion
Connect Claude, ChatGPT or Cursor to Grades.com through the MCP server or the REST API. Your agent finds the most specific reviews about a service, the themes customers repeat, the awards you hold today and the ratings each site shows, with the rules for using each one.
review_showcase3 five-star reviews about brakes since May, from Google and Facebook, as written.directory_listingGrade A- from 412 reviews, as of Nov 10.directory_badgesBest for Honesty, auto repair, Harbor Point, Fall 2026.For the page: three quotes, the grade with its date, one award with its season
Specific beats genericA review that names the service on the page says more than a row of stars. Your agent finds those reviews in seconds.
Current, or not at allGrades, awards and ratings change. Your agent checks them on the day the ad or page goes live.
The rules come with the dataWhich sites may be quoted, how an award must be worded, and what a review block may say about itself.
What your agent can do here
Each one is a sentence typed into Claude, ChatGPT or Cursor. The agent calls the Grades.com tools named under it and answers from your data.
"Give me the three most specific positive reviews about brake repair from the last 6 months, with site and date, and our current grade, for the landing page." review_showcase picks reviews by your rules (topic, lowest rating, age, sites) and returns them as written; directory_listing gives the grade and the date it was read. Yelp text is never included.
"What do customers praise most in the last 90 days, and give me two short reviews for each theme." review_insights returns the top praise and complaint themes with real review counts; review_search finds the reviews behind each one. Headlines come from what people said, not from a guess about the category.
"Do we have a Best-of placement or an award we can mention in ads? What are the exact words we may use?" directory_badges lists the awards and places you hold now, each marked current or past, with the badge terms; directory_listing adds your Best-of standing. An award is named with its season and the group it was compared with, never shortened.
"Our ads for all five locations say 4.7 on Google. Which ones no longer match before we send traffic to them?" locations_compare and review_stats give the average and count we hold per location and site; source_health says when each site was last read in full. Check the site itself on launch day.
"How many new reviews did we get per month before, during and after the spring brake campaign, and on which sites?" review_stats returns the monthly trend and reviews_summary_period one period in detail, per site and per star. It counts reviews, not sales; judge the campaign with your own conversion data.
Connect it once
Add the MCP server to Claude, ChatGPT or Cursor and sign in, or give your landing-page builder a scoped API key. Webhooks tell it when a review lands. No AI client? Ask Grades, the assistant in your dashboard, answers the same questions.
MCP server https://mcp.grades.com/mcp
REST API https://app.grades.com/api/v1
Scopes reviews:read, companies:read; nothing here needs to write
ChatGPT custom connectors need a Business, Enterprise or Edu plan
Proof you may use
Your grade, the awards you earn each season and your Best-of places, as one line of HTML that keeps itself current; an ended award turns into "Past award". In an ad, press or email, a grade or rank may be used only while it is current, with the date shown. Regulated professions check their own rules first.
Badges →Real reviews picked by your rules, never edited, never Yelp text, with no heading about how they were picked and no average, and always a link to all your reviews. A widget's caption may not say "all our reviews", "verified", "#1", "best" or "top rated".
Review Showcase →Monthly rankings by category and place on the Grades.com directory that nobody can pay into. Places 1 to 10 of a published ranking get a badge; preview rankings never do.
Reviews customers leave on Grades.com that you choose to feature carry the label "Selected by the business" and never count in your grade. Showcases and widgets never use that label: they show a selection and link to everything.
What we do not do
We do not send reviews to Google for seller ratings or any other ad feature, and we cannot change the stars Google shows.
We show reviews, ratings, themes and awards. We publish no conversion figures and promise no lift; test it on your own pages and judge it with your own data.
Insights →We show what ChatGPT, Gemini, Perplexity and Claude say about you and which sites they cite, dated.
AI Reputation →What we can and cannot do. Nobody controls what an assistant says, and we never promise to change an answer. We show what it says, where it got it, and the day it changes.
What the PPC and CRO team gets
Each one runs per location, in the dashboard and through the MCP server and the API.
| Deliverable | Product | MCP tools | Plans |
|---|---|---|---|
| Reviews picked by rule for a page, as written, with a block that keeps itself current | Review Marketing | review_showcase, review_showcase_save | Every plan: up to 10 reviews per showcase on Starter, 25 on Pro, 50 on Premium |
| Your grade, current awards and Best-of places, with the badge terms | Review Marketing | directory_badges, directory_listing | Every plan; the grade badge from a B |
| Praise and complaint themes, review velocity and ratings per site | Insights | review_insights, review_stats, review_search | Every plan: Google on Starter, every site from Pro |
| The ratings AI assistants quote, checked against your reviews | AI Reputation | ai_perception | Every plan: monthly on Starter, weekly on Pro, daily on Premium |
| A review page and QR code per location, the same ask for everyone | Review Generation | review_page_get, review_request_stats | Every plan; request campaigns on Premium |
Yes, while it is current on the day the ad runs, with the date shown. Name an award as the badge reads it, with its season and the group it was compared with, and never present a past award as current. Lawyers, doctors, dentists and other regulated professions check their own advertising rules first.
No. We do not send reviews to Google for any ad feature, and we cannot change the stars Google shows. Those come from Google's own sources.
It shows the reviews that match your rules, such as five stars about one service, never edited, with no average and a link to all of them, so it is never presented as every review you have.
Not through Grades.com. Yelp's terms keep its review text on Yelp, so showcases and widgets leave it out. Check each site's terms before you quote a review anywhere else.
We do not promise that or publish figures on it. Test it on your own pages: your agent can pull a new set of reviews for each variant in a minute.
Product names and logos are trademarks of their owners; no endorsement implied.