Skip to content

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:

Text
https://mcp.odysseysignal.app/mcp

Add the server to Claude#

A connector you add in claude.ai is also available in the Claude desktop app.

  1. In Claude, open Settings → Connectors and choose Add custom connector.
  2. Name it Odyssey Signal and paste https://mcp.odysseysignal.app/mcp as the URL.
  3. 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.

  1. In ChatGPT, open Settings and turn on Developer mode. It is in the settings for apps and connectors, under the advanced settings.
  2. 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.
  3. 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:

  1. Add a remote or custom MCP server in the tool. If it asks for a transport, choose streamable HTTP.
  2. Use the address above as the URL.
  3. Choose OAuth if the tool asks how to authenticate. You don't need a client ID or secret: the tool registers itself.
  4. 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:

  1. Step 1: Sign in to Odyssey

    Use your Odyssey account, with any of the sign-in methods your organization allows.

  2. 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.

  3. 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.

ToolWhat it does
list_organizationsLists the organizations whose Signals you can read
list_signalsLists the Signals you can read: the place to start
describe_signalShows a Signal's data sources, datasets and markets
list_datasourcesLists the data sources on a Signal
describe_datasourceShows a data source's type and datasets
describe_datasetShows a dataset's filters, breakdowns, periods and languages
list_metricsLists the metrics on a dataset and what each measures
list_dimension_valuesLists the values you can filter on
list_brandsLists the brands a data source carries
list_driversLists the drivers a data source is set up with
list_periodsShows which periods have data
queryRuns a query: metrics, period, breakdowns, filters and brands
get_mapGets a demand-space map for one period
get_map_guideExplains how to read and draw a map type
The tools the Odyssey Signal MCP server offers

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 seeWhat to do
The tool asks you to sign in to Odyssey Signal again, or says it is not authorizedReconnect the server in your tool's settings and sign in again.
The sign-in page asks you to set up two-step verification firstSign in to the Odyssey portal once, set up two-step verification, then connect the tool again.
The answer is emptyAsk the AI which periods and filters have data, then ask again with those.

Last reviewed 9 November 2026