SEO Perception

com.seoperceptionPublished by seoperception.comOfficial publisherv2.1.0Updated Oct 26, 2026

Search Console, crawl, and SEO to-dos in Cursor and Claude. OAuth or token; close to-dos optionally.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & Analytics

Overview

AI-generated overview

Hosted SEO Perception MCP server that lets an assistant read stored Google Search Console data, crawl results and prioritized SEO to-dos for your sites.

What you can do
  • List owned sites with stored Search Console and crawl freshness, and summarize search performance, leading pages, queries and rank momentum
  • Search and filter stored query evidence by content match, position band, impressions, landing page, CTR and intent
  • Review prioritized SEO opportunities and page diagnostics combining crawl metadata, trends, top queries and to-dos
  • Find content and snippet gaps, content decay, keyword cannibalization and internal-link suggestions
  • Mark existing to-dos done or ignored, only when the optional write scope is granted
When to use it
Useful when you already use SEO Perception and want an assistant in Cursor, Claude, VS Code or another MCP client to reason about your stored Search Console and crawl evidence and draft page edits. It is not a live Google Search Console connector and does not crawl on demand.
Requirements
Remote Streamable HTTP endpoint at seoperception.com; nothing to install locally. OAuth 2.1 sign-in with dynamic client registration and PKCE, or a personal access token sent as a Bearer token, stored as the environment variable SEOPERCEPTION_MCP_TOKEN for clients without OAuth. An active Starter, Pro, Business or Enterprise plan is needed after the 7-day trial.
Before you install
OAuth Connect requests both the read scope and the optional scope that lets the assistant close to-dos; a token can also be created with closing enabled. Closing marks to-dos done or ignored, ignore is permanent and needs a reason, and bulk changes by issue type or URL preview until confirmed. Never put your password or session cookie in a config; revoke tokens under Account > MCP. Results may be sent to your client's model provider, so treat them as sensitive site analytics.

Installation

In SourceWeft

  1. Open SEO Perception in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.seoperception%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "seo-perception": {
      "type": "http",
      "url": "https://seoperception.com/mcp"
    }
  }
}

README

[SEO Perception logo]

SEO Perception MCP

Search Console, the crawl, and your SEO to-dos — inside Cursor, Claude, VS Code, and other MCP clients.

Docs · Website · MCP Registry

This repository lists the hosted SEO Perception MCP server in MCP directories. It contains documentation and client configuration only. There is nothing to install or run locally: the server runs at https://seoperception.com/mcp.

SEO Perception stores weekly Google Search Console facts, a crawl of your site, and Possibilities (a prioritized fix list per URL). The MCP server lets your AI assistant read that same workspace and draft the next edit on a page, based on stored evidence instead of guesses.

At a glance

Endpointhttps://seoperception.com/mcp
TransportStreamable HTTP (plain JSON responses)
AuthOAuth 2.1 with dynamic client registration and PKCE, or a personal access token as Authorization: Bearer <token>
Scopesmcp:read (always). mcp:possibilities (optional: mark existing to-dos done or ignored)
Tools10. Nine read stored data. One can close Possibilities when that scope is granted.
MCP Registry namecom.seoperception/mcp
Server card/.well-known/mcp/server-card.json

Plan

Start with a 7-day Starter trial (MCP included). After the trial, OAuth, personal tokens, and the MCP endpoint need an active Starter, Pro, Business, or Enterprise plan. See pricing.

Tools

Nine tools read data SEO Perception has already collected. They never call Google live. seoperception_update_possibilities is the only write: it marks existing Possibilities done or ignored, and only when the connection includes mcp:possibilities. A connection with only mcp:read cannot change anything. OAuth Connect asks for both scopes. A personal token can close Possibilities only if you turn that on when you create it. Tokens you already created stay read-only.

ToolTitleWhat it does
seoperception_list_sitesList sitesList owned websites with stored GSC and crawl freshness.
seoperception_get_site_overviewSite overviewSummarize stored search performance, leading pages, queries, and rank momentum.
seoperception_search_queriesSearch queriesSearch and filter stored query evidence by content match, position band, impressions, landing page, CTR, and intent.
seoperception_list_opportunitiesSEO opportunitiesList stored Possibilities. Filter by status, issue type, or URL, or ask for a summary grouped by type.
seoperception_update_possibilitiesClose PossibilitiesMark existing Possibilities done or ignored by id, issue type, or URL. Requires mcp:possibilities. Ignore needs a reason.
seoperception_get_page_diagnosticsPage diagnosticsCombine one page's crawl metadata, stored GSC trends, top queries, and possibilities.
seoperception_find_content_gapsContent and snippet gapsFind stored low-CTR, missing-query, title/snippet, question, and refresh opportunities.
seoperception_find_content_decayContent decayDetect sustained stored click and position declines from open refresh-candidate rows.
seoperception_find_cannibalizationKeyword cannibalizationFind stored query conflicts and the deterministic preferred page.
seoperception_suggest_internal_linksInternal-link suggestionsReturn stored destination and anchor opportunities without crawling or probing URLs.

Most tools take a siteId. Ask the assistant to list your sites first and it will pick it up.

Setup

Clients that support OAuth open a browser sign-in the first time they connect. No token needed.

If your client does not support OAuth, sign in to SEO Perception, open Account > MCP, create a personal access token (shown once), and store it as the environment variable SEOPERCEPTION_MCP_TOKEN. Then use the "token" variant of the config.

Cursor

Install the SEO Perception plugin from the Cursor Marketplace (once listed), or add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

json
{  "mcpServers": {    "seo-perception": {      "url": "https://seoperception.com/mcp"    }  }}

Cursor shows a sign-in prompt for the server. Token variant:

json
{  "mcpServers": {    "seo-perception": {      "url": "https://seoperception.com/mcp",      "headers": {        "Authorization": "Bearer ${env:SEOPERCEPTION_MCP_TOKEN}"      }    }  }}

Claude.ai and Claude Desktop (connectors)

  1. Open Settings > Connectors.
  2. Choose Add custom connector.
  3. Name: SEO Perception. URL: https://seoperception.com/mcp.
  4. Click Add, then Connect and approve the SEO Perception sign-in.

Custom connector availability depends on your Claude plan.

Claude Code

bash
claude mcp add --transport http seo-perception https://seoperception.com/mcp

Then run /mcp inside Claude Code and choose Authenticate.

VS Code (GitHub Copilot agent mode)

Add to .vscode/mcp.json in your project, or run MCP: Add Server from the Command Palette and pick HTTP:

json
{  "servers": {    "seo-perception": {      "type": "http",      "url": "https://seoperception.com/mcp"    }  }}

VS Code starts the OAuth sign-in when the server first connects.

Windsurf (Devin Desktop)

Add to mcp_config.json (~/.config/devin/mcp_config.json on current builds, ~/.codeium/windsurf/mcp_config.json on older Windsurf builds):

json
{  "mcpServers": {    "seo-perception": {      "url": "https://seoperception.com/mcp"    }  }}

Sign in when the server shows Needs auth, or use the token variant with a headers block as in the Cursor example.

Cline

In the Cline panel open MCP Servers > Remote Servers, enter the name seo-perception, URL https://seoperception.com/mcp, transport Streamable HTTP, then Add Server. Or edit cline_mcp_settings.json:

json
{  "mcpServers": {    "seo-perception": {      "type": "streamableHttp",      "url": "https://seoperception.com/mcp",      "disabled": false,      "autoApprove": []    }  }}

Set "type": "streamableHttp" explicitly; without it Cline falls back to the legacy SSE transport. See llms-install.md for step-by-step instructions an agent can follow.

Lovable

  1. Open Connectors, click +, choose MCP server.
  2. Server name: SEO Perception. URL: https://seoperception.com/mcp.
  3. Keep OAuth, click Add & authorize, and approve the sign-in.

Any other MCP client

URL:            https://seoperception.com/mcpTransport:      Streamable HTTPAuthorization:  OAuth 2.1 (discovered via WWW-Authenticate), or Bearer <your MCP token>

Example prompts

  • "List my SEO Perception sites and tell me which data is freshest."
  • "Summarize the strongest gains and losses for my site using stored data."
  • "Show the highest-priority open SEO opportunities and explain the evidence."
  • "Use SEO Perception to find the biggest losing keywords on /pricing and suggest concrete content changes to recover them."
  • "Find non-branded queries in positions 5 to 20 with at least 50 impressions that are missing from their landing page."
  • "Find keyword cannibalization and recommend which page should be preferred."
  • "Find the biggest content and snippet gaps, then suggest rewrites that match the losing keywords."
  • "Suggest internal links and natural anchor text for pages with ranking potential."
  • "Which pages show meaningful content decay?"
  • "Mark possibility 42 done after the draft is in the file."

Security and data boundary

  • Your sites only. Every tool is limited to websites on the signed-in account.
  • One optional write. Closing a Possibility does not edit the website, call Google, or start a recrawl. Done can come back on the next crawl. Ignore is permanent and needs a reason. A change by issue type or URL previews until confirm is true, and never closes more than 25 rows at once.
  • No live Google calls. Tools read the weekly Search Console data, crawl, and prioritized fix list SEO Perception has already stored. Collection happens in the product's own sync, not inside a tool call.
  • Scopes. mcp:read is required. mcp:possibilities is optional and is what allows closing to-dos. OAuth Connect asks for both. Allow both on the consent screen if the editor should be able to close a to-do. A client that requests only mcp:read stays read-only. A personal token stays read-only unless you enable closing when you create it.
  • Tokens, not passwords. Never put your login password or session cookie in an MCP config. Create and revoke personal access tokens under Account > MCP.
  • Your client's model provider. Your MCP client may send returned results to its model provider. Treat them as sensitive site analytics.

Troubleshooting

  • 401: sign in again, or create a new token under Account > MCP and update SEOPERCEPTION_MCP_TOKEN.
  • 403 paid_plan_required: MCP needs a plan that includes it (see Plan above).
  • 429: wait for the retry time in the response.
  • Empty lists: usually no stored data yet for that site.

Links

About this repository

This repo holds only listing metadata (README, server.json, glama.json, llms-install.md, Cursor plugin manifest, logo). The SEO Perception application and MCP server source code are not open source and are not part of this repository.

Made by Larsik Corp (Lars Koudal). Documentation and configuration files are released under the MIT License. "SEO Perception" and the logo are trademarks of Larsik Corp. Google and Search Console are trademarks of Google LLC; SEO Perception is not affiliated with or endorsed by Google.

Source: README.md at commit c744140

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v2.1.0LatestOct 26, 2026
  2. v1.0.0Oct 18, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts