Documentation

Tools exposed by Business ID Check and the limits that apply.

Connect

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

Tools

check_business_id

Validates one identifier: offline format and check digits, then the official registry where one is available. Compares with the previous check of the same number.

• Inputs: id, country (optional ISO code such as DE, GB, AU, NZ; inferred from a prefix or layout when omitted)
• Limits: Counts one check. Numbers that could not be judged (registry outage, country unknown) are not counted.

start_id_batch

Starts a batch check from a pasted list or a CSV file at a public URL. The first part is processed immediately.

• Inputs: ids (list) or csv_url, optional id_column and default country
• Limits: Identifiers per batch and checks per month depend on the plan.

get_id_batch

Progress for a batch; advances it by one part. When finished it returns counts, the identifiers that changed or are not valid, a report URL and, on Pro, a CSV URL.

• Inputs: batch_id
• Limits: One part (up to 20 identifiers) per call.

id_history

Lists the earlier results for one identifier with the changes between them.

• Inputs: id, country (optional), limit (optional, up to 50)
• Limits: Up to 50 results kept per identifier, for 12 months.

list_id_batches

Lists the latest 20 batches for the account.

• Inputs: none
• Limits: Latest 20.

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