Help

Setting up and using Mentioned

From a first check to a tracked trend, to querying it all from Claude. If you want the method behind the numbers rather than how to drive the tool, that is How it works.

1. Your first check

A check asks an AI assistant five buyer questions about your category and counts how many of the answers name you. You need a free account first — every check spends real API budget, so there is no anonymous path.

  1. Create an account with an email and password. Nothing is emailed to you; the account exists so checks and tracked keywords have an owner.
  2. On the home page, enter your brand exactly as you would want a model to write it, and the category a buyer would actually ask about — “indoor pickleball courts in Austin”, not “sports”.
  3. Run it. Five questions are written, asked independently, and scored.

You get a score out of five, the sentence that named you, and — when nothing named you — which brands got named instead. Every result has a share link at /r/<id> you can send to someone.

The category is the whole experiment. A category so broad that no answer could name any specific business will score zero for everyone, and that is a fact about the question rather than about you. Ask what a buyer would type.

2. Tracking a keyword

A one-off check is a snapshot. Tracking turns it into a trend: a brand and a category whose five questions are written once, at creation, and then re-asked verbatim on every later run.

That freezing is the point. Most tools regenerate their prompts each run, which means part of every movement in their charts is the prompt changing rather than your visibility. Here, a line that moves means one thing.

Tracked keywords run weekly on our key. A keyword can run daily only when your account holds its own API key for every model that keyword asks — because a daily run spends your key, not ours. Remove the key later and the keyword reverts to weekly rather than quietly moving seven runs a week onto our bill.

3. Reading the numbers

Three figures, and none of them is redundant:

The one rule that makes everything else readable: a dash is not a zero. Where a figure could not be measured you get an em dash and a sentence, never a flattering zero. “Nobody named you” and “nothing has run yet” are different findings, and this product never prints one as the other. The same rule holds in the API and in the MCP tools, where the value is null rather than 0.

4. The dashboard, screen by screen

Your account is one page with a rail down the left. Each item loads only its own data, so a screen is a smaller page rather than a longer one.

Filters for brand and topic, and the 4W/8W/12W window, all live in the URL — so any view you are looking at can be bookmarked, reloaded or sent to someone. There is also a CSV export of one row per keyword per run, filtered exactly as the screen is.

Why Sources is usually empty — and what that means

Only a model that searches the web before answering has sources to report. Today that is Perplexity, and only on a key you have saved. Every other model answers from what it already knows, fetches nothing, and therefore has no sources — so the screen shows none rather than guessing where the answer came from. It names which of three situations you are in: nothing has run, nothing that ran reports sources, or something that does report them returned none.

5. Your own API keys

Under Settings you can save a key for ChatGPT, Gemini, DeepSeek, Llama 3.3 (Groq) or Perplexity. Saving one lets you re-ask a keyword’s frozen questions on that model whenever you like, set that keyword to daily, and — for Perplexity — fill in the Sources screen.

Keys are encrypted before they are written down, with a secret that is not in the database. Be clear about the limit of that: it protects you against our database leaking, not against us. A key pasted into a one-off check on the home page is used for that request and never written down at all.

Gemini and Groq both have genuinely free API tiers, so trying a second model does not have to cost anything.

6. Sharing a workspace

Keywords, runs and saved keys belong to a workspace rather than to you personally. On your own that distinction never surfaces — you get one workspace and it behaves exactly as an account did. It starts to matter when you invite someone.

From Team you can create additional workspaces and invite people to them. There are two roles: an owner, who can invite and remove people, and a member, who can see and use everything the workspace tracks. An invite is a link, and it is a credential — anyone holding it can join, so send it the way you would send a password, and revoke it from the same screen if it goes astray.

The keyword allowance is per workspace. Five people in one workspace share 25 keywords; five people each with their own workspace have 25 each. Splitting work across workspaces is therefore also how you split the allowance.

7. Password and two-factor

Security holds two things. You can change your password — passwords are stored with argon2id, and an older one is re-hashed to it the next time you log in, so you do not have to do anything to benefit from that.

You can also turn on two-factor authentication with any TOTP app (1Password, Authy, Google Authenticator). Scan the QR code, confirm one code to prove it works, and you are enrolled — the confirmation step exists so a mis-scanned code locks you out of the setup screen rather than out of your account.

Enrolling gives you recovery codes. Save them somewhere that is not the phone running the authenticator, because that is the exact thing they exist to survive. Each one works once. You can regenerate the set from the same screen, which invalidates the old ones.

An MCP token is not covered by two-factor. It is a bearer credential and it authenticates on its own — that is what makes it usable from a client that cannot show you a prompt. Turning 2FA on protects the dashboard login; it does not retroactively protect a token you already minted. If you want a token to stop working, revoke it.

Connecting an app is covered by two-factor, because approving one goes through the ordinary login. The approve screen has no password field at all: if you are signed out it hands you to the normal form, second factor included, and only asks you to approve once you are back.

8. Connect Claude (MCP)

Mentioned runs a Model Context Protocol server, so you can ask your own data questions in plain language from an AI client instead of reading screens.

  1. Go to SettingsConnect Claude and create a token. It is shown once and never again — only its hash is stored, so it could not be shown a second time even if you asked.
  2. Add it to Claude Code:
claude mcp add --transport http mentioned https://mentioned.at/mcp --header "Authorization: Bearer mnt_YOUR_TOKEN"

Then ask things like:

How did our visibility move over the last eight weeks, and which keyword moved most?

Which frozen prompt are we losing worst, and what do the actual answers say?

Which assistant has never heard of us?

Ten tools are available — overview, keywords, trend, prompts, competitors, models, sources, sentiment, answers and actions. They read through the same code the dashboard renders from, so an answer in Claude cannot disagree with the screen it came from.

Every tool is read-only. None of them runs a check, changes what you track, saves a key or spends API budget. That is deliberate: the caller is a model, and a tool that spends money is the wrong thing to put behind a retry loop.

A token is a password to your data. It does not expire; revoke it from the same card when you are done with it. Revoking a token does not sign you out of the dashboard, and logging out does not break a connector.

claude.ai and Claude Desktop: connect without a token

The custom connector dialog in claude.ai and Claude Desktop does not take a pasted token at all — it signs in with OAuth instead. That now works here, and it is the easier path of the two: there is no token to copy and none to lose.

  1. In Claude, open Settings → Connectors → Add custom connector.
  2. Paste https://mentioned.at/mcp as the URL. Leave the optional client ID and secret blank — Claude registers itself.
  3. Press Connect. A mentioned.at page opens asking you to approve it.
  4. If you are not signed in, you will be sent to the normal login first — including your two-factor code if you have it turned on. The approve screen never asks for your password, which is deliberate: an app connection is not a way around 2FA.
  5. Press Allow. Claude is connected.

The connection stays signed in on its own and renews itself in the background. It is read-only, exactly like a token: the same ten tools, and none of them can run a check or change what you track. It has no access to your password or your stored API keys.

Connected apps are listed under Connect Claude in Settings, with a Disconnect button. Disconnecting stops that app immediately; it can ask for your approval again whenever you like.

Claude Desktop with a token instead

If you would rather use the token you just made than the connector dialog — on a machine where you do not want to sign in, say — there is a way, through a small local bridge: mcp-remote, which Claude Desktop launches as an ordinary local server and which forwards to us over HTTPS with your header attached. The connector above is simpler and needs no Node; this is here for the case where it is not what you want.

Open Settings → Developer → Edit Config (that button creates the file if it does not exist; on a Mac it is ~/Library/Application Support/Claude/claude_desktop_config.json) and add:

{ "mcpServers": { "mentioned": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mentioned.at/mcp", "--header", "Authorization:${AUTH_HEADER}", "--transport", "http-only" ], "env": { "AUTH_HEADER": "Bearer mnt_YOUR_TOKEN" } } } }

Then quit Claude Desktop completely and reopen it — closing the window is not enough; it reads this file only at launch.

Three details in that config are deliberate, and each one is a bug you would otherwise hit:

It needs Node installed, and your token ends up in that config file in plain text — which is how every MCP client stores credentials, but worth knowing before you put it on a shared machine. Revoke it from Settings if that machine stops being yours.

Which clients this works with

claude.ai and Claude Desktop through the connector dialog, with no token at all. Claude Code directly, with the command above. Claude Desktop with a token through mcp-remote, if you prefer that. And any other MCP client that can either send an Authorization header or speak OAuth 2.1 — the server publishes the standard discovery documents at /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server, registers clients dynamically, and requires PKCE.

The two ways in are independent. A token keeps working if you disconnect an app, and disconnecting an app does not touch your tokens.

9. Limits

A paid plan is planned but not live; nothing on this site charges anyone today.

10. When something looks wrong

11. What we store

Checks, their answers, and your tracked keywords. IP addresses are stored hashed, never in the clear. API keys are encrypted; MCP tokens are stored only as a hash. Nothing is emailed to you, because there is no mail provider wired to this app at all. The full detail is on the privacy page.

Run a free check