Install the Odyssey Signal MCP server
Connect Claude, ChatGPT or another AI tool to your Odyssey data: the server address, how to sign in and what you can ask.
The Odyssey Signal MCP server lets an AI tool such as Claude read your organization's Signals: brand tracking, conversation and AI visibility data. You ask in plain language, the tool looks up the figures in Odyssey and answers with them. It can read data, never change it.
Before you start#
- An Odyssey account: the same one you use for the portal.
- An AI tool that supports remote MCP servers with sign-in. We have tested Claude (claude.ai and the Claude desktop app) and ChatGPT. Other tools connect the same way.
Every tool needs the same server address:
https://mcp.odysseysignal.app/mcpAdd the server to Claude#
A connector you add in claude.ai is also available in the Claude desktop app.
- In Claude, open Settings → Connectors and choose Add custom connector.
- Name it
Odyssey Signaland pastehttps://mcp.odysseysignal.app/mcpas the URL. - Save it, choose Connect next to Odyssey Signal and sign in when the browser opens (see below).
Add the server to ChatGPT#
You add the server in ChatGPT on the web, at chatgpt.com.
- In ChatGPT, open Settings and turn on Developer mode. It is in the settings for apps and connectors, under the advanced settings.
- Create a new connector. Name it
Odyssey Signal, paste the address above as the MCP Server URL and choose OAuth as authentication. Leave any client ID and secret fields empty. - Save it and sign in when the browser opens (see below).
Add the server to another AI tool#
Any tool that supports remote MCP servers with OAuth sign-in connects the same way:
- Add a remote or custom MCP server in the tool. If it asks for a transport, choose streamable HTTP.
- Use the address above as the URL.
- Choose OAuth if the tool asks how to authenticate. You don't need a client ID or secret: the tool registers itself.
- Connect and sign in when the browser opens.
A tool that can only start MCP servers on your own computer cannot connect to this server directly.
Sign in#
The first time the tool connects, it opens a browser window:
Step 1: Sign in to Odyssey
Use your Odyssey account, with any of the sign-in methods your organization allows.
Step 2: Verify it's you
If you sign in with email and password and your organization requires two-step verification, enter your code. You are asked for it each time you connect a tool.
Step 3: Go back to your AI tool
The tool is now connected. Ask it something, for example "Which Signals can I read?"
The tool sees exactly what you can see in the portal: your organization's Signals, with your own permissions.
What you can ask#
You don't call these tools by name. Ask your question and the AI picks the ones it needs.
| Tool | What it does |
|---|---|
| list_organizations | Lists the organizations whose Signals you can read |
| list_signals | Lists the Signals you can read: the place to start |
| describe_signal | Shows a Signal's data sources, datasets and markets |
| list_datasources | Lists the data sources on a Signal |
| describe_datasource | Shows a data source's type and datasets |
| describe_dataset | Shows a dataset's filters, breakdowns, periods and languages |
| list_metrics | Lists the metrics on a dataset and what each measures |
| list_dimension_values | Lists the values you can filter on |
| list_brands | Lists the brands a data source carries |
| list_drivers | Lists the drivers a data source is set up with |
| list_periods | Shows which periods have data |
| query | Runs a query: metrics, period, breakdowns, filters and brands |
| get_map | Gets a demand-space map for one period |
| get_map_guide | Explains how to read and draw a map type |
The AI answers only with figures the server returned. When your question leaves something open, such as the market or the period, it asks you before it runs a query.
Troubleshooting#
| You see | What to do |
|---|---|
| The tool asks you to sign in to Odyssey Signal again, or says it is not authorized | Reconnect the server in your tool's settings and sign in again. |
| The sign-in page asks you to set up two-step verification first | Sign in to the Odyssey portal once, set up two-step verification, then connect the tool again. |
| The answer is empty | Ask the AI which periods and filters have data, then ask again with those. |
Last reviewed 9 November 2026