screen_practitioner
Screens one practitioner: state license status and board discipline flags (only for states that are live; sandbox keys get SAMPLE data for every state), identity check against CMS NPPES, and exclusion screening (OIG LEIE, SAM.gov and the state Medicaid lists that are live), with an evidence receipt. Requires NPI + first name + last name + state; if the names you give do not match the record, the result is blocked, not warned. The output lists which sources returned CLEAR and which did not; a source that is not CLEAR (including NOT_CHECKED and COULD_NOT_CHECK) must never be reported as clear. Counts as one lookup against the key's quota or prepaid balance (1 check), exactly as GET /api/v1/sanctions does. Not covered: states that are not live, licenses of staff without an NPI (use screen_roster), anything not on the official lists. A possible match is for a person to confirm with the official source. Needs an API key (Authorization: Bearer sw_live_… or sw_test_…); without one it returns an error that points to how_to_get_access.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"npi": "<npi>",
"first_name": "<first_name>",
"last_name": "<last_name>",
"state": "<state>"
},
"name": "screen_practitioner"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| npi | Yes | The 10-digit National Provider Identifier (NPI). | |
| fresh | No | true skips the 120-day cache and queries the source again. | |
| state | Yes | Two-letter state code, or eNLC for the nursing compact (sample data only). | |
| last_name | Yes | The practitioner's last name, as on their license. | |
| first_name | Yes | The practitioner's first name, as on their license. | |
| profession | No | Clinical profession, to scope the board search. | |
| license_number | No | Required for states verified live; the error detail shows the format. |