Integration · Marketing

Connect Claude & ChatGPT to Grade.us

Ask your AI how a location's rating has moved, which review sites bring in the most reviews, or how your email and SMS review requests are doing. It reads your Grade.us profiles, reviews, ratings and campaign stats, and can create profiles, add review site links and add recipients to a profile's review-request list.

Connect Grade.us free

Free plan, no credit card. Takes about a minute.

Try asking

“How has our Aarhus location's rating developed over the last six months?”
The AI finds the profile and returns its rating trend and review counts for the last six months.
“Which review sites do our reviews come from?”
It shows how the profile's ratings are spread across review sites.
“How are our email and SMS review requests performing?”
It gets the all-time email and SMS campaign stats for the profile.

What your AI can do

Reviews and ratings

List reviews, see average rating, star breakdown, ratings by review site and six-month trends per profile.

Review requests

Add recipients to a profile's review-request list, look up recipients, and read email and SMS campaign stats.

Profiles and links

Create review profiles, add and rename review site links, and see an activity summary across the account.

“Add these five customers from today's appointments to the review-request list.”
It adds the recipients to the profile with first name, last name, email address and optional tags.
“Show me the reviews and the star breakdown for our main profile.”
It lists the reviews for the profile and shows how they spread across 1 to 5 stars.
“Set up a new profile for our Odense shop with a Google review link.”
It checks the existing profiles, creates the new profile and adds the review site link you give.

21 tools for Grade.us

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_recipientsChanges dataAdd recipients to a profile's review-request list: profile_id plus recipients with first_name, last_name, email_address and optional tags.
add_review_linkChanges dataAdd a review site link (url) to a profile by profile_id.
create_profileChanges dataCreate a new review profile with a name. Check list_profiles first to avoid duplicates.
get_account_activity_summaryGet an activity summary across all profiles in the account.
get_average_ratingGet a profile's overall average star rating by profile_id.
get_email_campaign_statsGet all-time email review-request campaign stats for a profile by profile_id.
get_profileGet one review profile by profile_id.
get_rating_last_six_monthsGet a profile's rating trend over the last six months by profile_id.
get_ratings_by_siteGet how a profile's ratings are spread across review sites, by profile_id.
get_ratings_by_starGet how a profile's reviews are spread across 1 to 5 stars, by profile_id.
get_recipientGet one recipient on a profile by profile_id and recipient_id.
get_review_countGet the all-time number of reviews for a profile by profile_id.
get_reviews_last_six_monthsGet a profile's review counts over the last six months by profile_id.
get_sms_campaign_statsGet all-time SMS review-request campaign stats for a profile by profile_id.
get_userGet one user by user_uuid.
list_profilesList the review profiles (businesses or locations) in the account. Use a profile_id from here in other tools.
list_recipientsList the review-request recipients on a profile by profile_id.
list_review_linksList the review site links on a profile by profile_id.
list_reviewsList the reviews collected for a profile by profile_id.
list_usersList the users on the account.
update_review_linkChanges dataChange the title of a review site link by profile_id and link_id.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Grade.us from the app list.
2
Paste your key
Paste the Grade.us API token for your master user. It is sent as-is in the Authorization header. The public Grade.us docs do not say where the token is shown in the app, so contact Grade.us support if you cannot find it.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Grade.us?

It can read profiles, reviews, review counts, average rating, ratings by star and by site, six-month trends, email and SMS campaign stats, recipients, review links, users and an account activity summary. It can create profiles, add review site links, rename them and add recipients.

Does the AI see my Grade.us API token?

No. Your Grade.us API token is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reporting only. Adding recipients puts people on a review-request list, and that and the other write tools can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Grade.us account.

Where do I find my Grade.us API token?

Grade.us API V4 uses the API token of your master user. The public docs do not say where the token is shown in the app, so if you cannot find it, ask Grade.us support for it.