Documentation

Tools exposed by Migration Mapper and the limits that apply.

Connect

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

Tools

start_migration_map

Collects the URLs of the old and the new site from sitemaps or pasted lists and starts matching old URLs to new ones. Work is done in batches.

• Inputs: old_sitemap_url or old_urls, new_sitemap_url or new_urls, optional old_base_url and new_base_url for path-only lists, fetch_titles (default true)
• Limits: Counts one map. URL limit per site depends on the plan. Gzipped sitemaps are not read.

get_migration_map

Progress for a map; advances it by one batch. When done, returns match counts, unmatched URLs, and report and download URLs for the mapping CSV and the five redirect formats.

• Inputs: map_id
• Limits: One batch per call.

check_redirects

Follows redirects for the old URLs of a finished map, or for a pasted list of URLs or from/to pairs, up to 5 hops each. Large lists are processed in batches.

• Inputs: map_id, or urls, or pairs (from, to)
• Limits: Counts one redirect check per URL. At most 5 redirects are followed per URL.

get_redirect_check

Progress for a redirect check; advances it by one batch. When done, returns counts per result, the problems found, a report URL and a results CSV URL.

• Inputs: check_id
• Limits: One batch per call.

list_migration_maps

Lists the latest 20 migration maps and the latest 20 redirect checks for the account.

• Inputs: none
• Limits: Latest 20 of each.

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://mapper.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.