Agent Tools Reference
The AI agent has access to 80+ tools organized into categories. Here is the complete reference.
SEO Audit and Technical
| Tool | What It Does |
|---|---|
| seo_audit | Deep crawl up to 1,000 pages. Scores the site and reports issues with fix recommendations. |
| metadata_check | Checks title tag, meta description, OG tags, canonical, and other meta elements for any URL. |
| pagespeed_check | Runs Google PageSpeed Insights and reports Core Web Vitals, performance score, and opportunities. |
| heading_check | Analyzes the heading structure (H1 through H6) for hierarchy and SEO issues. |
| broken_link_check | Crawls a page and identifies broken internal and external links. |
| redirect_check | Follows redirect chains and reports each hop, status code, and final destination. |
| canonical_check | Verifies canonical tags and detects issues like canonical loops or mismatches. |
| structured_data | Finds and validates JSON-LD structured data on a page. |
| http_headers | Inspects HTTP response headers including security headers, caching, and server info. |
| robots_check | Reads and analyzes the robots.txt file for issues and blocked resources. |
| sitemap_check | Validates XML sitemaps: parses URLs, checks accessibility, and reports errors. |
| internal_links | Maps all internal links on a page and categorizes them. |
| og_debug | Previews how a page appears when shared on social media by inspecting Open Graph tags. |
| bulk_status | Checks HTTP status codes for multiple URLs at once. |
| dns_lookup | Looks up DNS records (A, AAAA, CNAME, MX, TXT, NS) for any domain. |
| global_latency_test | Tests HTTP response times from 20 locations worldwide. |
Content and Keywords
| Tool | What It Does |
|---|---|
| keyword_research | AI-powered keyword suggestions with search volume estimates and difficulty. |
| content_brief | Generates a comprehensive content brief with outline, target keywords, and SEO recommendations. |
| ai_meta_writer | Writes optimized title tags and meta descriptions for any page. |
| content_analyze | Analyzes existing content for readability, keyword usage, and optimization opportunities. |
| content_gap | Compares your page with a competitor to find missing topics and keywords. |
| content_ideas | Generates AI-powered content topic ideas based on your existing Search Console data. |
| topic_authority | Clusters your keywords into topics and measures your authority in each. |
| serp_analysis | Analyzes the live search results for any keyword, breaking down what ranks and why. |
| gap_zone_analysis | Finds striking-distance keywords (positions 5-20) with optimization recommendations. |
| competitor_serp_analysis | Compares your rankings with a competitor for shared keywords. |
| anchor_text | Analyzes the anchor text distribution of links on a page. |
Data and Analytics
| Tool | What It Does |
|---|---|
| search_console_queries | Pulls top search queries from Google Search Console with clicks, impressions, CTR, and position. |
| search_console_pages | Pulls top pages from Search Console. |
| search_console_dates | Gets daily performance trends from Search Console. |
| analytics_stats | Gets traffic stats (pageviews, visitors, bounce rate, duration) from your configured analytics provider. |
| analytics_pageviews | Gets pageview time series data for charts. |
| ahrefs_overview | Fetches domain rating, backlinks, referring domains, and organic traffic from Ahrefs. |
| ahrefs_backlinks | Gets top backlinks with anchor text and source info. |
| ahrefs_keywords | Gets top organic keywords with positions, volume, and traffic. |
| position_tracker_list/add/delete | Manages tracked keywords for position monitoring. |
Site Inventory & Crawl
These tools work against the persistent crawl of the user's own site (run from /crawls). The agent prefers them over live-fetch tools when the question is about the user's pages.
| Tool | What It Does |
|---|---|
| search_site_content | Full-text (FTS5) search over crawled title / H1 / body text. |
| semantic_search | Semantic search over the user's pages via embeddings (cosine similarity). |
| find_similar_pages | Given a seed page URL, finds semantically similar pages on the same site. |
| get_site_inventory | Lists current-crawl pages, optional filter by issue type (noindex, errors, slow). |
| find_orphan_pages | Lists pages with zero internal inbound links. |
| get_page_detail | Full detail for one page (headings, schema types, redirect chain, link counts). |
| get_page_inbound_links / get_page_outbound_links | Walks the internal link graph for a page. |
| audit_anchor_text | Site-wide anchor-text distribution audit (over-optimization, empty anchors, naked URLs). |
| get_link_summary | Site-wide internal-linking summary: top sources, top destinations, orphan count. |
| get_linking_suggestions | Open internal-linking suggestions, optionally scoped to one source page. |
Topical Maps
| Tool | What It Does |
|---|---|
| list_topical_maps | Lists the user's saved topical maps for a site. |
| get_topical_map | Lists clusters in a specific map (id, name, authority, query/page counts). |
| get_cluster_context | Hydrated detail for one cluster: queries with metrics, assigned pages, pillar page, gap topics. |
| regenerate_topical_map | Generates a fresh topical map for a site from current GSC queries. |
Fact Store (What Changed)
| Tool | What It Does |
|---|---|
| query_facts | Lists currently-valid facts about a page, or returns the site-wide recent-changes feed. |
| get_fact_history | Walks back the history of one (page, predicate) pair across time. |
| get_fact_consensus | Combines per-source observations into a consensus value with effective confidence (noisy-OR). |
| list_contradictions | Surfaces material changes detected since you last looked: title rewrites, ranking shifts, audit collapses, cross-source disagreements. |
| resolve_contradiction | Marks a contradiction as 'noise', 'meaningful', or 'fixed'. |
| record_fact | Records a durable user-stated fact (target keyword, focus areas, competitors, etc.). Source is agent_msg. |
Management
| Tool | What It Does |
|---|---|
| uptime_monitor_create/update/delete | Creates and manages uptime monitors with per-monitor notification channels. |
| uptime_monitors_list | Lists all monitors with current status. |
| uptime_history | Gets check history for a specific monitor. |
| create/list/update/delete_schedule | Manages scheduled reports with multi-channel delivery. |
| sites_list/site_add/site_delete | Manages tracked sites. |
| alerts_list/alert_update | Manages alert settings. |
| plan_steps | Outlines a multi-step plan before complex requests. |
| handoff | Delegates to a specialist sub-agent (SEO Audit, Content, Analytics). |
| request_approval | Asks for user confirmation before lasting actions. |
| clear_cache | Clears cached API responses. |