ScanMySEO

SCANMYSEO FOR ASSISTANTS · MCP

Your website audit.
A better conversation.

Ask what matters. See the evidence. Give your developer a clear repair brief. Your assistant works with the same ScanMySEO report you see in your dashboard.

Start with an existing report, or use your available free audit allowance. No automatic ScanMySEO AI processing.

One account Your existing allowanceOne evidence base Not another SEO scoreYour decision New audits and AI stay explicit

FROM FINDINGS TO ACTION

Less explaining the report.
More deciding what to do.

ScanMySEO captures and checks your website. Your assistant can help you work through the resulting evidence.

PRIORITISE

Find the right starting point

Review confirmed Fix First groups separately from uncertain items and coverage limits. Follow the report’s recorded severity, not a new invented ranking.

INVESTIGATE

Get specific about a page

Inspect captured metadata, related findings and retained evidence. Requested URLs, final URLs and declared canonicals remain distinct.

HAND OFF

Give your developer a useful brief

Select findings and assemble their recorded repair and verification instructions. It is a brief to act on, not permission to edit your website.

UNDERSTAND

Review AI search readiness

Read the readiness dimensions saved in your report, where available. Website readiness is not a measurement of citations or visibility in ChatGPT or Claude.

AUDIT

Run a bounded new check

Check account access and get a non-spending quote. An authorised start uses one saved action, so a retry can follow the original audit instead of creating another.

REUSE

Keep the useful context

Read an existing report, return to an exact revision and retrieve permitted exports. A new conversation does not require a new crawl.

CHOOSE YOUR ASSISTANT

A connection, not another account.

Use your normal ScanMySEO sign-in. Approve specific domains, permissions, limits and an expiry. Availability in the assistant depends on its current account and workspace settings.

OAuth with PKCE for supported hosts. Personal scoped tokens are for compatible test clients and your own scripts.

ChatGPT

  1. Open the custom app/connector creation flow available in your workspace’s settings.
  2. Use the endpoint above with OAuth. Where offered, allow public-client registration; ScanMySEO does not issue a client secret.
  3. Sign into ScanMySEO and check the exact callback shown on the consent page. Start with read-only access to your site.
  4. Return to ChatGPT and ask: “Find my latest ScanMySEO report and explain its scope.”

A custom connection is not a published directory listing. This page does not claim platform approval or universal account eligibility.

Authentication and reconnect details

Claude

  1. Open Settings, then Connectors, and choose the custom connector option where your account permits it.
  2. Add ScanMySEO and paste the remote endpoint. Use OAuth, without inventing a secret or callback.
  3. Connect, sign into ScanMySEO and approve the intended website and permissions.
  4. Ask: “Use my existing ScanMySEO audit. Show confirmed priorities separately from items needing review.”

Custom connector access and Connectors Directory submission have different eligibility requirements. Setup and listing approval are separate.

First prompts and saved-action workflow
Using MCP Inspector, a script or a personal token

Create a scoped connection on ScanMySEO and copy its one-time token into the client’s protected credential field, never a chat prompt. For OAuth, clients can register exact callbacks with the advertised registration endpoint. The operator can also pre-register an exact callback. Tokens expire; reconnect through the original host’s OAuth flow rather than widening permission or sharing credentials.

Manage scoped connections

START WITH WHAT YOUR ACCOUNT INCLUDES

The free audit is a real audit.

The current Free catalogue includes 1 audit per monthly allowance window, for up to 50 pages and 1 active website. Your account gives the exact remaining balance and reset date.

Before a new audit

Your assistant checks the existing reports, page limits and available allowance. A quote does not reserve or consume an audit.

While it runs

Starting an approved audit reserves its entitlement. The same operation remains available to follow, even after a client reconnects.

After delivery

The existing report-delivery rules decide consumption or release. Reading the completed report does not spend another crawl allowance.

After the free allowance

Included plan allowance and separately purchased one-off credits remain distinct. ScanMySEO uses eligible included allowance first, then the smallest suitable available credit. Using a larger credit than necessary requires confirmation. Existing account access can be changed independently through the normal ScanMySEO account workflow; a connection does not buy or add allowance.

When access is insufficient, your assistant can explain the limit and retain the saved request. After an independent account change, recheck that same request. Its scope, consent and current limits are checked again.

Understand account and connection limits

AI IS A SEPARATE CHOICE

Your assistant can explain.
ScanMySEO AI needs approval.

Reading, filtering and preparing a repair brief do not call ScanMySEO’s models. Your host assistant can reason over the supplied evidence using its own service.

Ask Cozmo and Enhanced AI are explicit ScanMySEO actions. The appropriate scope, existing report access, operator enablement, a positive AI budget and your approval of the exact saved action are required. Limits are checked again before provider work.

START A USEFUL CONVERSATION

Try a focused question.

REUSE · READ ONLY

Find my latest ScanMySEO audit for my approved website. Tell me its age and exactly what it covers before recommending anything.

Reads existing reports; no new crawl or ScanMySEO AI.

PRIORITIES · READ ONLY

Show the confirmed Fix First groups in my report. Keep review items and untested areas separate, and explain the recorded priority.

Uses existing findings, not a new score or model request.

PAGE EVIDENCE

For the page I select, show its recorded title, final URL and declared canonical, then inspect the evidence for its most important finding.

Requires retained evidence and evidence:read.

DEVELOPER HANDOFF

Create a developer brief from these selected findings, keeping their exact source and target URLs, recorded repair instructions and verification steps.

Deterministic brief; does not edit your website.

AI SEARCH READINESS

Explain the saved AI search readiness dimensions in this report. Distinguish recorded evidence from interpretation and do not claim measured visibility.

Reads saved results; unavailable historical fields stay unknown.

QUOTE BEFORE A CRAWL

Check my existing reports and allowance. Quote a new one-page audit of my approved website, but do not start it until I confirm.

A quote spends no allowance. An approved start can reserve one audit.

OPTIONAL ENHANCED AI

Prepare an Enhanced AI review of this exact report revision and show me the owner approval page. Do not generate before I approve.

Requires enhancement:use, existing access and AI budget; may use model capacity only after owner approval.

OPTIONAL ASK COZMO

Prepare an Ask Cozmo question for this revision: explain the highest-priority recorded issue. Show me the exact action to approve first.

Requires report_ai:use; owner approval permits at most one bounded generation attempt.

KNOW WHAT TO EXPECT

A few useful boundaries.

Why is a completed audit described as partial?

The reviewed pages can support a useful delivered report without proving complete website coverage. A page cap, limited discovery or unavailable pages must not become a claim that the rest of the site passed.

What happens when access expires or is revoked?

Reconnect through your assistant and review consent again. Revoking a connection blocks future authorised access. Reconnecting does not transfer an old AI approval to a new credential or automatically retry a costly action.

My assistant cannot see a report or a feature.

Check the owning account, approved domain, granted scopes, report delivery and retention. Billing-team membership does not by itself share a private report. Some features may also be operator-disabled.

The audit is still running. Should I start another?

No. Follow the returned operation ID. An ended polling window or lost response does not establish failure. The verifier can recover the original saved action without creating another.

Will I see the full dashboard inside every assistant?

No. Structured findings and readable text work independently of a rich interface. The complete ScanMySEO dashboard remains available in your signed-in account. A host-rendered interactive component is a separate compatibility step, not promised by this build.

Does connecting guarantee a listing in an app directory?

No. Custom access, independent client testing and platform review are different milestones. Only a verified published listing will be shown as an install link.

Developer reference

The deployed registry is the source of truth for tool inputs, scopes and bounded outputs.

OpenAPI · Capabilities · MCP guide · Errors and recovery