The MCP server gives your AI agent your AY Rank data. A skill tells it which workflow to run: the steps, the tools, and when to ask you first.
Your workspace through one key: AI answers, ranks, cited sites, the action plan, keyword research, and the Content studio from brief to publish.
A SKILL.md with the steps in order, the tools each step calls, whether it uses credits, and the points where it stops for your yes.
Create a key in AY Rank under Settings, Agent & API access. Put it in place of ayr_key_... below.
claude mcp add --transport http ayrank https://app.ayrank.com/api/mcp --header "Authorization: Bearer ayr_key_..."
for s in setup plan ai-visibility-audit ai-mode-gap keyword-research competitor write-page update-page keywords-to-published weekly-review; do mkdir -p ~/.claude/skills/ayrank-$s && curl -fsSL https://app.ayrank.com/docs/skills/$s/SKILL.md -o ~/.claude/skills/ayrank-$s/SKILL.md; done
Or install one at a time with the line on each skill below. Each goes to ~/.claude/skills/ayrank-<name>/SKILL.md.
Ask in plain words, for example “what should I work on this week?”. Claude Code picks the skill that fits. Six of them are also MCP prompts: type /mcp__ayrank__plan to start one by name.
Each card lists the MCP tools the skill calls and whether it uses credits.
Connect AY Rank, see what it knows about the business, and pick what to do first.
A check that the connection works, and a short brief of the workspace: the business, its voice, what is tracked and what this key may do.
get_contexttracking_statusget_house_rulesmkdir -p ~/.claude/skills/ayrank-setup && curl -fsSL https://app.ayrank.com/docs/skills/setup/SKILL.md -o ~/.claude/skills/ayrank-setup/SKILL.mdThe tasks worth doing first, with who does each, why, its value a month and the page it is about. Nothing starts until you choose.
get_contextget_action_planmkdir -p ~/.claude/skills/ayrank-plan && curl -fsSL https://app.ayrank.com/docs/skills/plan/SKILL.md -o ~/.claude/skills/ayrank-plan/SKILL.mdWhere AI answers name the business, where they name others, and the sites that decide it.
Where AI answers name you and where they name rivals instead, the sites AI cites, and up to five fixes with their evidence.
get_contextai_visibilitycompetitorsshare_shiftsquestion_detailcited_sitescitation_trendsite_detailplan_actionmkdir -p ~/.claude/skills/ayrank-ai-visibility-audit && curl -fsSL https://app.ayrank.com/docs/skills/ai-visibility-audit/SKILL.md -o ~/.claude/skills/ayrank-ai-visibility-audit/SKILL.mdFor one best-of search: your Google rank, whether Google AI Mode names or cites you, and who it picks from the top 10 instead.
get_contextkeywords_listai_visibilitygoogle_searchask_aiplan_actionmkdir -p ~/.claude/skills/ayrank-ai-mode-gap && curl -fsSL https://app.ayrank.com/docs/skills/ai-mode-gap/SKILL.md -o ~/.claude/skills/ayrank-ai-mode-gap/SKILL.mdKeywords worth targeting and one competitor against the business.
Keywords worth targeting, with volume, difficulty and intent, sorted into money keywords, quick wins and growth. The ones you pick get tracked.
get_contextkeywords_listkeywords_opportunitiesmoney_keywordskeywords_searchkeywords_trackmkdir -p ~/.claude/skills/ayrank-keyword-research && curl -fsSL https://app.ayrank.com/docs/skills/keyword-research/SKILL.md -o ~/.claude/skills/ayrank-keyword-research/SKILL.mdOne rival against you: where AI names each of you, questions won and lost head to head, how AI describes both, and the sites that decide it.
competitorscompany_detailshare_shiftscited_sitessite_detailplan_actionmkdir -p ~/.claude/skills/ayrank-competitor && curl -fsSL https://app.ayrank.com/docs/skills/competitor/SKILL.md -o ~/.claude/skills/ayrank-competitor/SKILL.mdWrite new pages and update live ones, with a yes from the person before anything is approved or published.
A new page for a keyword, question or topic: the brief, the draft with its checks, then published, scheduled or exported after your yes.
keywords_searcharticle_createarticle_writearticle_save_draftarticle_approvearticle_publisharticle_schedulearticle_exportarticle_mark_publishedmkdir -p ~/.claude/skills/ayrank-write-page && curl -fsSL https://app.ayrank.com/docs/skills/write-page/SKILL.md -o ~/.claude/skills/ayrank-write-page/SKILL.mdThe exact edits for a live page (where, today's text, the new text) with their checks, sent to your site or exported as a checklist.
article_createarticle_update_pagearticle_writearticle_edit_briefarticle_save_draftarticle_approvearticle_publishchannels_listarticle_exportarticle_mark_publishedpublication_statuswork_log_listmkdir -p ~/.claude/skills/ayrank-update-page && curl -fsSL https://app.ayrank.com/docs/skills/update-page/SKILL.md -o ~/.claude/skills/ayrank-update-page/SKILL.mdThe whole path in one session: research keywords, track the best, write an article for one, publish it and check it is logged.
get_contextkeywords_searchkeywords_trackkeywords_listarticle_createarticle_writearticle_approvechannels_listarticle_publisharticle_schedulepublication_statuswork_log_listresults_summarymkdir -p ~/.claude/skills/ayrank-keywords-to-published && curl -fsSL https://app.ayrank.com/docs/skills/keywords-to-published/SKILL.md -o ~/.claude/skills/ayrank-keywords-to-published/SKILL.mdWhat changed, why, and what to do about it.
What moved this week in AI answers and on Google, why it moved, and the three moves that matter most, with numbers.
get_contextai_visibilityrank_moverslist_signalsmoney_keywordsget_action_plankeyword_detailshare_shiftscompany_detailquestion_detailmkdir -p ~/.claude/skills/ayrank-weekly-review && curl -fsSL https://app.ayrank.com/docs/skills/weekly-review/SKILL.md -o ~/.claude/skills/ayrank-weekly-review/SKILL.mdA SKILL.md file: a name, a line that says when to use it, and the steps to follow. Claude Code reads the descriptions of your installed skills and runs the one that fits what you ask.
Yes. The skills only describe the workflow. The AY Rank MCP server gives your agent the data and the tools the steps call, with a workspace key from Settings, Agent & API access.
Installing them is free. Reading your data is free. Steps that run live research or write pages use credits, and each skill asks you before the first one.
No. Every skill asks for your yes before it changes the workspace, approves a page or publishes one. Publishing live needs a second confirmation.
Six of the workflows are also MCP prompts, so any MCP app that shows prompts can start them. In ChatGPT and other MCP apps, connect the server and paste a skill's workflow as your first message.
Yes. It is a plain text file in ~/.claude/skills. Change the steps to fit how you work. Run the install line again to get our latest version.
Start a 7-day free trial, create a key, and run your first skill.