Connect Hawkscan to your AI agent

Last updated · By Hawkscan

Add Hawkscan as a remote MCP server in Claude, Claude Code, ChatGPT or any other agent that supports MCP, sign in with your Hawkscan account and approve the connection. Your agent can then read and update your AI visibility data.

Before you start

  • A Hawkscan account with an active paid plan or a trial in progress.
  • Claude, Claude Code, ChatGPT or any other agent that supports remote MCP servers.

You sign in once, in your browser. There is no API key to create.

Server address

Every agent connects to the same address.

https://hawkscan.ai/mcp

Add Hawkscan to your agent

  1. Open Settings, then Connectors.
  2. Click Add custom connector.
  3. Name it Hawkscan and paste the server address.
  4. Click Connect, then sign in to Hawkscan when you are redirected.

Approve the connection

Hawkscan shows which app is asking for access and where it will return. Approve to finish. Without an active paid plan, the connection stops at this screen.

Connect Claude to Hawkscan

This app is asking to access your Hawkscan account.

It will return to
claude.ai
Signed in as
you@company.com
Full access
It will read all the data of your organization and can change it: add prompts and competitors, update actions, delete prompts and competitors.
DenyApprove

Try it

Open a new conversation and ask:

  • Which projects do I have in Hawkscan?
  • How did my visibility change this week against Confluence?
  • Which sources do AI assistants cite instead of me?
  • What should I do first on my action plan?
  • With a coding agent: fix the top action of my plan, then mark it as done.

What your agent can do

Your agent gets 16 tools. Data tools filter by project and, where it applies, by period and model, as in the app.

ToolWhat it does
Read
List projectslist_projectsProjects of your organization, with brand and country
Get brand visibilityget_visibilityVisibility of your brand, its trend and the detail by model
List competitorslist_competitorsYour ranking against competitors
List promptslist_promptsTracked prompts, categories and metrics
Get a promptget_promptModel answers, brands and sources cited, by date
List prompt suggestionslist_prompt_suggestionsSuggested prompts waiting for a decision
List responseslist_responsesModel answers across a project, newest first
List sourceslist_sourcesDomains and pages cited
List actionslist_actionsYour action plan, with the status and impact of each action
Get an actionget_actionWhy it matters, what to do, the page to change and the competitors cited there
Change
Update an action statusupdate_action_statusMoves an action to todo, in progress, done or archived. Free and reversible.
Add promptsadd_promptsStarts their first analyses, within your plan's prompt quota. A batch that would exceed it is refused.
Add competitorsadd_competitorsRecomputes the brands found in your stored answers, at no analysis cost.
Delete
Remove competitorsremove_competitorsDeletes their detections and keeps your answers. Adding one back rebuilds its history.
Delete promptsdelete_promptsPermanent. Your agent shows you what would be deleted, then confirms with a code valid for 5 minutes.
Delete a projectdelete_projectDeletes nothing by itself. Returns a link to a confirmation you validate in Hawkscan.

Access and security

  • Your agent only sees the data of your organization.
  • Rights match the app: any member of the organization can make changes through their agent.
  • Text written by AI models or third-party sites reaches your agent marked as data, not as instructions to follow.
  • Each user can make up to 120 calls per minute.

To disconnect an agent, open your account menu, choose AI agents (MCP) and click Revoke. Access stops immediately.

Troubleshooting

MessageWhat to do
A paid Hawkscan plan is required.Choose a plan in Billing, then ask your agent again.
The subscription of this account ended.Renew your subscription in Billing.
The last payment for this account failed.Update your payment method in Billing.
This account is over the limits of its plan.Upgrade or reduce your usage in Manage plan.
Project “…” was not found.Ask your agent to list your projects, then use the slug it returns.
Too many calls to Hawkscan. Wait a minute before trying again.Each user can make up to 120 calls per minute. Ask again a minute later.
Hawkscan could not complete this request. Try again in a moment.Ask your agent again in a moment.
This account has no Hawkscan organization.Sign in to Hawkscan in your browser, then start the connection again from your agent.
Your agent says it is not authorizedIts access was revoked or has expired. Start the connection again from your agent.
This connection request is no longer validStart the connection again from your agent.
Your agent asks for an API key or a client IDChoose OAuth and leave these fields empty.
Your agent cannot register with the serverIt needs OAuth dynamic client registration. If it does not support it, use the mcp-remote bridge.

Not on Hawkscan yet?

See what AI says about your brand, then bring it into your agent.