> ## Documentation index
> Fetch the complete documentation index at: https://docs.odysseysignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

Last reviewed 9 November 2026

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

> [!NOTE]
> **ChatGPT at work**
>
> In a ChatGPT workspace for a company, an administrator may need to allow Developer mode or custom connectors first.

## 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. **Sign in to Odyssey**

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

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. **Go back to your AI tool**

   The tool is now connected. Ask it something, for example "Which Signals can I read?"

> [!NOTE]
> **Staying signed in**
>
> The tool keeps you signed in. If you don't use it for 14 days, or after 30 days at most, it asks you to sign in again.

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