Tools

When you connect an assistant (Claude, Cursor, or another MCP client) to Asky, it gains access to a set of read-only tools. Each tool answers one kind of question about your brand’s AI-search visibility, drawn straight from the same data you see in the Asky app.

You do not call these tools directly. You ask a question in plain language, and the assistant picks the right tools for you, often chaining several together. This page is a reference so you know what is available and can phrase questions that map cleanly to your data.

Every tool is read-only and scoped to your brand. Tools can read your Asky data but can never create, change, or delete anything. They only return data for brands your signed-in account can access. To learn how access works, see read-only access.

The engines Asky tracks you across are ChatGPT, Perplexity, and Google AI Overviews. Most tools accept a date range and optional filters (by topic, tag, or engine), which the assistant fills in based on your question. Almost everything starts from your brand, so the assistant will usually call asky_brands_list first to find it.

Account & setup

The starting point: who you are, which brands you can access, and the building blocks (topics, engines, tags) that other tools filter by.

Tool	What it reads
`asky_whoami`	Who you are and which brands you can access
`asky_brands_list`	Your brands (the starting point for almost every question)
`asky_brand_profile`	Your brand identity and knowledge
`asky_topics_list`	Your topics
`asky_keywords_list`	The keywords behind your topics, and how often each is seen
`asky_models_list`	The AI engines you are tracked across (for example ChatGPT, Perplexity, Google AI Overviews)
`asky_tags_list`	Your prompt tags
`asky_connections_status`	Which integrations are connected (Search Console, Webflow, WordPress, Cloudflare)
`asky_usage_summary`	How much of your plan allowance is left

Visibility & competitors

How visible you are in AI answers, and how you stack up against the competitors you track.

Tool	What it reads
`asky_visibility_overview`	Your AI-search visibility, sentiment, and average rank
`asky_visibility_timeseries`	How your visibility trended day by day
`asky_performance_diagnosis`	Why your visibility moved, with the prompts and sources that drove it
`asky_engine_breakdown`	The same picture split by engine (ChatGPT, Perplexity, AI Overviews)
`asky_segment_breakdown`	The same picture split by topic or by market
`asky_topic_scoreboard`	Every topic’s health, gap to the leader, and open actions
`asky_competitors_rankings`	You versus competitors on share of voice, visibility, sentiment, and rank
`asky_competitors_profiles`	The competitors you track
`asky_competitor_get`	One competitor’s profile
`asky_fanout_queries`	The sub-queries engines run before they answer

Head-to-head

Go beyond the leaderboard: where exactly you win and lose against a named rival.

Tool	What it reads
`asky_competitor_topic_matrix`	Your visibility versus each rival’s, topic by topic
`asky_competitor_funnel_coverage`	The same split by funnel stage, to see where in the journey you drop out
`asky_competitor_prompt_overlap`	Question by question against one rival: who gets named, who does not
`asky_competitor_citation_battleground`	Which sources carry them and not you
`asky_competitor_source_battleground`	Per source, the pages naming only you, only them, or both
`asky_competitor_source_matrix`	Which publications name which rivals
`asky_competitor_source_pages`	The individual pages naming rivals, and whether you appear
`asky_competitor_candidates`	Rivals showing up in your results that you are not tracking yet

Brand alignment

Whether AI engines describe your brand accurately, down to the individual claim.

Tool	What it reads
`asky_alignment_overview`	Your alignment score, plus how many AI claims about you are right versus wrong
`asky_alignment_claims_list`	The individual graded claims, to find what AI gets wrong
`asky_alignment_claim_detail`	One claim with its sources and your own evidence
`asky_alignment_prompts`	Which questions surface the most misinformation
`asky_alignment_run_status`	When alignment last ran

Citations

The sources AI engines cite when they answer questions about your topics.

Tool	What it reads
`asky_citations_overview`	The URLs AI engines cite for your topics
`asky_citations_by_domain`	The same citations grouped by website
`asky_citation_domain_detail`	One website in depth: its cited pages, the questions that triggered them, and the engine split
`asky_citations_earned_mentions`	Pages that cite competitors but not you
`asky_citations_competitor_page_mentions`	Which cited pages name your competitors

Prompts & monitors

The questions you track and how your brand performs on each one over time.

Tool	What it reads
`asky_prompts_list`	Your tracked questions, with demand and difficulty as tiers
`asky_prompts_metrics`	Per-question visibility, citation rate, and rank
`asky_prompt_detail`	One question in full: headline numbers, the entity leaderboard, and the engine split
`asky_responses_list`	Every AI answer across all your questions, newest first
`asky_prompt_executions_list`	The actual AI answers for one question over time
`asky_prompt_citations_list`	The sources cited in answers to one question
`asky_brand_activity_log`	What changed in your tracking setup, and when

Website & AI crawlers

What Asky has indexed from your site, and how AI crawlers interact with it.

Tool	What it reads
`asky_website_pages_list`	Your indexed pages and their citation performance
`asky_brand_knowledge_search`	Answers found in your own pages, searched by meaning rather than keyword
`asky_website_index_summary`	Crawl and embedding health
`asky_website_hosts_list`	Your hosts and subdomains
`asky_crawler_bot_summary`	How often each AI crawler hits your site
`asky_crawler_timeseries`	Crawler activity over time
`asky_crawler_top_paths`	Which pages AI bots fetch most
`asky_crawler_logs_list`	Individual recent crawler visits

Content

Your content drafts in the Asky library.

Tool	What it reads
`asky_content_list`	Your content drafts
`asky_content_get`	One draft in full
`asky_content_outline`	One draft’s structure and target fields
`asky_content_workflow_run_get`	One content run, including its brief
`asky_workflows_status`	Whether your article and site-audit runs finished or need you
`asky_knowledge_documents_list`	What is in your Brand Knowledge library

Opportunities & tasks

Gaps and openings to act on, plus the task tracker that follows them.

Tool	What it reads
`asky_opportunities_overview`	One prioritised list across every opportunity type
`asky_opportunities_content_list`	Content gaps by topic
`asky_content_opportunity_get`	One content gap in full
`asky_opportunities_technical_list`	Technical site issues
`asky_technical_issue_get`	One issue with how to fix it
`asky_opportunities_platform_list`	Review sites and directories worth being listed on
`asky_opportunities_engagement_social_citations_list`	Recently-cited social discussions
`asky_reddit_opportunities_list`	Relevant Reddit threads
`asky_reddit_opportunity_get`	One Reddit thread in full
`asky_reddit_engagement_status`	Your Reddit reply runs
`asky_tasks_list`	Your opportunity task tracker
`asky_task_get`	One task with its notes

Community engagement

Discussions worth joining, what has already been said on your behalf, and the reasoning behind both.

Tool	What it reads
`asky_social_ranked_opportunities`	Which discussion to reply to first, and why that one
`asky_social_search`	Discussions matching a phrase, searched live rather than from your queue
`asky_social_thread_read`	One discussion in full: the post and its comment tree
`asky_social_container_rules`	A community’s own posted rules, in its own words
`asky_social_citation_gap`	Communities answer engines already cite for your category, and whether you appear in them
`asky_social_qualifications_list`	Every discussion that was assessed, including the ones deliberately passed over and why
`asky_social_publication_history`	Replies published for you, with where, when, and whether each is still live
`asky_social_identities_list`	Accounts that can reply for you, and the voice each one writes in
`asky_social_keywords_list`	Your engagement keywords and what each has actually surfaced
`asky_social_learnings_list`	Lessons drawn from real outcomes, each tied to the evidence behind it
`asky_social_run_report`	A summary of recent engagement work: drafted, published, passed over, blocked

You will rarely need to mention a tool by name. Ask a natural question like “How has my visibility changed this month?” or “What pages cite my competitors but not me?”, and the assistant chooses the right tools. For example questions to try, see Use Cases.

Introduction - what the Asky MCP server is and why to use it
Setup - connect your assistant by signing in
Use Cases - example questions and workflows