A ten-minute path from nothing to a working answer
- Confirm you are signed in to Prominara in the same browser your client will open, and that your organization has an active plan or trial.
- Add
https://mcp.prominara.comto your client. See the guide for Claude, ChatGPT or a coding agent. - Complete the consent page. Grant read and write for the full walkthrough.
- Ask the agent to list your Prominara sites. A list of domains means the connection works.
- Ask for the visibility overview of one site over the last 30 days.
- Ask it to run a check on one prompt, then read the answers a minute or two later.
The client says it is not authorized
An unauthorized response means the token is missing, expired or revoked. Most clients refresh silently. If yours does not, disconnect and reconnect Prominara, which starts a fresh consent.
- Check Settings, then Connected agents, in case the connection was revoked.
- Confirm the organization still has an active plan or trial.
- Confirm you are still a member of that organization.
A tool says it needs a permission
That is the write scope. You granted read only at consent. Disconnect and reconnect, leaving write checked this time. Read tools keep working throughout.
A tool says a limit was reached
The message names the limit, what remains and when it resets. Common ones:
| What you see | What to do |
|---|---|
| Monthly check quota reached | Wait for the reset date in the message, or upgrade the plan. |
| Tracked prompt limit reached | Deactivate prompts you no longer need, which frees slots, or upgrade. |
| Platform slots exceeded | The plan covers fewer platforms than you asked for. The call clamps to the plan and says so. |
| AI suggestion allowance reached | The cached suggestion set is still returned when one exists. |
| Rate limited | Too many calls in a short window. Wait the number of seconds in the message. |
A check will not run
- Market not confirmed. The site has no confirmed market, so nothing can be checked. Open the site settings in the app and confirm the market once.
- Check already running. A check for that prompt is still in flight. The tool skips it rather than double-billing your quota. Read the answers in a minute or two.
- Trial expired. Read tools and usage keep answering so the agent can explain the state, but writes stop until the plan is active again.
The agent cannot find a site or prompt
Identifiers are scoped to the organization you consented to. If a site exists in a different organization, the tool reports it as not found rather than leaking that it exists elsewhere. Reconnect and pick the other organization at consent.
Results are empty
A site with no tracked prompts has nothing to report. Ask the agent to suggest prompts and create a set, then run the first checks. Visibility rates need successful checks on questions that never name your brand, so a workspace of brand-name prompts shows an empty headline rate by design.
Still stuck
Unexpected failures return an error id. Send it to support and we can trace the exact call.