Skip to main content
The Hikoo MCP currently ships 18 tools across 7 areas. You never call them directly. Describe what you want in natural language and your AI client picks the right one. All tools operate on the single website bound to your API key. No website_id parameter is needed.

​
Website

​
geo_get_website
read-only
Returns the website metadata, topics, competitors list, language, and subscription status.

​
Audits

​
geo_list_audits
read-only
List every audit ever run for this website (most recent first), with scores, status, and audited-page count.
​
geo_get_audit
read-only
Detail of a single audit: overall score, timing, and the list of audited pages.Args: audit_id
​
geo_get_audit_page
read-only
Page-level audit result with every criterion and its validation status, plus the recommendations attached to each failing criterion. This is the most detailed audit view.Args: audit_id, page_id
​
geo_start_audit
write
Queue a new full-site audit. Runs asynchronously. Poll geo_list_audits or geo_get_audit for status.Fails if the website’s audit quota for the current billing period is exhausted.

​
Citations

​
geo_list_citations
read-only
Paginated list of raw AI citations: the actual content the LLM produced, its sources, and which competitors were mentioned.Args: page, page_size, time_range, website_cited (filter to cited/not-cited only)
​
geo_get_top_platforms
read-only
Top AI platforms by citation count.Args: time_range
​
geo_get_platforms_share_of_voice
read-only
Visibility trend data per platform (share of voice over time).Args: time_range
​
geo_get_top_sources
read-only
Top source domains (or URLs) that appear in AI citations. Useful to understand where LLMs get their answers.Args: time_range, group_by (domain or url), limit

​
Prompts

​
geo_get_prompts_quota
read-only
Current prompt count vs the subscription limit. Call this before bulk-creating prompts. Every create past the limit fails.Returns { used, limit, remaining }.
​
geo_list_prompts
read-only
All prompts tracked for the website, grouped by topic, each with its visibility score.Args: topic_id (optional filter)
​
geo_create_prompt
write
Create a new prompt. Fails if the website’s prompt quota is reached. Check geo_get_prompts_quota first.Args: content, topic_id, localizations
​
geo_update_prompt
write
Update an existing prompt. Only fields you provide are changed.Args: prompt_id, content, topic_id, localizations
​
geo_delete_prompt
destructive
Delete a prompt.Args: prompt_id
​
geo_get_prompt_citations
read-only
Paginated citations tied to a specific prompt.Args: prompt_id, page, page_size

​
Topics

​
geo_list_topics
read-only
List every topic tracked for the website.

​
Competitors

​
geo_list_competitors
read-only
Competitor ranking (share of voice) against your website.Args: time_range

​
Health

​
geo_get_health
read-only
Global website health (AI crawlers allowed, llms.txt present, sitemap reachable) plus actionable improvement suggestions.Args: include_dismissed

​
Argument conventions

  • time_range accepts: all_time, 1y, 1m, 1w, 1d.
  • page / page_size are 1-based. page_size is capped at 100.
  • Write tools mutate data in your workspace. Claude Desktop and Claude Code ask for confirmation before running them by default.

​
Annotations

Each tool is labelled so MCP clients know how to handle it:
LabelMeaning
read-onlyNever mutates data. Safe to call freely.
writeCreates or updates data.
destructivePermanently removes data. Always review before confirming.