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, markets with their languages, and products and services (categories, and the products and services inside them) | |
asky_brand_products_review | How complete your products and services are against the record spec: what each is missing, unlinked product pages on your site, and what to do next | |
asky_topics | Your topic tree | |
asky_audiences | Who the brand serves: audience profiles, the optional default and generation status | |
asky_audiences_write write | Manage audience details, preferred article styles and linked products or knowledge documents. Changes require the existing write review. | create, update, archive, set_default, generate |
asky_models | The AI engines you are tracked across (for example ChatGPT, Perplexity, Google AI Overviews) | |
asky_tags | Your prompt and competitor tags | |
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; the same rate and share per domain or URL day by day; one domain in depth; pages that cite competitors but never mention you; and page-level competitor-mention analytics | by_url, by_domain, domain_trend, url_trend, 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, deactivate or activate them, delete them, or set their Prompt Type | create, update, set_countries, deactivate, activate, delete, set_types |
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, accept or discard them, and move prompts into families | save_market, remove_market, localize, cancel, edit_preview, accept, discard, move |
Brand alignment
The brand facts and positioning your team maintains, the answers AI engines give, and the sources those answers cite. Asky writes the monitoring questions. Historical scan evidence is preserved when facts change.
| Tool | What it does | Actions |
|---|---|---|
asky_alignment | Read the program, facts, results, how AI positions and describes the brand, trends across scans (the brand, one fact, one cited source), the narrative you track (with the pages behind each line), answer evidence and suggestion queue | program, facts, overview, fact, answers, sources, suggestions, positioning, perception, history, answer, source_history, fact_history, narrative |
asky_alignment_fact_add write | Fact add | |
asky_alignment_fact_edit write | Fact edit | |
asky_alignment_fact_resume write | Fact resume | |
asky_alignment_fact_delete write | Fact delete | |
asky_alignment_fact_restore write | Fact restore | |
asky_alignment_category_add write | Category add | |
asky_alignment_category_rename write | Category rename | |
asky_alignment_suggestions_run write | Suggestions run | |
asky_alignment_fact_suggestion_accept write | Fact suggestion accept | |
asky_alignment_fact_suggestion_reject write | Fact suggestion reject | |
asky_alignment_positioning_update write | Positioning update | |
asky_alignment_statement_verdict write | Correct how Asky read statements of an answer against a fact, or return them to Asky’s reading | |
asky_alignment_answer_recognition write | Mark that an Unresolved identity answer did recognize the brand, optionally with its statements’ verdicts, or return it to Asky’s reading | |
asky_alignment_attribute_sentiment write | Correct the sentiment Asky read in passages of an answer about an attribute, or return them to Asky’s reading | |
asky_alignment_narrative_add write | Add to the narrative | |
asky_alignment_narrative_edit write | Edit the narrative | |
asky_alignment_narrative_remove write | Remove from the narrative |
Writes follow the same plan limits and permissions as the app. Fact setup optimization remains a staff preview. Legacy prompt and claim tools are retired.
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, one issue type or page occurrence in full, and how a fix for it would apply on your site (Automatic or Manual) | by_type, type_detail, by_page, page_issue, fix_context |
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; technical fixes on plans that include them: suggest or propose a fix, apply an approved one to your CMS, undo it, or start a bulk suggestion run | start_audit, resolve_issue, suggest_fix, propose_fix, apply_fix, undo_fix, start_fix_run |
asky_crawler_log_import write | Import your own AI-crawler server logs |
Content
What to write next, the drafts in your library and changes to them, and the runs that produce them.
| Tool | What it reads | Actions |
|---|---|---|
asky_content | Your content drafts, one draft in full, its revisable outline, and the suggestions sent to a draft | list, get, outline, suggestions |
asky_content_write write | Change a draft’s title, meta description, slug or plain CMS fields; suggest edits your team reviews in the editor, apply edits directly, undo an applied edit, or withdraw suggestions nobody has reviewed yet. Changes stay in Asky until the draft is published | update, suggest_edits, apply_edits, undo_edit, withdraw_suggestions |
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, 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, and the accounts that can post | published, judgments, learnings, report, identities |
asky_social_scans | Status of a discovery scan or the guided Reddit workflow | scan, workflow_runs |
asky_social_scan_start write | Start a discovery scan: 10 results across Reddit and/or LinkedIn |
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 products and services; have Asky read a product page or draft the list from your website | update, add_product, update_product, delete_product, analyze_product, draft_products |
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 |