Can a machine consume this page? AEO, SEO and performance scans. Page scans need no account.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Explain one Bot Appétit check: what it looks at, why it matters for machines reading a page, and what good looks like. Use the id from list_checks or a report. Costs nothing and does not scan.
A check id from list_checks or from a report, such as "llms-txt".
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http bot-appetit https://botappetit.ai/mcp
Explain one Bot Appétit check: what it looks at, why it matters for machines reading a page, and what good looks like. Use the id from list_checks or a report. Costs nothing and does not scan.
| Argument | Type | Description |
|---|---|---|
| id* | string | A check id from list_checks or from a report, such as "llms-txt". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "A check id from list_checks or from a report, such as \"llms-txt\"."
}
}
}Get a stored Bot Appétit report by scan id, the same report a person sees at botappetit.ai/r/<id>. Costs nothing and does not scan. Use it to re-read a report you were given a link to. A page that blocked our scanner is returned as blocked, with no score.
| Argument | Type | Description |
|---|---|---|
| id* | string | The scan id: the last part of a report link on botappetit.ai/r/<id>, or `scan_id` from scan_page. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The scan id: the last part of a report link on botappetit.ai/r/<id>, or `scan_id` from scan_page."
}
}
}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. Call it with no category to see the top of every category, or with a category id for that board. Only sites that were scored on the current rules are ranked; a site that blocked our scanner is never ranked.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many sites to return per category (default 10 for one category, 5 for all). |
| category | string | A category id such as "software" or "news". Leave out for the top sites of every category. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many sites to return per category (default 10 for one category, 5 for all)."
},
"category": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "A category id such as \"software\" or \"news\". Leave out for the top sites of every category."
}
}
}List every check Bot Appétit runs on a page, grouped by category, with the id of each. Use the id with explain_check for what a check means and what good looks like. Every check asks one question: can a machine consume this page?
| Argument | Type | Description |
|---|---|---|
| category | string | Only checks in this category id, such as "aeo". Leave out for all of them. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"category": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Only checks in this category id, such as \"aeo\". Leave out for all of them."
}
}
}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. Use a host from here with site_history, set_pins and the other site tools.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}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. Costs nothing and does not scan. Use it to show whether a page has improved. Blocked and failed scans are listed without a score.
| Argument | Type | Description |
|---|---|---|
| url* | string | The exact page, such as https://example.com/pricing. `/a` and `/a/` are different pages. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "The exact page, such as https://example.com/pricing. `/a` and `/a/` are different pages."
}
}
}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. This returns exactly what the person must do, in order: connect this agent to their account (a one-time approval in their browser), after which start_site_scan, site_scan_status, list_sites and the other account tools work. For a single page, use scan_page instead, which is free and needs no account.
| Argument | Type | Description |
|---|---|---|
| url | string | The site the person wants scanned, if you know it. It is used only to word the steps. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "The site the person wants scanned, if you know it. It is used only to word the steps."
}
}
}Check one web page for AEO, SEO and performance: can a machine consume it? Returns the findings by check and the report link. If the exact page was scanned in the last 24 hours the stored result is returned at no cost; set fresh to scan again. A page that blocks our scanner is returned as blocked with no score, because it cannot pass. Free, no account needed. Always give the person the report link and say it came from Bot Appétit by Milk Moon Studio.
| Argument | Type | Description |
|---|---|---|
| url* | string | The page to check, such as https://example.com/pricing. A bare domain works. |
| fresh | boolean | Set true to always run a new scan instead of returning a stored result under 24 hours old. A new scan uses the stricter new-scan rate limit. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "The page to check, such as https://example.com/pricing. A bare domain works."
},
"fresh": {
"type": "boolean",
"description": "Set true to always run a new scan instead of returning a stored result under 24 hours old. A new scan uses the stricter new-scan rate limit."
}
}
}Pin or unpin pages on one of the signed-in person's sites. Pinned pages are scanned in every site scan of that site and count toward its score; up to 25, on the site itself. Give pin and/or unpin lists. Returns each address's outcome and the pins now in place; they apply from the next scan.
| Argument | Type | Description |
|---|---|---|
| pin | array | Page addresses to pin. They must be on the site (or its www/apex twin). |
| host* | string | The site, as list_sites gives it. |
| unpin | array | Page addresses to stop pinning. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"host"
],
"properties": {
"pin": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 25,
"description": "Page addresses to pin. They must be on the site (or its www/apex twin)."
},
"host": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The site, as list_sites gives it."
},
"unpin": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 25,
"description": "Page addresses to stop pinning."
}
}
}Turn the signed-in person's monthly re-scans of their sites on or off, and the email of each result on or off. Leave a field out to keep it as it is; call with no fields to read the current settings. The settings belong to the account, not to one site.
| Argument | Type | Description |
|---|---|---|
| boolean | Email the person the result of each monthly re-scan. Leave out to keep the current setting. | |
| rescan | boolean | Re-scan this account's sites automatically each month. Leave out to keep the current setting. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "boolean",
"description": "Email the person the result of each monthly re-scan. Leave out to keep the current setting."
},
"rescan": {
"type": "boolean",
"description": "Re-scan this account's sites automatically each month. Leave out to keep the current setting."
}
}
}Create or stop the unlisted share link for one of the signed-in person's site scans. Site scans are private by default; a link lets anyone who holds it read that one scan (not the person's other scans) and stays valid until stopped. Only create a link when the person has asked to share the scan, and tell them who can open it.
| Argument | Type | Description |
|---|---|---|
| action* | string | "create" makes an unlisted link anyone holding it can open; "stop" turns it off so the link stops working. |
| job_id* | string | The site scan to share or stop sharing. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id",
"action"
],
"properties": {
"action": {
"enum": [
"create",
"stop"
],
"type": "string",
"description": "\"create\" makes an unlisted link anyone holding it can open; \"stop\" turns it off so the link stops working."
},
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The site scan to share or stop sharing."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| host* | string | The site, as list_sites gives it: for example www.example.com. An address is accepted too. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"host"
],
"properties": {
"host": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The site, as list_sites gives it: for example www.example.com. An address is accepted too."
}
}
}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. Only the account that ran the scan can read it. While it runs, check again after about a minute.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | The job_id start_site_scan returned, or one from list_sites or site_history. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The job_id start_site_scan returned, or one from list_sites or site_history."
}
}
}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. Needs the person to have authorised this connection. It returns a job_id straight away; the scan runs for a few minutes, so read it with site_scan_status. The result is private to their account until they choose to share it. For one page, use scan_page, which needs no account.
| Argument | Type | Description |
|---|---|---|
| site* | string | The site to scan: a domain such as example.com, a sitemap URL, or a list of pages on ONE site, one per line. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site"
],
"properties": {
"site": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "The site to scan: a domain such as example.com, a sitemap URL, or a list of pages on ONE site, one per line."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 2, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.