Once connected, you can ask your assistant to help you with following questions:
Competitors analysis:
“What is the monetisation strategy of game A and how it differs from game B”
‘’Explain design and UI differences between events X and Y in the games A and B’’
"What are Royal Match’s top-grossing competitors in the US? Identify biggest differences between these games in terms of monetisation, engagement and audience profile”
"How do top shooter games approach their anniversary updates in terms of update size, type of content released, and measurable impact?"
Feature / Live Event analysis:
"Tell me how Whiteout Survival creates interconnection between ita live events? What type of events are often connected and how? Analyze me the past 12 months.
"Which games in Match-3 Puzzle just added a Battle Pass event? Include screenshots of how they implemented it."
"Give me the FTUE recordings for Last War: Survival — I want to see the first-time-user flow."
Data discovery:
‘’Find minigames events that have ASMR elements in their design’’
‘’ List the most popular duration of seasonable collectible albums in the puzzle genre in the last 12 months’’
‘’Identify IP collaborations that had the biggest viral effect or correlated with the visible revenue or engagement upticks’’
Your assistant decides which GameRefinery tools to call, chains multiple lookups together when needed, and returns the results in whatever format you asked for (summary, table, charts, side-by-side comparison, etc.).
What you'll need
A GameRefinery account. The same account you use for app.gamerefinery.com. You'll log in through your browser once during setup.
A supported AI assistant. Currently supported:
Claude Code (the CLI)
Claude Cowork (Claude on the web / desktop app, via custom connectors)
Cursor (via its MCP integration)
Amazon Kiro (IDE)
Other MCP-compliant clients generally work too, though setup steps vary — the same URL below is what they all connect to.
5 minutes. That's it.
You don't need to install anything from GameRefinery. The MCP server runs on our infrastructure; your assistant just connects to it.
Connecting your assistant
1) Claude Code (CLI)
Open a terminal and run:
claude mcp add gr-mcp --transport http https://services.gamerefinery.com/s/gr-mcp-server/mcp
That's it. The next time you ask Claude a GameRefinery question, it will pop open your browser once for a login. After that, you're set — Claude remembers you.
To confirm it's connected:
claude mcp list
You should see gr-mcp with a green checkmark.
2) Claude Cowork (Claude.ai on the web or desktop)
In Claude, open your workspace settings and go to Settings → Connectors → Add custom connector. Enter:
Name: GameRefinery
Save the connector. On first use, Claude will open a login window for your GameRefinery account.
If you're on a Team or Enterprise workspace, an admin can add the connector once at the workspace level and every user inherits it. On individual plans that support custom connectors, each user adds it in their own settings.
3) Cursor
Open your Cursor settings and find the MCP configuration section (usually under Settings → Features → MCP). Add a new server with:
Transport: HTTP
Cursor will open your browser to log in on first use, then remember your credentials.
4) Amazon Kiro (IDE)
In the IDE open Kiro settings (accessible by pressing CTRL + , for Windows or CMD + , for Mac) and search for MCP to enable it Settings → Search MCP → Select Enable.
Once the MCP is enabled add the configuration choose between:
User (if you want to enable it globally for all the projects) and
Workspace (if you want to enable it for the current project only)
An editor will appear, copy the following JSON (for DEVs you may change path and port of the callbackHost):
{
"mcpServers": {
"gr-mcp-prod": {
"transport": "http",
"callbackHost": "127.0.0.1:8585",
"disabled": false
}
}
}
Click on the left sidebar and select the Kiro Icon. On the bottom left you will see a list of your MCP Servers including the gr-mcp-prod. Click on the server to authenticate, a browser will open your browser to log in on first use, then the IDE will remember your credentials.
Other assistants
Any assistant that supports the Model Context Protocol standard can connect to the same URL. The URL to point at is always:
Refer to your assistant's documentation for the exact "add MCP server" flow.
First-time login
The first time your assistant tries to answer a GameRefinery question, your browser will open a GameRefinery login page. Log in with your normal account credentials.
After that, your assistant caches a login token and you won't be prompted again for several hours. Tokens refresh silently in the background. If you ever need to log in again, you'll just be sent to the same page.
What if the browser doesn't open? Some corporate networks block popup browser windows. If nothing opens, copy the URL your assistant printed in the terminal / chat and paste it into your browser manually.
What if login fails? Your GameRefinery account needs the MCP access role. If you see a message about missing permissions, contact your GameRefinery representative to have the role added.
What can you ask?
Below is the full list of things your assistant can do for you, grouped by the kind of question you're likely to ask. You don't need to memorise these — just ask in plain English and your assistant will pick the right one (or chain several together).
Discovering games and reports
Search the catalog — find any tracked game by name.
List tracked games — see every game GameRefinery is following (that your account has access to).
Top-grossing charts — the current top-grossing games in any market.
Analyst reports — search the GameRefinery report library (Reports and PDFs).
Market newsfeed — latest editorial pieces, top-chart movements, soft launches, GPS changes.
Understanding a single game
Game details — publisher, genre, GPS score, feature loadout, tags.
Motivation profile — the 12 motivation drivers + 8 player archetypes for the game.
Competitors — the competitor set GameRefinery identifies, with GPS score, ranks, and audience.
Revenue and downloads — historical estimates over time.
Active users — DAU / MAU / WAU trends.
Version history — every version, release notes, download size, and the app-store screenshots that shipped with each version.
In-game screenshots — analyst captures of the game across versions, tagged with features and concepts.
First-time user experience recordings — timed, chaptered video walkthroughs of the game's onboarding.
Comparing games
Side-by-side comparison — up to 5 games compared feature-by-feature.
Live events
Full event list — every live event a game has run in a time window.
Grouped overview — the same events organised by type and blueprint (with counts).
Event details — everything about one event: analyst commentary, motivations it targets, screenshots taken during the event, and a direct link back into the GameRefinery Live Events Tracker.
Features
Top features — the most impactful features for a market or subgenre.
Feature examples — screenshot examples of how different games implement a specific feature.
Explore feature adoption — which games in a segment ship a given feature.
Feature taxonomy — the full tag catalog (features, events, brands, concepts, and more).
Market analysis
Market share — quarterly revenue and download aggregates for a market.
Update impacts — revenue and download deltas tied to specific version updates.
Example prompts to try first
Here are a few prompts to give you a sense of the shape of answers you'll get. Copy them into your assistant verbatim to start.
Prompt 1 — a quick game overview
Give me a quick brief on Royal Match: publisher, GPS, dominant player motivations, and its top 3 competitors.
Your assistant will call two or three GameRefinery tools, stitch the results together, and give you a one-page summary.
Prompt 2 — a live-events deep dive
What live events has Clash of Clans run in the last 30 days? Group by blueprint type and, for the top three most-common event types, give me one example event with its analyst commentary.
Prompt 3 — a market comparison
Compare the top 5 grossing games in Match-3 Puzzle in the US against their motivation profiles. Which player archetype dominates the genre?
Prompt 4 — a "how did they do this" question
Show me feature examples of how top-grossing 4X strategy games implement Battle Passes. Include the screenshots and the analyst commentary on each.
Prompt 5 — a research question
I'm researching Guild PvP mechanics. Find the games that use them, show me screenshots of each implementation, and summarise what makes each version different.
Tips for good prompts
Be specific about the market and time window. GameRefinery is market-aware — say "in the US" or "over the last 60 days" if it matters.
Ask for what you want in the output, not just what you want to find. "Give me a table with columns X, Y, Z" or "Summarise in three bullets" both work.
Chain questions. Your assistant remembers context. Ask a follow-up: "Now do the same for the Japanese market."
Troubleshooting
"The tool timed out" / "server error" Try the same question again. GameRefinery's backend occasionally has slow responses, and your assistant will usually recover on a retry.
"I don't have access to that game" Your GameRefinery account only sees games your organisation is licensed to view. If you expect access to a game and don't have it, contact your GameRefinery representative.
Your assistant says it can't find a tool Restart your assistant, then try again. If the MCP connection didn't refresh, claude mcp list (or your client's equivalent) will show it as disconnected — remove and re-add:
claude mcp remove gr-mcp
claude mcp add gr-mcp --transport http https://services.gamerefinery.com/s/gr-mcp-server/mcp
Login page keeps re-appearing Clear cookies for keycloak.gamerefinery.com in your browser and try once more. If you're on a corporate VPN, temporarily disconnect and retry.
A tool returns nothing Two common causes: (1) your query is too specific (try broadening the market or time range); (2) the data genuinely doesn't exist in GameRefinery yet for the market/game you asked about.
Privacy and security
Your GameRefinery permissions are honoured. You only see data your account is licensed for. Nothing is bypassed by the MCP server.
Your login stays on your side. Your assistant handles the authentication popup and stores the token locally on your machine — GameRefinery never sees your assistant's session.
Prompts stay with your assistant provider. GameRefinery only sees the API calls your assistant makes on your behalf (the same requests the web UI would make). Whatever you typed into your assistant is between you and your assistant's provider (Anthropic, Cursor, etc.), subject to their privacy policy.
Getting help
If you run into anything the troubleshooting section doesn't cover, or you have a question about what the data means (rather than how to fetch it), reach out to your GameRefinery representative.
For questions or bug reports specifically about the MCP integration itself, contact GameRefinery support.
Last updated: July 2026. GameRefinery MCP server is under active development — new tools and improvements ship regularly, and appear in your assistant automatically without any action on your part.