Documentation

Tools exposed by Schema Markup Builder and the limits that apply.

Connect

Server URL: https://schema.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

generate_schema

Builds schema.org JSON-LD and the script tag for one supported type from field values, and lists missing recommended properties.

• Inputs: type (for example Product, Article, LocalBusiness, Restaurant), fields (object of property values)
• Limits: Counts one operation.

validate_schema

Checks JSON-LD text, one public page URL or a list of page URLs against Google rich result rules; reports errors and warnings per item.

• Inputs: json_ld, or url, or urls (batch)
• Limits: Counts one operation per JSON-LD text or page URL. URLs per call by plan. Pages are read up to 400 KB.

get_schema_batch

Progress for a URL batch; advances it by one group of pages. When finished, returns the per-page results and the report URL.

• Inputs: batch_id
• Limits: One group of up to 8 pages per call.

compare_live_schema

Compares the JSON-LD on a live page with intended JSON-LD and lists missing, different and extra properties.

• Inputs: url, json_ld (the intended markup)
• Limits: Counts one operation.

account_status

Shows the account email, plan, usage and limits.

• Inputs: none
• Limits: none

activate_license

Binds a licence key to the account.

• Inputs: license_key (string)
• Limits: Key must belong to this product.

Plan limits

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://schema.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.