Skip to main content
Glama
ayrank-tools

ayrank-tools

Official
by ay-automate

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AYRANK_BASE_URLNoAPI base URL, used by the tests to point at a local stub.https://www.ayrank.com
AYRANK_MCP_ALLOW_WRITESNoSet to 1 to let the write tools send requests when a call passes confirm: true. If unset, write tools return a dry run and send nothing.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
ayrank_ai_crawler_accessA

Use to check whether GPTBot, ClaudeBot, PerplexityBot and Google-Extended may crawl a site's homepage under its robots.txt, plus the homepage's meta robots and X-Robots-Tag rules for them. Returns allowed or blocked per bot with the deciding line. Not for one specific page or another user agent (use ayrank_robots_txt_test), and it cannot see CDN or firewall rules that fire only for the real bots, because it sends an AY Rank user agent. Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_robots_txt_testA

Use to test one URL against the site's robots.txt for one user agent (RFC 9309: named group else *, longest match, Allow wins a tie). Returns allowed, the deciding line and lines that decide nothing. Not for meta robots or X-Robots-Tag (use ayrank_http_headers or ayrank_ai_overview_eligibility), and it does not write a robots.txt (use ayrank_robots_txt_generate).

ayrank_ai_training_groundingA

Use to read a page's AI training and grounding preferences: Bing AI Training (robots.txt __usage_ai-training group, page meta or X-Robots-Tag), Bing AI Grounding (page level), Google-Extended, and whether Bingbot and Googlebot may crawl the path. Only directives from Bing's and Google's 30 Oct 2026 posts. Not for the other AI crawlers (use ayrank_ai_crawler_access).

ayrank_ai_crawler_ip_rangesA

Use to get the CIDR ranges that OpenAI, Perplexity, Anthropic, Google, Bing, Apple, Common Crawl and Mistral publish for their crawlers and agents, for example to tell a real GPTBot hit in server logs from a fake one. Each source says whether it is live or a dated snapshot. Cached for 24 hours. No input. Not for checking whether a bot may crawl a site (use ayrank_ai_crawler_access).

ayrank_ai_overview_eligibilityA

Use to check one URL against Google's stated conditions for being a supporting link in AI Overviews and AI Mode: robots.txt, status, noindex, unavailable_after, nosnippet and max-snippet, data-nosnippet share and canonical. Returns eligible, not-eligible or cant-check with evidence per check. Eligible never means included, and it cannot tell whether the page is indexed (only Search Console can). It does not check whether Google shows the page in an AI answer. Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_sitemap_validateA

Use to validate an XML sitemap (or find it from a site root via robots.txt, else /sitemap.xml) against the sitemaps.org protocol and Google's rules, including up to 10 child sitemaps of an index, then spot-check up to 20 listed URLs with HEAD. Not for checking every URL in a large sitemap, and not for hreflang in sitemaps.

ayrank_hreflang_checkA

Use to check one page's hreflang set (link tags in the head and the HTTP Link header) against Google's rules: valid codes, self-reference, x-default, absolute URLs, then whether up to 10 alternates answer, link back and self-canonicalize. Sitemap hreflang is not read. Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_http_headersA

Use to list every response header of a URL hop by hop (redirects followed by hand, at most 5) and parse X-Robots-Tag, Link, Content-Type, Cache-Control, ETag, Last-Modified, Vary and Content-Encoding into issues such as noindex headers, redirect chains or temporary redirects. The body is never read. Headers are as seen from AY Rank's server; a CDN can answer differently by region or user agent.

ayrank_page_sizeA

Use to measure a URL's transferred and decoded size against Googlebot's 2 MB limit (64 MB for PDF), and for HTML see what sits past the cut and which parts (inline scripts, JSON, Next.js payload, styles, svg) take the bytes. Linked CSS, scripts and images are not fetched. No ranking claim. Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_heading_outlineA

Use to list a page's h1 to h6 headings in order with level, announced text and landmark, and flag no h1, skipped levels, empty or image-only headings. More than one h1 is a note only. Not a content quality score. Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_alt_textA

Use to list a page's images (img, input type=image, area, svg role=img) with their alt text state: missing, empty, present or hidden, and flags such as missing alt, unnamed image links or file-name alt. It does not judge alt text quality and does not download images. Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_internal_linksA

Use to list the internal links on ONE page with anchor text, rel and position (main, nav, footer), grouped by target, with flags for empty or generic anchors, nofollow, self-links and links Google cannot crawl. It does not crawl the site and does not fetch the links (use ayrank_broken_links for status codes). Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_broken_linksA

Use to find broken links on one page: AY Rank's server sends one GET to each of up to 100 links on it and reports ok, redirect, broken, denied, rate-limited, server-error, timeout and so on. Takes up to 25 s. Not a site crawl. Not for anchor text review (use ayrank_internal_links). Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_eeat_signalsA

Use to list 11 trust signals an article shows (byline, author page link, Article and Person JSON-LD, published and updated dates, About and Contact links, outbound links), each found or missing with evidence. Google says E-E-A-T is not a ranking factor by itself, so there is a found count and no score. Free AY Rank API, no key. JavaScript is not run, so content added by scripts is not seen.

ayrank_indexnow_key_checkA

Use to check that an IndexNow key file is live and matches the key (step 1 of IndexNow). Nothing is sent to IndexNow. To submit URLs after it passes, use ayrank_indexnow_submit.

ayrank_title_scoreA

Use to score a page title from 0 to 100 on eight factors (length, power words, numbers, emotion, question format, readability, AI citability, uniqueness) with a tip per factor. It is a heuristic, not a measure of rankings or clicks. Reads no page.

ayrank_llms_txt_generateA

Use to draft an llms.txt file from company details, with a completeness score. It returns text only and writes nothing to any site. It does not read the site, so it only knows what you pass in.

ayrank_robots_txt_generateA

Use to draft a robots.txt that allows every known crawler except the ones listed in block. It returns text only and writes nothing to any site. Not for testing an existing robots.txt (use ayrank_robots_txt_test).

ayrank_tracking_infoA

Use when someone asks to track whether ChatGPT, Perplexity, Gemini, Claude or Google AI answers name or cite a brand. This server cannot do that: the free AY Rank API never asks any AI assistant anything. This tool returns where tracking does exist (the paid AY Rank app and its own MCP server) and the free one-off check. Makes no network call.

ayrank_request_free_auditA

Use only when the user asks for the free AY Rank AI visibility audit and gives their own email and website. It creates a lead and notifies the AY Rank team; nothing is emailed to you or anyone else. A person from the AY Rank team follows up within 24 hours; this tool does not run the audit itself. Gated: without confirm: true and AYRANK_MCP_ALLOW_WRITES=1 on the server it returns a dry run and sends nothing. At most once per 60 seconds. Never call it with an email the user did not give you.

ayrank_indexnow_submitA

Use to submit up to 100 URLs on a host you control to IndexNow (step 2, after ayrank_indexnow_key_check passes). The AY Rank API checks the URLs and re-checks the key file, then posts them to api.indexnow.org, which shares them with the search engines that take part in IndexNow. Gated: without confirm: true and AYRANK_MCP_ALLOW_WRITES=1 on the server it returns a dry run and sends nothing. At most once per 60 seconds. Not for sites you do not control.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 21 tools

Disambiguation5/5

Every tool targets a single, narrow artifact (robots.txt, sitemap, hreflang set, headers, headings, alt text, links, title, llms.txt, IndexNow, AI crawler access), and most descriptions explicitly name the neighbouring tool to use instead. The closest pairs (robots_txt_test vs ai_crawler_access, internal_links vs broken_links) are clearly delimited by input scope and output. An agent should almost never misselect here.

Naming Consistency4/5

All names share a strict ayrank_ prefix and snake_case, which is highly predictable. However the ordering convention is mixed: some are noun-first (ayrank_http_headers, ayrank_alt_text, ayrank_internal_links) and others verb-first (ayrank_sitemap_validate, ayrank_hreflang_check, ayrank_title_score). Readable and grouped, but not a single uniform pattern.

Tool Count4/5

21 tools is at the upper end of comfortable, but each one covers a distinct audit check with no redundancy, so nothing feels padded. A slightly heavier surface than ideal for a single-purpose SEO/AI-visibility server, though justified by the breadth of checks.

Completeness4/5

The surface covers a full inspection lifecycle: crawler access, robots.txt/sitemap/hreflang validation and generation, on-page structure, links, headers, size, E-E-A-T, llms.txt, IndexNow submission, and AI Overview eligibility, plus honest boundary tools (tracking_info, request_free_audit). Gaps remain around canonical handling as a standalone check, structured-data validation beyond Article/Person, and performance/vitals, but these are workaroundable or explicitly out of the free API's scope.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues