Rank by Ouroboros Apps MCP server

Rank by Ouroboros Apps

Rank by Ouroboros Apps answers SEO questions from the Google Search Console account you connect. It is for site owners, bloggers, small businesses, and SEO freelancers who want those numbers inside ChatGPT, Claude, Gemini, Grok, Cursor, or any other MCP client that speaks Streamable HTTP and OAuth.

The assistant can list verified properties, read top queries and pages, follow clicks, impressions, CTR, and average position over time, compare two periods, find queries with high impressions and low CTR, see pages that dropped, and check URL Inspection status. Every metric comes from the Search Console API response. Rank does not estimate traffic or fill in days the API left out. CTR stays the fraction Search Console returned (0.02 is 2%).

A 14-day trial starts when you connect Google. After that, Pro is a Stripe subscription. The amount is shown at Stripe Checkout, not in this README or the product.

Hosted server

• MCP server URL: https://rank.ouroborosapps.com/mcp (Streamable HTTP, OAuth sign-in)
• Docs: https://ouroborosapps.com/docs/rank
• Status: early access. Paste the URL into Claude, Cursor, Grok, or ChatGPT developer mode.
• Registry name: io.github.LAHutchins91/rank

Connect an assistant

The MCP address is https://YOUR_HOST/mcp after deploy, or http://127.0.0.1:44721/mcp when you run it locally. Choose OAuth and leave the client id and secret empty. Rank supports dynamic client registration and PKCE.

Cursor, in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rank": {
      "url": "http://127.0.0.1:44721/mcp"
    }
  }
}

Claude Code:

claude mcp add --transport http rank http://127.0.0.1:44721/mcp

Use the same URL for ChatGPT, Claude, Gemini, and Grok. The in-app connect page repeats these steps for the host in APPBASEURL.

Tools

• list_properties — verified Search Console properties
• top_queries — queries for a date range
• top_pages — pages for a date range
• performance_trends — daily clicks, impressions, CTR, and position
• compare_periods — totals for two ranges, plus differences labeled as derived from those totals
• quick_wins — queries at or above an impression threshold and at or below a CTR threshold
• dropped_pages — pages whose position worsened, whose clicks fell, or that disappeared from the current response
• inspect_url — URL Inspection API result
• account_status — whether Google is connected and whether the trial or Pro subscription is active

If you omit dates, Rank uses a 28-day window ending three UTC days ago and says so in the result. Pass startDate and endDate (YYYY-MM-DD) to choose the window.

Google Cloud OAuth client

Create an OAuth client of type Web application. Rank reads:

• GOOGLECLIENTID
• GOOGLECLIENTSECRET

Authorized redirect URI, exactly, with no trailing slash on the origin:

${APP_BASE_URL}/google/callback

Locally, with the default APPBASEURL, that is:

http://127.0.0.1:44721/google/callback

Add these scopes on the OAuth consent screen:

• openid
• https://www.googleapis.com/auth/userinfo.email
• https://www.googleapis.com/auth/webmasters.readonly

webmasters.readonly is the Search Console read-only scope. Rank requests offline access so Google returns a refresh token. The refresh token is encrypted before it is stored. TOKENENCRYPTIONKEY is the key (a long random string). If the key changes, existing tokens cannot be read and the account has to connect Google again.

If the Google console asks for an authorized JavaScript origin, use the origin of APPBASEURL (http://127.0.0.1:44721 locally). The redirect URI above is the value that must match.

Storage

Trial state, Stripe customer ids, MCP OAuth clients and tokens, pending Google sign-in, and the encrypted Google refresh token share one storage interface. Set STORAGE_BACKEND:

Shortened. The full README is on GitHub.