Connect an agent

One-time setup · OAuth

Point Claude — or any MCP-capable agent — at your Collected Games account and it can search the catalog, manage your collection, and score recommendations for you.

Server address

https://collected.games/mcp

Every client below talks to this one address. Signing in happens in your browser — you approve the scopes on a consent screen; there are no keys to paste.

Pick your client

Claude recommended

On a phone? Add this from a computer, on claude.ai or in Claude Desktop. It then works in the Claude app on your phone too.

Open Add custom connector in Claude — it opens with the name Collected Games and the server address filled in.
Check both, then click Add.
Click Connect on the new Collected Games row, sign in, and approve the scopes.

If the form opens empty, go to Customize → Connectors in Claude, choose Add custom connector, name it Collected Games, and paste the server address above.

Works on every Claude plan (Free allows one custom connector). Connectors added on claude.ai also work in Claude Desktop and on mobile.

Claude Code

claude mcp add --transport http collected-games https://collected.games/mcp

Then run /mcp inside the session and pick Authenticate — the browser handles sign-in. Headless or CI use can pass an API token as an Authorization header instead.

Cursor

Add to Cursor

One click installs the server; approve the sign-in prompt Cursor opens afterwards.

VS Code

Add to VS Code

Requires Copilot agent mode. One click installs the server; VS Code walks the same sign-in flow.

ChatGPT

In ChatGPT’s settings, enable Developer mode (currently under Apps → Advanced settings).
Under Apps, choose Create, name it Collected Games, paste the server address above (authentication: OAuth), and sign in when asked.
Select Collected Games from the + menu, or @mention it, in the message that needs it — the selection lasts one message, so mention it again when a follow-up needs fresh data.

Adding to your collection needs a ChatGPT Business, Enterprise or Edu workspace. Pro connects read-only: ChatGPT can search the catalog and read your collection but not change it. Developer mode is web-only.

Gemini CLI

gemini mcp add -s user --transport http collected-games https://collected.games/mcp

Then run /mcp auth collected-games inside the session — the browser handles sign-in. Headless or CI use can pass an API token as an Authorization header instead.

Anything else

Any client that speaks MCP over streamable HTTP with OAuth — Perplexity, Le Chat, Goose, Raycast — just needs the server address above.

Scripts and agents that cannot open a browser authenticate with an API token against the same endpoint or the REST API. (claude.ai and Claude Desktop do not accept pasted tokens — use the OAuth flow above for those.)

Try it

Once connected, ask your agent something like:

Going deeper? Download the Collected Games agent skill — the tool reference, collection workflows, and recommendation methodology in one loadable package.

Manage or revoke access any time from Connected agents.

iPhone Shortcut

Siri doesn’t connect to MCP servers, so it can’t use the connection above. It can run a Shortcut, though, and a Shortcut can add a game to your collection with one call to the REST API: send a title, and optionally a platform, and Collected Games finds the game and adds it.

Set it up

Create a token with the iPhone Shortcut preset. It ticks catalog:read and collection:write, the two scopes adding a game needs. Copy the token when it appears: it is shown only once.
In the Shortcuts app, make a new shortcut and give it a name you can say, such as Add to Collected Games.
Add an Ask for Input action that asks “Which game?”. To name the platform as well, add a second one that asks “Which platform?”.
Add a Get Contents of URL action with:
- URL:
  https://collected.games/api/v1/collection/quick-add
- Method: POST
- Headers: Authorization, with the value Bearer YOUR_TOKEN — your token in place of YOUR_TOKEN.
- Request Body: JSON, with a title field set to the game answer and, if you asked for one, a platform field set to the platform answer.
Add Get Dictionary Value for the key spoken, then Speak Text to hear the result.

To run it, say “Hey Siri” and the shortcut’s name. The shortcut then asks which game, so the game comes in a second step rather than in the first sentence. Answering with the title and platform together (“Hades II on Switch”) needs an action that splits them, such as Use Model (iOS 26 or later, with Apple Intelligence); on any other iPhone, ask the two questions separately.

What comes back

Every successful answer has an outcome and a spoken sentence written to be read aloud, such as “Added Hades II on Nintendo Switch to your collection.” The game is added only on a confident match:

added — done; spoken says what was filed.
ambiguous — more than one game fits, the closest match isn’t exact, the platform name matches no catalog platform, or the catalog doesn’t list the game on that platform. Nothing is added; candidates lists the games, and a Choose from List step can send the one you pick back as game_id, with platform again.
unmatched — nothing in the catalog resembles the title. Nothing is added.
conflict — you already own a copy (for a wishlist or former add, any entry for the game counts): on the platform you named, or on any platform if you named none. Nothing is added. A game on your wishlist is moved into your collection instead, and a copy you used to own is added again beside it.

A status field of wishlist or former files the game that way instead of as owned. The REST API reference has the full contract.

An expired or revoked token, or a rate limit, gets an error with no spoken, so if the shortcut says nothing, check its token on API tokens.

Matching runs on the server, so a change to it needs no change to your shortcut. To stop the shortcut, revoke its token on API tokens, where the preset names it iPhone Shortcut.