Tools
When you connect an assistant (Claude, Cursor, or another MCP client) to Asky, it gains a set of tools. Each tool covers one kind of thing 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 tool and action 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 scoped to your brand: it only returns or changes data for brands your signed-in account can access, and your plan decides which features are included. Tools marked write below change data; your assistant asks you before calling one. To learn how access works, see what the connection can do.
Most tools take an action that selects the view or operation, listed in the right-hand column. The assistant fills in the action, the date range and any filters (by topic, tag, or engine) from your question. Almost everything starts from your brand, so the assistant will usually call asky_brands first to find it.
Reference resources
Besides the tools, the assistant can read a generated catalog of every tool, grouped by area, as the resource asky://reference/tool-catalog, and a guide to what each metric means at asky://reference/metric-semantics. Assistants that support MCP resources use these on their own; you do not need to do anything.
Context
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 | Actions |
|---|---|---|
asky_whoami | Who you are and which workspaces you can access | |
asky_brands | Your brands (the starting point for almost every question) | |
asky_brand_profile | Your brand identity, descriptions and verified facts | |
asky_topics | Your topic tree | |
asky_models | The AI engines you are tracked across (for example ChatGPT, Perplexity, Google AI Overviews) | |
asky_tags | Your prompt and competitor tags | |
asky_keywords | The keywords behind your topics, and how often each is seen | |
asky_connections | Which integrations are connected (Search Console, Webflow, WordPress, Cloudflare) | |
asky_usage | How much of your plan allowance is left |
Visibility
How visible you are in AI answers, how that trended, what changed and why.
| Tool | What it reads | Actions |
|---|---|---|
asky_visibility | Your AI-search visibility, sentiment and average rank; the trend over time; a diagnosis of what changed between two periods; and a per-topic health scoreboard | overview, trend, diagnosis, topic_scoreboard |
asky_visibility_breakdown | Your visibility and your competitors’, broken out per engine, per topic or per market | by_engine, by_topic, by_market |
asky_fanouts | The sub-queries AI engines run for themselves before they answer |
Competitors
How you stack up against the competitors you track.
| Tool | What it reads | Actions |
|---|---|---|
asky_competitors | Share-of-voice rankings, the list of tracked competitors, and brands that keep appearing but are not tracked yet | rankings, list, candidates |
asky_competitor | One competitor in depth: its profile, and head-to-head battlecards per prompt, per cited domain (in the answers) and per cited domain (on the pages) | get, prompt_overlap, citation_battleground, source_battleground |
asky_competitor_coverage | Who leads each topic or funnel stage, and your gap to the leader | by_topic, by_funnel_stage |
asky_competitor_sources | Which cited domains and pages name which competitors, and whether they name you | matrix, pages |
asky_competitors_write write | Add, edit, deactivate or delete competitors and the domains they publish on | create, update, delete, add_address, remove_address |
Citations
Which sources AI engines cite, and where you are missing from them.
| Tool | What it reads | Actions |
|---|---|---|
asky_citations | Cited URLs and domains with counts, share and rate; one domain in depth; pages that cite competitors but never mention you; and page-level competitor-mention analytics | by_url, by_domain, domain_detail, earned_mentions, competitor_page_mentions |
Prompts and responses
The questions you track, how each performs, and the actual AI answers behind the numbers.
| Tool | What it reads | Actions |
|---|---|---|
asky_prompts | Your tracked prompts, their per-prompt performance, and the log of changes to your tracking setup | list, metrics, activity_log |
asky_prompt | One prompt in depth: its KPIs and per-engine split, its answer history, and the sources cited for it | detail, responses, citations |
asky_responses | Every AI answer across all your prompts, newest first, with filters | |
asky_prompt_suggestions | AI-generated prompt suggestions awaiting review, and the status of a generation run | list, run_status |
asky_prompts_write write | Create prompts, move them between topics, change their markets or language, or delete them | create, update, set_countries, delete |
asky_prompt_suggestions_write write | Generate prompt suggestions and accept, reject or edit them | generate, edit, accept, reject |
asky_localization | Market coverage as data: your markets and their languages, which prompt families still lack a version per market, one family in depth, generation job progress, and the catalog of locales | markets, coverage, family, jobs, catalog |
asky_localization_write write | Open markets and set their languages, generate localized drafts, edit and accept them into tracked versions, move prompts into families, and relabel languages in bulk | save_market, remove_market, localize, cancel, edit_preview, accept, move, set_locale |
Brand alignment
What AI engines claim about your brand, and whether it is true.
| Tool | What it reads | Actions |
|---|---|---|
asky_alignment | Alignment score and status counts, the graded claims and one claim in full, the alignment prompts and categories behind them, the verified facts, run history, and the suggestion queue | overview, claims, claim_detail, prompts, run_status, categories, facts, suggestions |
asky_alignment_execute write | Run an alignment check now instead of waiting for the daily one | |
asky_alignment_prompts_write write | Create, edit, re-market or delete alignment prompts | create, update, set_countries, delete |
asky_alignment_categories_write write | Manage alignment categories and the verified facts they are graded against | create, update, delete, upsert_fact, delete_fact |
asky_alignment_suggestions_write write | Generate alignment prompt suggestions, add your own, and decide them | generate, add, edit, accept, reject |
asky_alignment_claims_write write | Override a claim’s status or dismiss it | override_status, dismiss |
Website, traffic and AI crawlers
Your indexed website, its technical issues, and how AI crawlers fetch it.
| Tool | What it reads | Actions |
|---|---|---|
asky_website | Crawl and indexing health, your indexed pages with their citation metrics and Search Console impressions, and the hosts under your site | summary, pages, hosts |
asky_technical_issues | Technical and AI-crawlability issues by type or by affected page, and one issue type or page occurrence in full | by_type, type_detail, by_page, page_issue |
asky_crawlers | Site traffic from AI crawlers, from your access logs: per bot, over time, most-fetched paths, and individual visits | by_bot, timeseries, top_paths, visits |
asky_technical_write write | Start a technical audit, or mark a page issue resolved or reopened | start_audit, resolve_issue |
asky_crawler_log_import write | Import your own AI-crawler server logs |
Content
What to write next, the drafts in your library, and the runs that produce them.
| Tool | What it reads | Actions |
|---|---|---|
asky_content | Your content drafts, one draft in full, and its revisable outline | list, get, outline |
asky_content_opportunities | Recommended content to create per topic, scored, and one opportunity in full | list, get |
asky_workflows | Recent content-generation and audit runs, and one content run’s brief | list, run |
Brand knowledge
The documents that ground content and alignment, and search across them.
| Tool | What it reads | Actions |
|---|---|---|
asky_knowledge | Semantic search across your documents and website pages, the document list, one document in full, and a PDF download link | search, documents, document, file_url |
asky_knowledge_write write | Add documents from text or PDF, edit, re-sync or delete them | create_text, create_pdf, update, resync, delete |
Opportunities and tasks
What to do next, and the task tracker.
| Tool | What it reads | Actions |
|---|---|---|
asky_opportunities | One prioritized list across every opportunity type, plus platforms worth a listing and social discussions AI search already cites | overview, platforms, cited_discussions |
asky_tasks | Your opportunity task tracker, and one task in full | list, get |
asky_tasks_write write | Change a task’s status or owner, or delete it | update_status, set_owner, delete |
Community engagement
Reddit and LinkedIn discussions worth replying to, and what the engagement pipeline has done.
| Tool | What it reads | Actions |
|---|---|---|
asky_discussions | Which discussion to reply to first, the Discussions feed, live search, one thread with its comments, and one surfaced thread’s stored body | ranked, feed, search, thread, opportunity |
asky_communities | Communities AI engines cite but you have not joined, and a community’s own posted rules | citation_gap, rules |
asky_engagement | Replies published, every thread judged and why, lessons learned, a summary report, the discovery keywords, and the accounts that can post | published, judgments, learnings, report, keywords, identities |
asky_social_scans | Status of a discovery scan or the guided Reddit workflow | scan, workflow_runs |
asky_social_scan_start write | Start a Reddit or LinkedIn discovery scan |
Brand setup
Editing the brand itself. Mostly write tools.
| Tool | What it reads | Actions |
|---|---|---|
asky_writing_styles | Your named writing styles for articles and social channels, and one style in full | list, get |
asky_writing_styles_write write | Create, edit or delete writing styles | create, update, delete |
asky_brand_profile_write write | Edit the brand profile fields and its verified facts | update, add_fact, update_fact, delete_fact |
asky_topics_write write | Create, rename, move or delete topics | create, update, delete |
asky_tags_write write | Create, edit or delete tags and assign them to prompts and competitors | create, update, delete, set_prompt_tags, set_competitor_tags, add_to_prompts, remove_from_prompts, add_to_competitors, remove_from_competitors |