Skip to Content

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.

ToolWhat it readsActions
asky_whoamiWho you are and which workspaces you can access
asky_brandsYour brands (the starting point for almost every question)
asky_brand_profileYour brand identity, descriptions, markets with their languages, and products and services (categories, and the products and services inside them)
asky_brand_products_reviewHow 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_topicsYour topic tree
asky_audiencesWho the brand serves: audience profiles, the optional default and generation status
asky_audiences_write writeManage audience details, preferred article styles and linked products or knowledge documents. Changes require the existing write review.create, update, archive, set_default, generate
asky_modelsThe AI engines you are tracked across (for example ChatGPT, Perplexity, Google AI Overviews)
asky_tagsYour prompt and competitor tags
asky_connectionsWhich integrations are connected (Search Console, Webflow, WordPress, Cloudflare)
asky_usageHow much of your plan allowance is left

Visibility

How visible you are in AI answers, how that trended, what changed and why.

ToolWhat it readsActions
asky_visibilityYour AI-search visibility, sentiment and average rank; the trend over time; a diagnosis of what changed between two periods; and a per-topic health scoreboardoverview, trend, diagnosis, topic_scoreboard
asky_visibility_breakdownYour visibility and your competitors’, broken out per engine, per topic or per marketby_engine, by_topic, by_market
asky_fanoutsThe sub-queries AI engines run for themselves before they answer

Competitors

How you stack up against the competitors you track.

ToolWhat it readsActions
asky_competitorsShare-of-voice rankings, the list of tracked competitors, and brands that keep appearing but are not tracked yetrankings, list, candidates
asky_competitorOne 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_coverageWho leads each topic or funnel stage, and your gap to the leaderby_topic, by_funnel_stage
asky_competitor_sourcesWhich cited domains and pages name which competitors, and whether they name youmatrix, pages
asky_competitors_write writeAdd, edit, deactivate or delete competitors and the domains they publish oncreate, update, delete, add_address, remove_address

Citations

Which sources AI engines cite, and where you are missing from them.

ToolWhat it readsActions
asky_citationsCited 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 analyticsby_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.

ToolWhat it readsActions
asky_promptsYour tracked prompts, their per-prompt performance, and the log of changes to your tracking setuplist, metrics, activity_log
asky_promptOne prompt in depth: its KPIs and per-engine split, its answer history, and the sources cited for itdetail, responses, citations
asky_responsesEvery AI answer across all your prompts, newest first, with filters
asky_prompt_suggestionsAI-generated prompt suggestions awaiting review, and the status of a generation runlist, run_status
asky_prompts_write writeCreate prompts, move them between topics, change their markets, deactivate or activate them, delete them, or set their Prompt Typecreate, update, set_countries, deactivate, activate, delete, set_types
asky_prompt_suggestions_write writeGenerate prompt suggestions and accept, reject or edit themgenerate, edit, accept, reject
asky_localizationMarket 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 localesmarkets, coverage, family, jobs, catalog
asky_localization_write writeOpen markets and set their languages, generate localized drafts, edit, accept or discard them, and move prompts into familiessave_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.

ToolWhat it doesActions
asky_alignmentRead 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 queueprogram, facts, overview, fact, answers, sources, suggestions, positioning, perception, history, answer, source_history, fact_history, narrative
asky_alignment_fact_add writeFact add
asky_alignment_fact_edit writeFact edit
asky_alignment_fact_resume writeFact resume
asky_alignment_fact_delete writeFact delete
asky_alignment_fact_restore writeFact restore
asky_alignment_category_add writeCategory add
asky_alignment_category_rename writeCategory rename
asky_alignment_suggestions_run writeSuggestions run
asky_alignment_fact_suggestion_accept writeFact suggestion accept
asky_alignment_fact_suggestion_reject writeFact suggestion reject
asky_alignment_positioning_update writePositioning update
asky_alignment_statement_verdict writeCorrect how Asky read statements of an answer against a fact, or return them to Asky’s reading
asky_alignment_answer_recognition writeMark 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 writeCorrect the sentiment Asky read in passages of an answer about an attribute, or return them to Asky’s reading
asky_alignment_narrative_add writeAdd to the narrative
asky_alignment_narrative_edit writeEdit the narrative
asky_alignment_narrative_remove writeRemove 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.

ToolWhat it readsActions
asky_websiteCrawl and indexing health, your indexed pages with their citation metrics and Search Console impressions, and the hosts under your sitesummary, pages, hosts
asky_technical_issuesTechnical 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_crawlersSite traffic from AI crawlers, from your access logs: per bot, over time, most-fetched paths, and individual visitsby_bot, timeseries, top_paths, visits
asky_technical_write writeStart 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 runstart_audit, resolve_issue, suggest_fix, propose_fix, apply_fix, undo_fix, start_fix_run
asky_crawler_log_import writeImport 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.

ToolWhat it readsActions
asky_contentYour content drafts, one draft in full, its revisable outline, and the suggestions sent to a draftlist, get, outline, suggestions
asky_content_write writeChange 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 publishedupdate, suggest_edits, apply_edits, undo_edit, withdraw_suggestions
asky_content_opportunitiesRecommended content to create per topic, scored, and one opportunity in fulllist, get
asky_workflowsRecent content-generation and audit runs, and one content run’s brieflist, run

Brand knowledge

The documents that ground content and alignment, and search across them.

ToolWhat it readsActions
asky_knowledgeSemantic search across your documents, the document list, one document in full, and a PDF download linksearch, documents, document, file_url
asky_knowledge_write writeAdd documents from text or PDF, edit, re-sync or delete themcreate_text, create_pdf, update, resync, delete

Opportunities and tasks

What to do next, and the task tracker.

ToolWhat it readsActions
asky_opportunitiesOne prioritized list across every opportunity type, plus platforms worth a listing and social discussions AI search already citesoverview, platforms, cited_discussions
asky_tasksYour opportunity task tracker, and one task in fulllist, get
asky_tasks_write writeChange a task’s status or owner, or delete itupdate_status, set_owner, delete

Community engagement

Reddit and LinkedIn discussions worth replying to, and what the engagement pipeline has done.

ToolWhat it readsActions
asky_discussionsWhich discussion to reply to first, the Discussions feed, live search, one thread with its comments, and one surfaced thread’s stored bodyranked, feed, search, thread, opportunity
asky_communitiesCommunities AI engines cite but you have not joined, and a community’s own posted rulescitation_gap, rules
asky_engagementReplies published, every thread judged and why, lessons learned, a summary report, and the accounts that can postpublished, judgments, learnings, report, identities
asky_social_scansStatus of a discovery scan or the guided Reddit workflowscan, workflow_runs
asky_social_scan_start writeStart a discovery scan: 10 results across Reddit and/or LinkedIn

Brand setup

Editing the brand itself. Mostly write tools.

ToolWhat it readsActions
asky_writing_stylesYour named writing styles for articles and social channels, and one style in fulllist, get
asky_writing_styles_write writeCreate, edit or delete writing stylescreate, update, delete
asky_brand_profile_write writeEdit the brand profile fields and its products and services; have Asky read a product page or draft the list from your websiteupdate, add_product, update_product, delete_product, analyze_product, draft_products
asky_topics_write writeCreate, rename, move or delete topicscreate, update, delete
asky_tags_write writeCreate, edit or delete tags and assign them to prompts and competitorscreate, update, delete, set_prompt_tags, set_competitor_tags, add_to_prompts, remove_from_prompts, add_to_competitors, remove_from_competitors
Last updated on