MCP reference

Find and confirm a doctor’s office

Use this when someone needs to identify a doctor and office by name, specialty or clinic. Ordinary searches use a fixed 25-mile ZIP search; a confirmed find_medicare_facilities reference targets that exact location with its selected radius. Confirm the doctor AND listed office, even a sole or similar-name match, before selected_option. Preserve filters, including requested pcp_only or accepts_medicare_assignment; the latter filters Medicare assignment, not new-patient availability. All Specialties removes only specialty. Return the confirmed doctor_reference for coverage/ranking. When asked for other offices, reuse the confirmed doctor selection with show_offices=true and ask the person to choose a returned address via office_option. Preserve that office_option in the returned reference; office selection is not a network verdict. Directory listings do not establish plan participation or accepting-new-patient status; use check_my_doctors_in_plan_network to check a plan. Use the app as the answer. Do not repeat its options in a list, table or explanation. Ask one short question if input is required; otherwise stop.

Tool name

find_medicare_doctors

Input schema

{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "pattern": "^[0-9]{5}$",
      "description": "ZIP near the requested doctor; ordinary searches use 25 miles. A confirmed facility_reference preserves that exact location and its selected radius."
    },
    "county": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Confirmed county from the ZIP lookup. Omit if unknown so the tool can ask when needed."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Optional two-letter state returned by the county lookup."
    },
    "q": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "Doctor name, including any known first name. Two-letter surnames are supported. Reuse the original query when confirming a match."
    },
    "specialty": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Specialty name. Partial names return supported choices; only a canonical name becomes a filter. All Specialties removes this filter while retaining the name or clinic selection."
    },
    "facility": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Clinic, practice, or hospital name. Partial names return nearby organizations to choose from."
    },
    "facility_reference": {
      "type": "object",
      "description": "find_medicare_facilities’s selected facility_reference. Revalidate the organization and exact location before searching doctors; never invent a reference.",
      "properties": {
        "search": {
          "type": "object",
          "properties": {
            "q": {
              "type": "string"
            },
            "zip": {
              "type": "string"
            },
            "county": {
              "type": "string"
            },
            "state": {
              "type": "string"
            },
            "radius": {
              "type": "integer",
              "enum": [
                5,
                10,
                15,
                25,
                50,
                100
              ],
              "default": 25
            }
          },
          "required": [
            "q",
            "zip"
          ],
          "additionalProperties": false
        },
        "organization_id": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "location_id": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "required": [
        "search",
        "organization_id",
        "location_id"
      ],
      "additionalProperties": false
    },
    "pcp_only": {
      "type": "boolean",
      "description": "When true, restrict to the directory’s supported primary-care taxonomies. Omitted/false does not restrict specialty. This does not establish plan participation or new-patient availability."
    },
    "accepts_medicare_assignment": {
      "type": "boolean",
      "description": "When true, require the directory’s Medicare assignment flag. Omitted/false does not apply this filter. This is not an accepting-new-patients filter or a plan-network check."
    },
    "selected_option": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "Returned option_id, only after the person confirms the doctor and listed office. Keep the same search inputs. Never ask the person for this value."
    },
    "show_offices": {
      "type": "boolean",
      "description": "When the person asks for other offices for a confirmed doctor, reuse selected_option and set true. Returns up to ten public office choices; never assume an office is in network."
    },
    "office_option": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "Returned office option_id after the person selects its address. Omit show_offices or set it false to confirm this choice. Reuse the original doctor selected_option and search. Never invent this value."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 10,
      "description": "Maximum displayed results, from 1 to 10 (default 10)."
    }
  },
  "required": [
    "zip"
  ],
  "additionalProperties": false
}

Example request

Minimal synthetic request after initialization. A missing-input clarification is a valid result; do not invent personal facts to complete it. For content retrieval, replace the illustrative fixture ID with an ID returned by search.

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "find_medicare_doctors",
    "arguments": {
      "zip": "60614"
    }
  }
}

Connection

POST JSON-RPC to https://tools.thepocketprotector.com/mcp with method tools/call, name find_medicare_doctors, and arguments matching the schema above. Call tools/list to verify deployed availability.

Results and errors

Read both content and structuredContent. Follow returned clarification or continuation steps. Preserve source attribution, dates, uncertainty and scope. isError: true means the lookup did not complete. HTTP 429 requires waiting for Retry-After; never repeatedly retry an unavailable lookup.

Tool annotations

{
  "title": "Find and confirm a doctor’s office",
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

Authentication: public, no account or API key required. Public tools perform no enrollment or account writes.