What the MCP server does

The Odyssey Signal MCP server connects an AI tool, such as Claude or ChatGPT, to your Signals. MCP (Model Context Protocol) is an open standard for giving AI tools access to data. You ask a question in plain language; the AI looks up the figures in Odyssey and answers with them.

The server only reads. It cannot change your Signals, your settings or anything else in Odyssey.

What it can read#

• The Signals of your organization, with the same permissions you have in the portal.
• Brand tracking (survey) data, conversation data and AI visibility data, where your Signal has them.
• Metrics, periods, markets, brands, drivers and the filters and breakdowns each dataset allows.
• Demand-space maps, ready for the AI to draw the way the portal does.

How a question is answered#

1. 1

   Step 1: Find the Signal

   The AI lists your organizations and Signals. If you can read more than one and your question does not say which, it asks you.

2. 2

   Step 2: Look at the data

   It reads which datasets, metrics, markets and periods the Signal has, so it asks for something that exists.

3. 3

   Step 3: Ask for the figures

   It runs a query with the metrics, period, markets, brands and breakdowns your question needs.

4. 4

   Step 4: Answer

   It answers with the figures the server returned and says which Signal, market, period and metric each one comes from.

Rules the AI is given#

The server gives every AI tool the same instructions. They are the rules Odyssey's own analyst in the portal follows:

• Only figures from the server. The AI reports each figure exactly as returned. It does not compute new ones: no ratios, differences, sums or averages. If you need a figure the Signal does not give, it says so.
• Ask, don't guess. When the organization, Signal, metric, market or breakdown is unclear, it asks you, with a few concrete options.
• The standard period. Unless you ask for another, it uses the period the dataset opens at in the portal.
• All markets unless you say otherwise. Without a market filter, a figure is the average over every market in the Signal. Ask for a breakdown by market to see each one.
• Empty is not zero. An empty answer means no data matched the period or filters, not 0%.
• Your files stay separate. If you also give the AI your own files, it says which source each number comes from and does not combine them into one figure.

Reading the answers#

• Each figure comes with its base: how many respondents, mentions or responses it builds on.
• A low base means you should not draw conclusions from that figure; caution means use it with care. The portal shows the same warnings on its widgets.
• A moving average (for example over three months) is named as one in the answer.
• NPS and other net scores are points from −100 to 100, not percentages.
• A position on a demand-space map says where a brand sits, not how it ranks: brands are not ranked or averaged by position.

Next steps#

• Install the MCP server in Claude, ChatGPT or another AI tool.
• See every tool the server offers in the MCP tools reference.