run_audit: run an SEO and GEO audit from your AI assistant

run_audit runs a full 205-check SEO and GEO audit on any public URL, straight from your assistant. It covers technical SEO, content quality, structured data (JSON-LD and microdata), internal links, images, security headers, accessibility, and AI search readiness for ChatGPT, Perplexity and Google AI Overviews.

It returns an overall score and per-category scores out of 100, the highest-priority failures with evidence, and a permanent shareable report URL you can send to a client or teammate.

Endpoint

The following endpoint handles the MCP streamable HTTP tool execution:

POST[base_url]/mcp

Streamable HTTP Transport: The server streams responses conforming to JSON-RPC 2.0. All clients (Claude, Cursor, ChatGPT) send the required Accept: application/json, text/event-stream header automatically.

Request Fields

Specify the target website and optional crawl parameters for the audit engine.

Field

Type

Description

url

String *

The target website URL to audit (e.g. https://stripe.com). Scheme is automatically normalized if omitted.

deep

Boolean

Deep mode: Crawls up to 8 sampled URLs from the sitemap to analyze the internal link graph, detect orphan pages, and find duplicate titles/meta tags. Defaults to false.

Sample Request

{
  "url": "https://stripe.com"
}

Response Fields

Field

Type

Description

content

Array<ContentBlock>

Standard MCP text content block containing formatted summary for the LLM.

structuredContent

Object

Machine-readable payload containing overallScore, categories breakdown, shareId, and shareUrl.

structuredContent.shareUrl

String

Direct public report link (e.g. https://seoaudit.imvasa.dev/s/9f2b8a7c).

Sample Response

{
  "content": [
    {
      "type": "text",
      "text": "Audit for https://stripe.com\nOverall score: 92/100\n  · Core SEO: 96/100\n  · GEO & AI Search: 88/100\n  · Structured Data: 95/100\n  · Performance: 89/100\n  · Security: 100/100\n  · Accessibility: 91/100\n\nTop failures:\n- [GEO] Missing llms.txt at domain root\n- [Performance] Render-blocking stylesheet in head\n\nShareable report: https://seoaudit.imvasa.dev/s/9f2b8a7c"
    }
  ]
}