Connect an AI assistant

Ask claude.ai, ChatGPT, Claude Code, Cursor, VS Code or Claude Desktop about your Gloriads account, through the read-only MCP connector.

Last updated: Oct 11, 2026

Connect an AI assistant to Gloriads and ask it about your account in plain words.

The assistant sees exactly what the Gloriads API sees, and changes nothing in your account.

What the assistant can see

Everything the API sees, and nothing else.
Nothing it can change: no setting, no billing.
Your data does leave Gloriads. Only connect an assistant you trust: once it has read your account, disconnecting it (Settings → API → Connected apps) stops any further reading, but it cannot take back what it already read.

What you can ask

"How did my ads do last month, and in which marketplace did I spend the most?"
"Is my ACOS better than the month before?"
"Which products had the worst ACOS over the last 30 days?"
"Show my spend day by day this month."
"List my paused campaigns in Germany."
"Which keywords does this campaign target?"
"What did my rules change this week, bid by bid?"

The assistant reads the same figures as your dashboard: the list of what it can read is in What the API reads.

The address, and what each assistant needs

One address, the same for every assistant:

https://gloriads.com/api/mcp

Assistant	What it needs
claude.ai, Claude Desktop	You sign in and click Allow. No key to copy.
ChatGPT	The same sign-in, but in developer mode, on a paid plan.
Claude Code, Cursor, VS Code	One of your API keys, from Settings → API.

Any other tool that supports custom MCP servers can use the same address.

Everything is on one page in the app — Settings → API: the address, the ready-made commands, and your keys. Each block has a Copy button.

claude.ai

In claude.ai, open Customize in the left menu.
Open the Connectors tab.
Click Add, then Add custom connector.
Name it Gloriads, paste https://gloriads.com/api/mcp, then click Continue.
Change nothing on the next page: claude.ai has detected that Gloriads signs you in and publishes its own identity. Click Add.
Click Connect.
Sign in to Gloriads if you are asked to.
Check the app that is asking, then click Allow.
You are sent back to claude.ai. On the connector page, under Tool permissions, choose Always allow: Claude then reads your figures without asking every time, and this connector can do nothing else.

In a conversation, turn the connector on if the app asks you to, then ask your question.

Ask Haiku. It is the fastest and the least expensive Claude model, and reading your figures asks nothing more of it. Pick it in the model menu of your conversation.

A free Claude account can add one custom connector.

To disconnect it, open Settings → API → Connected apps in Gloriads and choose Disconnect. It stops reading your figures immediately.

Claude Desktop

Claude Desktop uses the same connectors as claude.ai, so there is nothing else to install: add the connector from either one, sign in, and click Allow. It then works in both.

ChatGPT

ChatGPT does not connect like Claude: its custom servers live behind developer mode, which is only offered on ChatGPT's paid plans. Here is the whole path.

In ChatGPT's settings, turn on developer mode.
Open Plugins, then New plugin.
Name: type Gloriads. The icon and the description are optional.
Connection: keep Server URL and paste https://gloriads.com/api/mcp.
Authentication: choose OAuth. There is nothing to fill in below it — Gloriads publishes its settings at that address, and ChatGPT reads them.
Tick I understand and want to continue — ChatGPT shows that warning for every custom server, ours included — then click Create.
ChatGPT opens Gloriads: sign in if you are asked to, check that the app requesting access is ChatGPT, then click Allow.
In a conversation, switch the plugin on before asking your first question.
Choose how much ChatGPT may do on its own, in Settings → Plugins → Gloriads → Permissions. Allow read actions is enough: this connector can only read. Allow all actions is marked elevated risk and buys you nothing here.

To disconnect it, open Settings → API → Connected apps in Gloriads and choose Disconnect, exactly as for claude.ai.

Claude Code

Create a key in Settings → API → Create a key, name it "Claude Code", and copy it. It is shown only once.

Then run this in a terminal, with your key in place of YOUR_API_KEY:

claude mcp add --transport http gloriads https://gloriads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Check it with claude mcp list, or /mcp inside Claude Code.
The server is added to the current project. Add --scope user to use it everywhere.
To remove it: claude mcp remove gloriads.

Cursor

Put your key in the GLORIADS_API_KEY environment variable, then paste this into ~/.cursor/mcp.json (all your projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "gloriads": {
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GLORIADS_API_KEY}"
      }
    }
  }
}

Cursor reads the key from that variable, so the file never contains it. Set the variable before you open Cursor.

VS Code

Open MCP: Open User Configuration from the Command Palette (all your projects), or create .vscode/mcp.json in a project, and add:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gloriads-api-key",
      "description": "Gloriads API key",
      "password": true
    }
  ],
  "servers": {
    "gloriads": {
      "type": "http",
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gloriads-api-key}"
      }
    }
  }
}

VS Code asks for the key the first time the server starts and remembers it, so the file never contains it.

The tools it uses

The assistant picks the right tool for your question. Each tool reads one part of the API.

Tool	Reads	Example question
`get_account`	Your subscription, whether Amazon Ads is connected, up to which day the figures go	"Is my subscription active?"
`list_marketplaces`	Your connected marketplaces and how many campaigns each runs	"Which marketplaces are connected?"
`get_summary`	The totals of a period, per marketplace and per ad type, compared with an earlier period if you ask	"How much did I spend last month, compared with the month before?"
`get_timeline`	The same figures day by day or month by month	"Show my sales day by day this month."
`get_products_report`	Each product's figures over a period	"Which product has the worst ACOS?"
`get_streaming_tv_report`	One marketplace's Streaming TV campaigns and their figures	"How did my TV ads do in the US this month?"
`list_campaigns`	One marketplace's campaigns	"List my paused campaigns in Germany."
`list_ad_groups`	One marketplace's ad groups	"What is the default bid of this campaign's ad groups?"
`list_targets`	One campaign's keywords and other targets	"Which keywords does this campaign target, and at what bid?"
`list_ads`	One campaign's ads	"Which products does this campaign advertise?"
`list_rules`	Your rules	"Which of my rules are on?"
`list_rule_runs`	One rule's last runs	"What did this rule change on its last run?"
`list_activity`	Everything Gloriads did on Amazon	"What did Gloriads change this week?"
`get_activity`	One operation	"Is that copy finished?"
`list_activity_lines`	What one operation changed, line by line	"Which bids did that rule lower, and by how much?"

Good to know

The same figures as the app. Each answer says which period and currency it used, and says so when a figure is incomplete.
A key reads your whole account. Keep it out of shared files, and revoke it in Settings → API the day you stop using the assistant.
Shared limits with the API: 60 requests per minute and 10,000 per day for your account. One question can cost several requests. See Limits and errors.
Try it without an account in a developer tool: the public demo key on the API reference works here too, and reads the demo account's synthetic figures.

Limits and errors Troubleshooting