MCP server
Manual setup
Choose your client below. Each guide adds the server address, signs you in with your Betteria account, and checks the connection.
The server address is https://betteria.app/mcp
On this page
Choose your client
Cloud-hosted connectors are not available yet
Clients running on your own computer — Claude Code, Codex, Cursor, VS Code, Gemini CLI — connect today. Connectors that run on a provider's servers, such as ChatGPT's and Claude's custom connectors (on claude.ai and in the Claude apps), call from data-centre addresses, which Betteria's bot protection currently challenges. Enabling them is in progress; until then, use a client that runs locally.
Anthropic's command-line coding agent. One command adds the server.
Add the server
In a terminal, run:
Terminalbash claude mcp add --transport http betteria https://betteria.app/mcpChoose where it is saved (optional)
By default the server is added for you in the current project only. Add --scope user to use it in every project, or --scope project to share it with your team through the project's .mcp.json:
.mcp.jsonjson { "mcpServers": { "betteria": { "type": "http", "url": "https://betteria.app/mcp" } } }Sign in and approve
Start Claude Code, type /mcp and choose betteria. Claude Code opens Betteria in your browser: sign in with your Betteria account and approve access. Run claude mcp list afterwards to see it connected.
Claude's custom connectors are added in its settings — the same on claude.ai — and called from Anthropic's servers rather than from your computer, so the note above applies for now.
Open Connectors
In Claude's settings, open Connectors. On Team and Enterprise plans an owner adds connectors from the organisation's settings.
Add a custom connector
Choose Add, then Add custom connector. Name it Betteria, paste the address, set authentication to Sign in now, and add it.
Remote MCP server URLtext https://betteria.app/mcpSign in and approve
Claude opens Betteria. Sign in with your Betteria account and approve access.
OpenAI documents adding a custom MCP server to ChatGPT as a plugin. The steps and the plans that include it change, so follow OpenAI's documentation. Its connectors run on OpenAI's servers, so the note above applies.
Add a custom MCP server
Follow OpenAI's documentation for adding a custom MCP server, give it this address, and choose OAuth when it asks how to authenticate:
Server URLtext https://betteria.app/mcpSign in and approve
ChatGPT opens Betteria. Sign in with your Betteria account and approve access.
OpenAI's coding agent for the terminal reads MCP servers from its config.toml.
Add the server
Add a table for Betteria to ~/.codex/config.toml (or .codex/config.toml in a trusted project):
~/.codex/config.tomltoml [mcp_servers.betteria] url = "https://betteria.app/mcp"Sign in and approve
Run this, then sign in with your Betteria account and approve access in the browser it opens:
Terminalbash codex mcp login betteriaConfirm it is connected
Run codex mcp list in a terminal, or type /mcp inside Codex. Betteria should be listed.
Cursor reads remote servers from an mcp.json file.
Open the configuration file
Use ~/.cursor/mcp.json to have Betteria in every project, or .cursor/mcp.json at a project's root for that project only. Create the file if it does not exist.
Add the server
Add Betteria under mcpServers:
mcp.jsonjson { "mcpServers": { "betteria": { "url": "https://betteria.app/mcp" } } }Turn it on and sign in
Cursor manages its MCP servers from its Customize page; make sure betteria is enabled there (Cursor's documentation has the current location). Cursor then opens Betteria: sign in with your Betteria account and approve access.
For GitHub Copilot's agent mode in Visual Studio Code.
Run MCP: Add Server
Open the Command Palette (Shift+Cmd+P on macOS, Ctrl+Shift+P elsewhere) and run MCP: Add Server.
Choose HTTP and paste the address
Pick HTTP (HTTP or Server-Sent Events), paste the address, name it betteria, and choose where to save it.
Server URLtext https://betteria.app/mcpOr write the configuration by hand
A workspace's .vscode/mcp.json uses servers rather than mcpServers. VS Code's documentation describes which locations each version reads.
.vscode/mcp.jsonjson { "servers": { "betteria": { "type": "http", "url": "https://betteria.app/mcp" } } }Sign in and approve
VS Code opens Betteria when the server first starts. Sign in with your Betteria account and approve access.
Google's command-line agent. One command adds the server.
Add the server
In a terminal, run this. It saves to the project's .gemini/settings.json; add --scope user for ~/.gemini/settings.json instead.
Terminalbash gemini mcp add --transport http betteria https://betteria.app/mcpOr write the configuration by hand
Gemini CLI uses httpUrl for a Streamable HTTP server:
settings.jsonjson { "mcpServers": { "betteria": { "httpUrl": "https://betteria.app/mcp" } } }Sign in and confirm
Gemini CLI opens Betteria the first time it connects: sign in with your Betteria account and approve access. Type /mcp in a session, or run gemini mcp list, to see it connected.
Any client that speaks Streamable HTTP and MCP's OAuth sign-in can connect. Most take a configuration of this shape:
Point the client at the address
The key that holds the servers differs between clients; the entry itself is a name and a URL.
Configurationjson { "mcpServers": { "betteria": { "url": "https://betteria.app/mcp" } } }Sign in and approve
The server answers an unsigned request with 401 and the address of its sign-in metadata; a client that supports MCP authorization takes it from there and opens Betteria for you.
Or try it in the MCP Inspector
The protocol's own test client signs in the same way and lists the tools without any assistant involved (Node 22 or later):
Terminalbash npx @modelcontextprotocol/inspector --server-url https://betteria.app/mcp --transport http
Check it works
Ask your assistant something only Betteria can answer:
What are the income bands in Germany?It should call get_country_bands with DEU and answer with the bands in euros, the cut-offs, the dataset version and a link to the Germany page on betteria.app. If it answers from memory instead, check the server is enabled and signed in, and ask again, naming Betteria.
Connected apps
Every client you approve is listed in Settings, under Connected apps, with what it may do. Disconnect it there and its access ends; nothing else on your account changes.
Troubleshooting
The client says it cannot connect
Check the address is exactly the one above, with https and no trailing slash. If the client runs in the cloud, see the note on cloud-hosted connectors.
The sign-in window does not open
Remove the server from the client and add it again, then start the client's own sign-in: /mcp in Claude Code, codex mcp login betteria in Codex. A client that cannot sign in to an MCP server cannot use this one.
Requests are refused with 401
The client is not signed in, or its access was disconnected in Connected apps. Sign in again from the client.
Requests are refused with 429
The server answers 60 requests a minute from one address. Wait for the number of seconds in the Retry-After header.