Help center / Copilot & API

The MCP server

Connect Claude or any MCP-capable assistant to your RankYak account.

The Model Context Protocol (MCP) is an open standard that lets an AI assistant connect to outside tools and act through them. RankYak hosts an MCP server, so an assistant you already use, such as Claude, may read and manage your RankYak projects from its own chat: looking up keywords, scheduling articles, or publishing changes, without you opening the app.

Connecting a client

The server is available at https://rankyak.com/mcp. Any MCP-capable client may connect; add the URL wherever your client configures remote MCP servers, typically under connectors or integrations in its settings. The URL is all RankYak needs.

The first time the client connects, it opens a RankYak page in your browser. Sign in if you are not already, review the request, and click Authorize; the window closes on its own and the client is connected. There is no API key to create or paste. The authorization is granted to that specific client, and you may repeat the flow on as many clients as you like.

What a connected assistant may do

A connected assistant receives the same tool set as the copilot inside the app, so it works with your account through the same actions.

Area What the assistant may do
Projects List your projects and update project settings, including the article schedule, automation toggles, and image and video options.
Performance Read the project's search impressions and clicks from Google Search Console, which keywords are already covered by an article or a ranking page, and backlink counts.
Keywords and topics List keywords, add new ones, star or archive them, and archive or restore topics.
Content plan Read the calendar, schedule a keyword on an upcoming date, and regenerate the plan.
Articles Read articles, edit their content, record feedback, and browse or restore revisions.
Publishing Publish an article, push edits to your connected platform, or record the URL where you published an article yourself.
Goal pages Create, update, and delete goal pages.
Integrations Connect WordPress or Webflow, disconnect an integration, and manage the Google Search Console connection.
Organizations See an organization's members, invite new ones or cancel pending invitations, and rename an organization.

The same mechanics apply as in the app. Articles are written in the early morning of their scheduled date, so an assistant asked for an article will add the keyword and schedule it rather than produce the article immediately. Shopify, Wix, and WordPress.com connect through their own sign-in flows, so those integrations may only be set up in the RankYak app.

What stays in the app

Billing, subscriptions, and plan changes are handled only in the RankYak app, as is deleting projects, organizations, or members. A connected assistant knows this and will direct you to the right page rather than attempt it.

Access and expiry

An authorization is tied to your user account, so a connected assistant sees exactly the organizations and projects you may access yourself. While the client is in regular use, its access renews automatically. An authorization that goes unused for thirty days expires, and the client will ask you to authorize again the next time it connects. To disconnect an assistant sooner, remove the RankYak server from the assistant's own settings; RankYak does not currently list connected assistants in the app.

If you would like to build your own integration rather than connect an assistant, see the API.

Still need help?

Ask the copilot inside RankYak for an instant answer about your own account, or send us an email and a human will get back to you.