Bot Appétit

official

Check whether AI assistants and search crawlers can read a web page: AEO, SEO and performance scans with a public report.

What can you do with Bot Appétit MCP?

  • Scan a page — Check any public page for AEO, SEO and performance, with no account needed.
  • Explain the checks — List every check Bot Appétit runs by category, or get a plain explanation of what one check looks at and why it matters.
  • Review past scans — Pull a stored report by scan id or list every scan of one exact page, newest first, with score changes.
  • See top sites — Show the highest-scoring sites by category, with rank, host, score, grade and a report link.
  • Run site scans on your account — Start a whole-site scan, check its status, and list or review your sites over time after a one-time browser approval.

Hosted MCP Server

npx add-mcp 'https://botappetit.ai/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Skip to content

For AI tools

Connect Bot Appétit to your AI tool

Bot Appétit is an MCP server. Add it to your AI tool and it can scan any public page and tell you whether a machine can read it: answer-engine readiness, search readiness and performance. Scanning pages is free and needs no account. If you also want it to work with your own account (whole-site scans and your sites), you approve it once in your browser.

The address

Every client asks for the same thing: the server address. It is Streamable HTTP. Nothing to sign in to for the page tools; the account tools ask for your approval the first time you use one.

✕MCP server address Copy address

https://botappetit.ai/mcp

Show all lines

What it can do

  • scan_page Check one web page for AEO, SEO and performance: can a machine consume it?
  • get_report Get a stored Bot Appétit report by scan id, the same report a person sees at botappetit.ai/r/<id>.
  • page_history List every stored Bot Appétit scan of one exact page, newest first, with the score at the time and how it moved since the scan before.
  • list_checks List every check Bot Appétit runs on a page, grouped by category, with the id of each.
  • explain_check Explain one Bot Appétit check: what it looks at, why it matters for machines reading a page, and what good looks like.
  • request_site_scan A whole-site scan reads a representative sample of a site and needs a person with a Bot Appétit account, and an agent never creates one.
  • leaderboard The highest-scoring sites by category, from the latest Bot Appétit scan of each site's homepage: rank, host, score out of 100, grade and a link to the full report.

Every answer comes with the link to the full report on botappetit.ai, so you can open it and share it.

With your own account

These work on your account, so they need your approval. The first time your AI tool uses one, it opens a page in your browser. You sign in, or create a free account and verify your email address there, then allow the connection. You do this yourself: an AI tool never creates an account for anyone. You can remove the connection in your tool at any time.

  • start_site_scan Start a whole-site scan for the signed-in person's account: Bot Appétit reads a representative sample of the site (not every page) and scores it.
  • site_scan_status Read one of the signed-in person's site scans: whether it is still running, and once it has finished the score, the checks that failed, the category scores and the pages it covered, each page with a link to its own full report.
  • list_sites List the sites the signed-in person follows in Bot Appétit, newest activity first, each with its latest site-scan score, the change since the scan before, and the trend.
  • site_history Read one of the signed-in person's sites over time: every site scan of it newest first with the score and the change since the previous scored scan (a change across a scoring update or different pinned pages is marked, not passed off as the site's own), the pinned pages, and the monthly re-scan settings.
  • set_pins Pin or unpin pages on one of the signed-in person's sites.
  • set_rescan_settings Turn the signed-in person's monthly re-scans of their sites on or off, and the email of each result on or off.
  • share_site_scan Create or stop the unlisted share link for one of the signed-in person's site scans.

A site scan is private to your account until you choose to share it.

Set it up in your tool

Claude Code

Run this in your terminal, then check it with /mcp inside Claude Code. Page tools work straight away. To use the account tools, run /mcp and choose to authenticate; a browser page opens for you to sign in and allow the connection.

✕Claude Code Copy snippet

claude mcp add --transport http bot-appetit https://botappetit.ai/mcp

Show all lines

Claude on the web and Claude Desktop
  1. Go to Customize, then Connectors.
  2. Choose “+ Add”, then “Add custom connector”.
  3. Give it a name, paste https://botappetit.ai/mcp as the remote MCP server URL, and choose “Continue”.
  4. If the dialog asks for Authentication, choose “Sign in when needed”, and for OAuth client choose “Use Claude's published identity”. Then choose “Add”.

Claude's help says custom connectors are available on the Free, Pro, Max, Ultra, Team and Enterprise plans; on Team and Enterprise an owner adds them first.

Cursor

Add this to .cursor/mcp.json in a project, or ~/.cursor/mcp.json to use it everywhere.

✕Cursor mcp.json Copy snippet

{
  "mcpServers": {
    "bot-appetit": {
      "url": "https://botappetit.ai/mcp"
    }
  }
}

Show all lines

Page tools need no sign-in. For the account tools, Cursor signs in with OAuth: it registers itself with our server automatically (dynamic client registration), opens a browser page where you sign in and allow the connection, and keeps the sign-in for you.

VS Code
  1. Open the command palette and run “MCP: Add Server”.
  2. Choose “HTTP (HTTP or Server-Sent Events)”.
  3. Paste https://botappetit.ai/mcp, then give the server a name.
ChatGPT
  1. Go to ChatGPT Plugins, choose the plus button, then “Add custom MCP server”.
  2. Enter a name and a description. Under “Connection”, paste https://botappetit.ai/mcp as the MCP server URL.
  3. Set the authentication, read the risk warning and choose “I understand and want to continue”.
  4. Choose “Create as a plugin”, then check the tools ChatGPT found.

OpenAI's help says account and workspace policies apply to adding and using custom MCP servers, so your workspace may need to allow it.

Limits

Reading a stored report is generous. Starting a new scan has a stricter limit, because each one fetches a real page. Without an account, one connection can also start at most 50 new scans a day (the count resets at midnight UTC); stored results never count against it. Connecting your account raises the limits and lifts the daily cap. If you go over, the answer says how long to wait. Wait, then ask again.

More for agents

Want your own site checked? Scan a page →, or ask your AI tool to do it once it is connected.

Want a person to fix what a scan finds? No pitch, just a plain-English chat.

Book a call →

{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.milkmoonstudio.com/#organization","name":"Milk Moon Studio","url":"https://www.milkmoonstudio.com","logo":"https://botappetit.ai/brand/mms-logo.svg","sameAs":["https://twitter.com/MilkMoonStudio","https://www.linkedin.com/company/milk-moon-studio","https://www.instagram.com/milk_moon_studio/","https://www.facebook.com/milkmoonstudio","https://medium.com/milk-moon-studio","https://vimeo.com/milkmoonstudio"]},{"@type":"WebApplication","@id":"https://botappetit.ai/#app","name":"Bot Appétit","url":"https://botappetit.ai/","applicationCategory":"BusinessApplication","operatingSystem":"Web","description":"Bot Appétit has a free MCP server. Connect Claude, Cursor, VS Code and other MCP clients to scan a page for AEO, SEO and performance with no account. Tools for your own account need a one-time approval.","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"publisher":{"@id":"https://www.milkmoonstudio.com/#organization"},"dateModified":"2026-11-10T16:44:16.347Z"}]}
{"@context":"https://schema.org","@graph":[{"@type":"WebPage","@id":"https://botappetit.ai/mcp#page","url":"https://botappetit.ai/mcp","name":"Connect Bot Appétit to your AI tool · Bot Appétit","description":"Bot Appétit has a free MCP server. Connect Claude, Cursor, VS Code and other MCP clients to scan a page for AEO, SEO and performance with no account. Tools for your own account need a one-time approval.","about":{"@id":"https://botappetit.ai/#app"},"publisher":{"@id":"https://www.milkmoonstudio.com/#organization"}}]}