MCP Tools

Audit Tools

6 MCP tools for searching, retrieving, and re-auditing domains. Includes fix prompts, opportunities, and benchmark data.

aeo_search_audits

Search published AEO audits by domain, sector, or score range. Returns slug, score, verdict, sector, category.

Parameters

Name	Type	Required	Description
`domain`	string	Optional	Filter by domain (partial match, e.g., "notion")
`sector`	string	Optional	Filter by sector slug
`min_score`	number	Optional	Minimum overall score
`max_score`	number	Optional	Maximum overall score
`limit`	number	Optional	Max resultsDefault: `20`

Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_search_audits({ domain: class="code-string">"notion", min_score: 50 })

Response

json

{
  class="code-string">"count": 2,
  class="code-string">"audits": [
    {
      class="code-string">"slug": class="code-string">"notion-com",
      class="code-string">"site": class="code-string">"notion.com",
      class="code-string">"engine": class="code-string">"chatgpt",
      class="code-string">"overall_score": 62,
      class="code-string">"verdict": class="code-string">"Moderate AEO readiness with notable gaps...",
      class="code-string">"created_at": class="code-string">"2026-02-15T10:30:00.000Z",
      class="code-string">"sector": class="code-string">"saas-productivity",
      class="code-string">"category": class="code-string">"Project Management"
    }
  ]
}

aeo_get_audit

Get full audit details for a domain: scorecard, findings, opportunities, pitch numbers. Set include_fix_prompts=true to get actionable fix prompts sorted by impact.

Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug (e.g., "notion-com")
`include_fix_prompts`	boolean	Optional	Include actionable fix prompts sorted by potential score impactDefault: `false`

Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_get_audit({ slug: class="code-string">"notion-com", include_fix_prompts: true })

Response

json

{
  class="code-string">"audit": {
    class="code-string">"slug": class="code-string">"notion-com",
    class="code-string">"site": class="code-string">"notion.com",
    class="code-string">"engine": class="code-string">"chatgpt",
    class="code-string">"overall_score": 62,
    class="code-string">"verdict": class="code-string">"Moderate AEO readiness with notable gaps...",
    class="code-string">"sector": class="code-string">"saas-productivity",
    class="code-string">"category": class="code-string">"Project Management",
    class="code-string">"scorecard": [
      {
        class="code-string">"id": 1,
        class="code-string">"criterion": class="code-string">"llms.txt",
        class="code-string">"score": 0,
        class="code-string">"status": class="code-string">"fail",
        class="code-string">"keyFindings": class="code-string">"No llms.txt file found at domain root."
      }
    ],
    class="code-string">"detailed_findings": [ ... ],
    class="code-string">"opportunities": [ ... ],
    class="code-string">"pitch_numbers": [ ... ],
    class="code-string">"bottom_line": class="code-string">"Notion has strong content but lacks...",
    class="code-string">"created_at": class="code-string">"2026-02-15T10:30:00.000Z"
  },
  class="code-string">"versions": [
    { class="code-string">"version": 2, class="code-string">"overall_score": 62, class="code-string">"created_at": class="code-string">"..." },
    { class="code-string">"version": 1, class="code-string">"overall_score": 45, class="code-string">"created_at": class="code-string">"..." }
  ],
  class="code-string">"fix_prompts": [
    {
      class="code-string">"criterion_id": 1,
      class="code-string">"criterion": class="code-string">"llms.txt",
      class="code-string">"current_score": 0,
      class="code-string">"potential_impact": 10,
      class="code-string">"prompt": class="code-string">"Create a /llms.txt file at your domain root..."
    }
  ],
  class="code-string">"fix_summary": {
    class="code-string">"total_fixable": 8,
    class="code-string">"potential_score_gain": 23,
    class="code-string">"top_3_impact": [class="code-string">"llms.txt", class="code-string">"Schema.org Markup", class="code-string">"FAQ Section"]
  }
}

aeo_get_audit_status

Check the status of an audit job. Returns: pending, discovering, auditing, seeding, visibility, completed, or failed.

Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug (e.g., "notion-com")

Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_get_audit_status({ slug: class="code-string">"notion-com" })

Response

json

{
  class="code-string">"slug": class="code-string">"notion-com",
  class="code-string">"status": class="code-string">"auditing",
  class="code-string">"current_stage": null,
  class="code-string">"overall_score": null,
  class="code-string">"started_at": class="code-string">"2026-02-22T12:00:00.000Z",
  class="code-string">"completed_at": null
}

aeo_request_reaudit

Request a fresh re-audit after making fixes. Queues a new audit job. Poll with aeo_get_audit_status until completed.

Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug of a previously audited site

Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_request_reaudit({ slug: class="code-string">"notion-com" })

Response

json

{
  class="code-string">"slug": class="code-string">"notion-com",
  class="code-string">"status": class="code-string">"queued",
  class="code-string">"previous_score": 62,
  class="code-string">"message": class="code-string">"Re-audit queued. Use aeo_get_audit_status to poll progress."
}

The typical agent workflow is: aeo_get_audit (with fix prompts) - apply fixes - aeo_request_reaudit - poll status - aeo_get_audit (compare scores).

aeo_get_opportunities

Get prioritized opportunities and fix items for a domain. Returns strategic deliverables and criterion-level fix suggestions sorted by potential score gain. No full prompt text - use aeo_get_audit with include_fix_prompts=true for detailed remediation prompts.

Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug (e.g., "notion-com")

Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_get_opportunities({ slug: class="code-string">"notion-com" })

Response

json

{
  class="code-string">"slug": class="code-string">"notion-com",
  class="code-string">"domain": class="code-string">"notion.com",
  class="code-string">"overall_score": 62,
  class="code-string">"verdict": class="code-string">"Moderate AEO readiness with notable gaps...",
  class="code-string">"opportunities": [
    {
      class="code-string">"id": 1,
      class="code-string">"name": class="code-string">"Add llms.txt",
      class="code-string">"description": class="code-string">"Create an llms.txt file at your domain root...",
      class="code-string">"effort": class="code-string">"low",
      class="code-string">"impact": class="code-string">"HIGH"
    }
  ],
  class="code-string">"fix_summary": {
    class="code-string">"criteria_to_fix": 8,
    class="code-string">"total_potential_gain": 23,
    class="code-string">"top_3_fixes": [
      class="code-string">"llms.txt (+10pts)",
      class="code-string">"Schema.org Markup (+8pts)",
      class="code-string">"FAQ Section (+5pts)"
    ]
  },
  class="code-string">"fix_items": [
    {
      class="code-string">"criterion_id": 1,
      class="code-string">"criterion_name": class="code-string">"llms.txt",
      class="code-string">"category": class="code-string">"Discovery",
      class="code-string">"current_score": 0,
      class="code-string">"potential_gain": 10
    }
  ]
}

aeo_get_benchmarks

Get sector/category benchmark averages, score ranges, and domain counts. Use to find real data for article citations.

Parameters

Name	Type	Required	Description
`sector_slug`	string	Optional	Filter by sector slug (e.g., "saas-productivity")
`category_name`	string	Optional	Filter by category name (e.g., "Home Health Care")

Example

json

class=class="code-string">"code-comment">// Agent calls:
aeo_get_benchmarks({ sector_slug: class="code-string">"saas-productivity" })

Response

json

[
  {
    class="code-string">"sector_slug": class="code-string">"saas-productivity",
    class="code-string">"sector_name": class="code-string">"SaaS & Productivity",
    class="code-string">"category_name": class="code-string">"Project Management",
    class="code-string">"domain_count": 24,
    class="code-string">"average_score": 54,
    class="code-string">"min_score": 18,
    class="code-string">"max_score": 85,
    class="code-string">"score_range": class="code-string">"18-85"
  }
]