Xofu MCP Setup and Usage Guide

Claude

Custom connectors work on every Claude plan. Free accounts can add one. A connector you add works in the Claude desktop app, on the web and on mobile.

1. In Claude, open Customize, then Connectors.
2. Click + Add, then Add custom connector.
3. Enter Xofu as the name and https://mcp.xofu.com/mcp as the server URL, then click Continue.
4. Keep the sign-in settings Claude suggests and click Add. You don't need an OAuth client ID or secret.
5. Sign in to Xofu in your browser and click Allow (see Signing in to Xofu).
6. In a chat, click + at the lower left, then Connectors, and turn Xofu on.

Claude asks for your approval before it uses a Xofu tool. You can allow each tool once or always.

On a Team or Enterprise plan, an owner adds Xofu first, in Organization settings > Connectors (click Add, then Custom, then Web). Then each member opens Customize > Connectors, finds Xofu and clicks Connect.

More detail: Claude's guide to custom connectors.

ChatGPT

ChatGPT adds custom MCP servers on the web, at chatgpt.com. OpenAI offers them on its Business, Enterprise and Edu plans. On Pro, only tools that read data work, so you can look at your Xofu data but not change projects. On a Business plan, only an admin or owner can add Xofu.

1. Open chatgpt.com in your browser and go to Plugins.
2. Click the plus button, then Add custom MCP server.
3. Enter Xofu as the name. Under Connection, enter https://mcp.xofu.com/mcp.
4. For authentication, choose OAuth.
5. Read the warning, check I understand and want to continue, and click Create as a plugin.
6. ChatGPT lists Xofu's tools. Add the plugin, then sign in to Xofu and click Allow (see Signing in to Xofu).
7. In a chat, type @ and choose Xofu. This applies to one message, so mention Xofu again when a follow-up needs new data.

ChatGPT asks you to confirm before a Xofu tool changes anything.

OpenAI's plans change often. For the latest, see Connecting custom MCP servers in ChatGPT.

Cursor

Cursor reads its MCP servers from a settings file. The quickest way is the install link:

Add Xofu to Cursor

With Cursor installed, the link opens it and offers to add Xofu. To add it yourself instead:

1. Open ~/.cursor/mcp.json, the mcp.json file in the .cursor folder of your home folder. Create it if it isn't there. For one project only, use .cursor/mcp.json in that project instead.
2. Add Xofu under mcpServers. If the file already lists other servers, add the xofu entry next to them.

   {
     "mcpServers": {
       "xofu": {
         "url": "https://mcp.xofu.com/mcp"
       }
     }
   }

3. Save the file and restart Cursor.

Then, either way:

1. Open Customize in Cursor's sidebar, where Xofu is listed with your other MCP servers.
2. Sign in to Xofu when Cursor asks, and click Allow (see Signing in to Xofu).
3. In Agent chat, Cursor uses Xofu's tools when your question needs them. By default it asks for your approval first.

More detail: Cursor's MCP documentation.

Signing in to Xofu

Every app signs in the same way.

1. The app opens a Xofu page in your browser. If you aren't logged in to Xofu, log in, and you'll come back to this page.
2. The page says the app wants to access your Xofu account, shows the email you're signed in as, and lists what the app will be able to do:
   • Read your Xofu projects and their results
   • Create and change projects, prompts and settings
3. Click Allow. Your browser sends you back to the app.

The page also shows where you'll be sent back to. Only click Allow if you started the connection yourself.

The app stays signed in while you use it. If you don't use it for 30 days, it asks you to sign in again.

Accounts and projects

Start here. Most other tools work on one project, and these find it.

whoami Your Xofu accounts

Who you're signed in as, your accounts and your role in each, and what each plan allows: its prompt limit and how much is left, its AI engines, how often it runs, and its sentiment tracking limits.

list_projects Your Xofu projects

The projects you can see across all your accounts, including ones shared with you, and how recent their results are. It can add each project's visibility, to compare them.

get_project A Xofu project's setup

One project's headline visibility and setup: its brand, competitors, topics, engines, schedule, tracked domains, custom tags and latest runs.

list_prompts A Xofu project's prompts

The prompts (questions) a project asks AI engines, grouped by topic.

xofu_guide How Xofu counts things

How Xofu works out its figures, such as dates, engines, visibility and citations. The assistant reads it so it explains your numbers correctly.

Visibility

How visible a brand and its competitors are in AI answers, as on the dashboard's Brand tab.

get_visibility Visibility in AI answers

Visibility (0 to 100), share of voice, average position, mentions and own-site citations for the brand and its competitors, with the change from the period before and a point per day, week or month. It can also break the brand's figures down by topic, buyer persona, page or engine.

Runs and answers

Each run asks every prompt of every AI engine the project uses. These tools show what came back.

list_runs A Xofu project's runs

A project's runs, newest first, with each one's status, engines, and how many answers it collected.

list_answers One run's answers

One run's answers by prompt and engine: whether the brand was mentioned, its position and score, the other brands in the order mentioned, and how many links each answer cites.

get_answer One AI answer in full

One AI answer in full: its text, the brands it mentions, the pages it cites, and the searches the engine ran before answering.

Citations

The sites and pages AI answers cite, as on the dashboard's Citations tab.

get_cited_domains Domains cited in AI answers

The most-cited domains, with their citations, answers, prompts and share of all citations. It can also check a list of exact domains, such as your own site and your competitors'.

get_cited_pages Pages cited in AI answers

The most-cited pages, or one site's pages, with how often the brand is mentioned alongside each one.

get_domain_citations One domain's citations

One domain in depth: its citations by engine, topic and day, by prompt, or the answers that cite it.

get_citation_total All citations, by engine and day

All citations for a period, by engine and by day, with the runs on each day so gaps in the data stand out.

Query fan-outs (QFOs)

Before answering, some AI engines search the web. Those searches are called query fan-outs. Xofu records them for ChatGPT with search and for Gemini. Google AI Overviews and AI Mode don't show theirs.

get_fanouts Most frequent query fan-outs

The searches engines ran most often before answering a project's prompts, over a period or one run, with how many answers and prompts led to each. It can also show which searches are new since the period before and which dropped out.

list_answer_fanouts One run's query fan-outs

Every search each answer in one run made before answering, by prompt and engine.

get_sentiment_fanouts Most frequent query fan-outs in sentiment answers

The searches engines ran most often before answering a project's sentiment questions, with the brands and features those answers were about.

Sentiment

For projects with sentiment tracking on: how positively AI answers describe the brand and its competitors on each feature, as on the dashboard's Sentiment tab.

get_sentiment Sentiment in AI answers

Each run's overall sentiment score and its score per feature, for the brand and each competitor, with the change since the run before. It can also show one engine's view.

get_sentiment_answers The answers behind sentiment

The scored answers behind a sentiment score, with the claims that raised or lowered it and the searches the engine ran first.

get_sentiment_citations Sites cited in sentiment answers

The domains or pages one sentiment run's answers cite, and how positive the answers citing them were.

get_sentiment_domain_features Sentiment citations by feature, run by run

For a set of domains, how often each was cited in sentiment answers, by feature and run by run.

Citation audits

A citation audit is a one-off analysis of the sites a project's AI answers cite.

list_audits A Xofu project's citation audits

A project's citation audits, newest first, with the dates and brands each covers and how far it got.

get_audit One citation audit's results

One audit's results: the cited domains rated as outreach targets, which cited pages mention the brand and each competitor, or the brand's mentions and citations by prompt.

Project management

These tools change Xofu. The assistant uses them only when you ask, and only for what you could change yourself in the dashboard. See How changes work.