Use case · Websites
Connect Claude, Cursor or your build pipeline to Grades.com through the MCP server or the REST API. Your agent pulls the business's public reviews with site, date and rating, and turns them into a reviews page, service-page quotes and a launch checklist. Every quote stays word for word.
review_tags_listService tags: roofing (118 reviews), gutters (41), siding (27).review_showcase25 reviews per service from Google and Facebook, with Review markup.review_feed_urlsA JSON Feed for the newest-reviews block at the top.Page: three sections, Review markup, a link to all reviews
Real reviews, not a screenshotPulled live with site, date and rating, so the page is not out of date the month after launch.
Built in your designJSON, HTML, Markdown or schema.org markup: your agent writes the page your way, or drops in a ready block.
The rules come with the dataText never edited, no Yelp text in a showcase, widget or feed, and a link to all reviews on every block.
What your agent can do here
Each one is a sentence typed into Claude, Cursor or ChatGPT. The agent calls the Grades.com tools named under it and builds from the business's own reviews.
"Pull every public review with site, date and rating, group them by service, and generate the /reviews page with schema from our API." The agent reads the service tags with review_tags_list, builds each section with review_showcase (JSON plus HTML, Markdown or JSON-LD), and writes the build step against the public reviews API, so the page refreshes on every deploy.
"Find three reviews that talk about gutter work, four stars and up, and save them for the gutters page." review_showcase picks them by tag or topic, review_showcase_save saves the rules after you confirm, and review_showcases_list returns the script tag, iframe or WordPress shortcode. Text is never edited; a review too long for the block is left out, not cut.
"Check every rating and review count typed into the new site against the live numbers on each review site." review_stats returns ratings and counts per site and directory_listing the public profile's. The agent lists every number on the page that no longer matches and suggests a live summary in its place.
"Give me the launch checklist: badges, the review widget, schema and the review page link for the footer." directory_badges returns the embed code for each badge a claimed profile holds, review_widget the one-line script for a layout, review_page_get the review page link and QR code, and review_feed_urls the RSS and JSON Feed addresses.
Connect it once
Add the MCP server to Claude, Cursor or ChatGPT and sign in. Give the site a publishable key for the public reviews API: it reads only the reviews the business shows, so it can sit in page code. Webhooks tell your pipeline 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
On the page /api/v1/public/reviews?key=gk_pub_...&limit=50
A publishable key only reads reviews the business shows
Showcase, widget or API
The business's own reviews picked by rules: how many, lowest rating, a service tag or topic, which sites, how recent. As JSON, HTML, Markdown or schema.org markup, or embedded with a script tag, an iframe or a WordPress shortcode. The same rules always give the same reviews.
Review Showcase →Fixed layouts, from a one-line rating pill to a carousel, a grid, a lobby wall and a floating badge. Light or dark, one accent colour, English or Spanish. Pick one, paste one line.
Review Marketing →Your own markup from JSON: reviews with site, rating, text, author and date, paged with a cursor, plus a rating summary per site. RSS, Atom and JSON Feed for no-code tools.
Developers →Labels, links and markup
It belongs to Reviews on Grades.com that a business features in curated mode, on its public list and in the public reviews API; featured reviews never count in the grade. Showcases and widgets carry no such label and no note on how reviews were picked. Every one links to all of the business's reviews instead.
Every widget carries one followed link, "Reviews on grades.com", to the business's profile. A showcase's links to each review are nofollow. On the directory, a link to the business's website is nofollow until the owner claims and verifies the profile.
The directory profile has no AggregateRating markup, and a showcase's markup is an ItemList of Review items without one. The public summary endpoint returns an AggregateRating object from the business's own reviews, for its own page if you choose. Google treats ratings a business shows about itself as self-serving, so do not expect stars in search.
Yelp's terms restrict republishing its reviews, so showcases, widgets and feeds show Yelp as a rating, a count and a link, never text. Reviews with an email address, phone number or link are left out of every block, and so are treatment terms on a healthcare site.
Review rules →What the web team gets
Each one runs per location, in the dashboard and through the MCP server and the API.
| Deliverable | Product | MCP tools | Plans |
|---|---|---|---|
| Reviews pages, service blocks, widgets and badges that keep themselves current | Review Marketing | review_showcase, review_showcase_save, review_widget, directory_badges | Every plan: up to 10 reviews per showcase on Starter, 25 on Pro, 50 on Premium |
| Every review with site, date and rating, including ones a site takes down, with exports | Review Archive | review_list, review_history, reviews_export_csv | Every plan |
| Review pages about the business that the new footer does not link to yet | Review Radar | radar_mentions | Weekly search on Pro and Premium |
| Ratings and counts per site for the page, and praise themes for the copy | Insights | review_stats, review_insights | Every plan: Google on Starter, every site from Pro |
| The public reviews API, feeds and webhooks for your own build | Developers | review_feed_urls | Every plan; signed webhooks from Pro |
Yes. The public reviews API returns JSON for your own markup, and a showcase returns HTML, Markdown or schema.org markup you can restyle. Widgets are the no-code option when a page builder allows only a script tag or an iframe.
Do not count on it. Google treats reviews and ratings a business shows about itself as self-serving and gives them no review stars. The markup is valid and describes the page to search and answer engines; the directory profile adds no rating markup at all.
One review at a time, from the dashboard, after a confirm. It stays on its site, on the Grades.com profile and in the rating, and new reviews are never hidden automatically. Every widget and showcase links to all of the business's reviews.
As a rating, a count and a link. Yelp's terms restrict republishing its reviews outside Yelp, so no showcase, widget or feed shows Yelp text. The public reviews API returns Yelp reviews as a rating and a link only, never the text, so a build that lists quotes should skip items whose text is empty.
It gives them current facts to read, nothing more. AI Reputation shows what assistants say about the business and which sites they cite, and we never promise to change an answer.
Product names and logos are trademarks of their owners; no endorsement implied.