Skip to main content
AthenaHQ ships a remote Model Context Protocol (MCP) server. Once connected, an AI assistant like Claude or ChatGPT can query your AI search visibility data in plain language (share of voice, citation and mention rates, ranking positions, cited sources, tracked prompts and responses, content, and pitches) without you writing any API calls. Connections you sign in to (Claude.ai and ChatGPT) are read-only: they read the same data your account can already see and cannot change anything. Connections authenticated with an API key can additionally use write tools that mirror the REST API. Server URL 
https://api.athenahq.ai/api/mcp

​
Connect Claude.ai

No API key needed. You sign in with your AthenaHQ account.
1

Open connector settings

In claude.ai, go to Customize → Connectors → the ”+” → Add custom connector.
2

Paste the server URL

Enter https://api.athenahq.ai/api/mcp and continue.
3

Sign in and pick an organization

You’ll be prompted to sign in with your AthenaHQ account and choose which organization to connect. Claude then discovers all available tools automatically.

​
Connect ChatGPT

No API key needed. You sign in with your AthenaHQ account.
1

Open connector settings

In ChatGPT, open Settings and add a custom MCP connector (found under Apps or Connectors, depending on your plan and version).
2

Paste the server URL

Enter https://api.athenahq.ai/api/mcp and continue.
3

Sign in and pick an organization

Authorize with your AthenaHQ account and choose which organization to connect. ChatGPT then discovers the available tools.
Custom MCP connectors in ChatGPT require a plan that supports them (Pro, Business, or Enterprise) and may need developer mode enabled. Exact menu labels can vary by ChatGPT version.

​
Connect other MCP clients

Clients that don’t support the sign-in flow authenticate with an API key using the x-api-key header.
1

Create an API key

Go to the API Keys page in your dashboard. Scope the key to specific websites if you want to limit access, then save it securely.

Manage API Keys

Create, view, and manage API keys in your organization settings
2

Add the server to your client config

Replace your_api_key_here with your key.
{
  "mcpServers": {
    "athenahq": {
      "type": "http",
      "url": "https://api.athenahq.ai/api/mcp",
      "headers": {
        "x-api-key": "your_api_key_here"
      }
    }
  }
}

​
Claude Code

claude mcp add --transport http --scope user athenahq https://api.athenahq.ai/api/mcp \
  --header "x-api-key: your_api_key_here"

​
Access and scope

An MCP connection sees exactly what its credential is authorized for, the same scoping as the REST API:
  • Organization and website access follow the signed-in user (Claude.ai) or the API key’s scope.
  • A website-scoped API key is limited to its websites, with one deliberate exception: organization-level tools (such as get_credits_organization) return org-wide aggregates. Each tool applies the same authorization as its REST endpoint.
  • Sign-in connections (Claude.ai and ChatGPT) are read-only. API-key connections can additionally use write tools that mirror the REST API, with the same validation and audit logging.
Only organization admins can create, edit, or delete API keys. Sign-in connections (Claude.ai, ChatGPT) only read data; API-key connections can also use write tools that mirror the REST API, with the same validation and audit logging.

​
Available tools

The assistant discovers these automatically once connected. Each maps to an endpoint in the API reference.

​
Metrics

ToolWhat it returns
get_share_of_voice_cumulativeShare of voice across competitors for a date range
get_share_of_voice_time_seriesShare of voice over time (daily)
get_citation_rate_cumulativeCitation rate (how often AI answers link to you) across competitors
get_citation_rate_time_seriesCitation rate over time (daily)
get_mention_rate_cumulativeMention rate (how often AI answers name your brand) across competitors
get_mention_rate_time_seriesMention rate over time (daily)
get_position_cumulativeAverage ranking position in AI answers for a date range
get_position_time_seriesRanking position over time (daily)
get_ai_search_valueAI search value: topic-market value, captured value, headroom, coverage, per-topic detail

​
Prompts and responses

ToolWhat it returns
get_promptsTracked prompts for a website, with volume, status, and geography
get_responsesAI answers for a website, with cited sources, sentiment, and ranking

​
Content

ToolWhat it returns
get_tracked_contentTracked content with citation, mention, and impression metrics
get_content_detailFull text of one content item: brief, body, cited URLs, links, status
get_content_citation_promptsPrompts whose AI answers cited a given content item
get_content_hub_sheetsContent Hub tabs configured for a website

​
Sources and competitors

ToolWhat it returns
get_sourcesTop cited root domains, classified as owned / competitor / partner / third-party
get_source_pagesIndividual cited URLs with per-URL metrics
get_competitorsCompetitors tracked for a website

​
Pitches

ToolWhat it returns
list_pitchesPitch reports for the organization
get_pitchOne pitch report: competitors, prompts, attributes, top citing sources, metrics

​
Account and configuration

ToolWhat it returns
list_websitesWebsites your credential can access
get_date_rangeEarliest and latest response dates for a website
get_locationsGeographies configured for a website
get_saved_viewsSaved filter presets for a website
get_group_saved_viewsSaved views shared across a group
get_credits_websiteCredit balance for a website
get_credits_organizationCredit balance for the organization

​
Example prompts

Once connected, try:
  • “What’s my share of voice in AI answers versus my tracked competitors this quarter?”
  • “Which domains get cited most for the prompts I track?”
  • “Show my citation rate trend over the last 90 days.”
  • “What’s my captured AI search value and headroom by topic?”
  • “Pull the AI responses that mention my brand and summarize their sentiment.”