The GameRefinery MCP server connects your AI assistant (Claude, Cursor, or any other MCP-aware tool) to your GameRefinery account. Instead of clicking through the web UI to find a game's live events, GPS score, or competitor set, you can ask your assistant — and it pulls the answer from GameRefinery for you, using your account, with your permissions.
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.
Connecting your assistant
⚠️ Important — GameRefinery is a private connector. It will not appear if you search Claude's or Cursor's built-in connector directory. You can add it manually following the steps below. The URL every assistant connects to is always: https://services.gamerefinery.com/s/gr-mcp-server/mcp
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 on the web
Claude Cowork and Claude on the web (claude.ai) connect through a custom connector in your settings — there is no config file to edit here.
In Claude, open Settings → Connectors → Add custom connector.
Enter:
Name: GameRefinery
Save. 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) Claude Desktop
There are two ways to add GameRefinery. The custom connector (UI) is easiest; the config file (JSON) is for users who prefer editing the config directly.
Method A — Custom connector (UI)
Open Claude Desktop, then go to Settings → Connectors → Add custom connector.
Enter:
Name: GameRefinery
Save. On first use, Claude will open a browser window to log in to your GameRefinery account.
{
"mcpServers": {
"gr-mcp": {
"command": "npx",
"args": ["mcp-remote", "https://services.gamerefinery.com/s/gr-mcp-server/mcp"]
}
}
}Method B — Config file (JSON)
In Claude Desktop, go to Settings → Developer → Edit Config. This opens the file claude_desktop_config.json.
Add the gr-mcp entry below. If the file already has an mcpServers block, merge this entry into it rather than adding a second mcpServers:
{
"mcpServers": {
"gr-mcp": {
"command": "npx",
"args": ["mcp-remote", "https://services.gamerefinery.com/s/gr-mcp-server/mcp"]
}
}
}Save the file, then fully quit and reopen Claude Desktop. On first use it will open a browser window to log in.
The config-file method connects through a small helper called mcp-remote, which bridges Claude Desktop to our remote server and handles the browser login. It requires Node.js installed (which provides the npx command). If you don't have Node.js, use Method A instead.
4) Cursor
There are two ways to add GameRefinery — through the settings UI, or by editing Cursor's mcp.json config file directly. Both end up in the same place.
Method A — UI
Open Cursor Settings → Tools & MCP (in some versions this is Settings → Features → MCP).
Click Add custom MCP / New MCP Server — this opens your mcp.json file.
Paste the JSON from Method B below, then save.
Method B — Config file (JSON)
Open (or create) your Cursor MCP config file:
~/.cursor/mcp.json — enables GameRefinery in all projects, or
.cursor/mcp.json inside a project folder — enables it for that project only.
Add:
{
"mcpServers": {
"gr-mcp": {
"url": "https://services.gamerefinery.com/s/gr-mcp-server/mcp"
}
}
}3. Save. Cursor picks it up automatically and will open your browser to log in on first use, then remember your credentials.
5) 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",
"url": "https://services.gamerefinery.com/s/gr-mcp-server/mcp",
"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.
6) ChatGPT
ChatGPT connects to GameRefinery through a custom connector in Developer Mode (currently a beta feature).
Before you start
You need a paid ChatGPT plan — Plus, Pro, Business, Enterprise, or Edu. Custom MCP connectors are not available on the free tier.
On Business / Enterprise / Edu workspaces, a workspace admin must allow Developer Mode (or allowlist this connector) before you can add it.
GameRefinery will not appear in ChatGPT's built-in connector list — you add it manually using the URL below.
Step 1 — Enable Developer Mode
Open ChatGPT and go to Settings, then the Connectors area (this may be labelled Connectors, Apps & Connectors, or Plugins depending on your version).
Open Advanced settings and toggle on Developer Mode.
Step 2 — Add the GameRefinery connector
In the connectors / plugins area, click the ＋ (Add / Create) button to add a new connector.
Fill in:
Name: GameRefinery
MCP server URL: https://services.gamerefinery.com/s/gr-mcp-server/mcp
Authentication: OAuth
(Description and icon are optional.)
Click Create / Save.
Step 3 — Log in
You'll be redirected to the GameRefinery login page. Sign in with your normal account credentials and approve access. ChatGPT then returns with the connector connected.
Using it
Enable the GameRefinery tools you want available, then ask your questions in a normal chat. In Developer Mode, ChatGPT will ask you to confirm each tool call before it runs — this is expected. GameRefinery's tools are read-only (they only fetch data), so it is safe to allow them.
Heads-up: Developer Mode is a beta, and the exact menu wording changes from time to time — the labels above may look slightly different in your version of ChatGPT. If a name doesn't match, look for Connectors / Plugins, Developer Mode, and the ＋ / Add button to create a custom connector.
7. ChatGPT (Browser)
From the ChatGPT console open Settings → Security and login → Developer mode.
Open ChatGPT Plugins.
Click +.
Name it GameRefinery and add its public HTTPS URL, including /mcp: https://services.gamerefinery.com/s/gr-mcp-server/mcp
Create the connection and review the discovered tools.
Start a new chat and enable it from the tools menu.
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.
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.