changedInput schema / $schema
Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
addedInput schema / oneOf
Added value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "limit": {
+ "default": 20,
+ "description": "Maximum matching entries to return (1–50).",
+ "maximum": 50,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "mode": {
+ "const": "resolve",
+ "description": "Resolve a plain-language specialty to taxonomy codes.",
+ "type": "string"
+ },
+ "query": {
+ "description": "The plain-language specialty term to resolve, e.g. \"pediatric cardiologist\".",
+ "minLength": 1,
+ "type": "string"
+ },
+ "skip": {
+ "default": 0,
+ "description": "Entries to skip before the page (0–1000). Keep the same query and limit, then raise skip by limit each call.",
+ "maximum": 1000,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "mode",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "code": {
+ "description": "The exact NUCC taxonomy code, e.g. \"207RC0000X\".",
+ "minLength": 1,
+ "type": "string"
+ },
+ "mode": {
+ "const": "get",
+ "description": "Fetch one exact taxonomy entry by code.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "mode",
+ "code"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "grouping": {
+ "description": "Filter to a top-level grouping by case-insensitive substring, e.g. \"physicians\".",
+ "type": "string"
+ },
+ "limit": {
+ "default": 20,
+ "description": "Maximum entries to return (1–50).",
+ "maximum": 50,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "mode": {
+ "const": "browse",
+ "description": "Browse the taxonomy hierarchy.",
+ "type": "string"
+ },
+ "section": {
+ "description": "Filter by NPI section: Individual (NPI-1) or Non-Individual (NPI-2).",
+ "enum": [
+ "Individual",
+ "Non-Individual"
+ ],
+ "type": "string"
+ },
+ "skip": {
+ "default": 0,
+ "description": "Entries to skip before the page (0–1000). Keep the same filters and limit, then raise skip by limit each call.",
+ "maximum": 1000,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "mode"
+ ],
+ "type": "object"
+ }
+]
removedInput schema / properties
Removed value: -{
- "code": {
- "description": "For mode \"get\": the exact NUCC taxonomy code (e.g. \"207RC0000X\").",
- "type": "string"
- },
- "grouping": {
- "description": "For mode \"browse\": filter to a top-level grouping by case-insensitive substring (e.g. \"physicians\").",
- "type": "string"
- },
- "limit": {
- "default": 20,
- "description": "Maximum entries to return for resolve/browse (1–50). Ignored for get.",
- "maximum": 50,
- "minimum": 1,
- "type": "integer"
- },
- "mode": {
- "description": "resolve: plain term → codes. get: exact code → entry. browse: walk the hierarchy.",
- "enum": [
- "resolve",
- "get",
- "browse"
- ],
- "type": "string"
- },
- "query": {
- "description": "For mode \"resolve\": the plain-language specialty term to resolve (e.g. \"pediatric cardiologist\").",
- "type": "string"
- },
- "section": {
- "description": "For mode \"browse\": filter by NPI section — Individual (NPI-1) or Non-Individual (NPI-2).",
- "enum": [
- "Individual",
- "Non-Individual"
- ],
- "type": "string"
- },
- "skip": {
- "default": 0,
- "description": "Entries to skip before the page, for paging past a truncated resolve/browse result (0–1000). Keep the same query/filters and limit, raise skip by limit each call. Ignored for get.",
- "maximum": 1000,
- "minimum": 0,
- "type": "integer"
- }
-}
removedInput schema / required
Removed value: -[
- "mode"
-]
changedOutput schema / $schema
Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
addedOutput schema / anyOf
Added value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "matches"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]
addedOutput schema / properties / error
Added value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode. Declared by this tool: `no_match`: A resolve query or get code matched no taxonomy entry. `missing_argument`: The required query or code was present but blank after trimming. Other values are possible when a failure originates below the handler.",
+ "examples": [
+ "no_match",
+ "missing_argument"
+ ],
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}
removedOutput schema / required
Removed value: -[
- "matches"
-]