Documentation
Tools exposed by Provider Exclusion Check and the limits that apply.
Connect
Server URL: https://npicheck.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
lookup_npi
Looks up one NPI in the CMS NPI Registry: name, type, status, taxonomies with license numbers and addresses.
- Inputs: npi
- Limits: Counts one check when the registry returns a record. Invalid check digits, unknown numbers and an unavailable registry do not count.
search_providers
Searches the NPI Registry by name, organization, state, city, taxonomy and provider type, up to 20 per call.
- Inputs: first_name, last_name, organization_name, state, city, taxonomy, provider_type, limit, skip
- Limits: Counts one check when the registry answers. A name or taxonomy is required.
check_exclusion
Checks one provider against the HHS-OIG LEIE by NPI and/or name, with optional state and date of birth.
- Inputs: npi, name, state, dob, threshold (optional)
- Limits: Counts one check when the LEIE check ran. Screening aid, not a legal determination.
check_roster
Checks a list of up to 200 providers against the LEIE without saving it, 50 per call.
- Inputs: providers, offset (optional), threshold (optional)
- Limits: Counts one check per provider checked. Only the LEIE is queried.
save_roster
Saves a named roster of providers for automatic re-checks, creating it or replacing (or appending to) a roster of the same name.
- Inputs: name, providers, threshold (optional), append (optional)
- Limits: Saved-roster and providers-per-roster limits by plan. Does not run a check.
list_rosters
Lists saved rosters with provider counts, last check, LEIE version checked and number of providers with known matches.
- Inputs: none
- Limits: No quota.
remove_roster
Deletes a saved roster and its alerts.
- Inputs: name
- Limits: Cannot be undone.
check_now
Checks a saved roster immediately, reading each NPI in the registry and querying the LEIE, 20 providers per call.
- Inputs: name, offset (optional)
- Limits: Counts one check per provider checked. Larger rosters continue with offset.
list_sources
Shows the LEIE file date, version, row count, licence and last refresh, and the NPI Registry source.
- Inputs: none
- Limits: No quota.
get_alerts
Returns alerts for new LEIE matches and deactivated NPIs, unseen first, and marks them seen.
- Inputs: limit (optional), include_seen (optional)
- Limits: No quota.
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
| Limit | Free | Pro |
|---|---|---|
| checks | 25 | 3000 |
| saved rosters | 1 | 20 |
| providers per roster | 25 | 2000 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://npicheck.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.