verify_nurse_license

Verify nurse license status, expiration dates, qualifications, and enforcement actions across US states (FL, NY) using official state nursing board data.

Instructions

Verify a nurse's license across US states (FL, NY). Search by license number or name. Returns license status, expiration, qualifications, and enforcement actions from official state nursing boards.

Input Schema

TableJSON Schema

Name	Required	Description
`state`	Yes	US state code: FL (Florida DOH MQA), NY (New York NYSED)
`licenseNumber`	No	License number to look up (e.g. "RN9414870" for FL, "825282" for NY)
`lastName`	No	Last name for person name search
`firstName`	No	First name for person name search (optional)
`licenseType`	No	License type filter: RN, LPN, NP, APRN, CNA
`limit`	No	Number of results to return (max 25)

Implementation Reference

src/index.ts:258-282 (handler)

Handler function for verify_nurse_license tool.

  async ({ state, licenseNumber, lastName, firstName, licenseType, limit }) => {
    const params = new URLSearchParams();
    params.set("state", state);
    params.set("limit", String(limit));
    if (licenseNumber) params.set("licenseNumber", licenseNumber);
    if (lastName) params.set("lastName", lastName);
    if (firstName) params.set("firstName", firstName);
    if (licenseType) params.set("licenseType", licenseType);

    const url = `${BACKEND_URL}/nurse-license/verify?${params.toString()}`;
    const res = await fetch(url);
    const data = await res.json();

    if (!data.success) {
      return {
        isError: true,
        content: [{ type: "text", text: `Error: ${data.error}` }],
      };
    }

    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

src/index.ts:230-257 (schema)

Schema definition for verify_nurse_license tool.

{
  state: z
    .enum(["FL", "NY"])
    .describe("US state code: FL (Florida DOH MQA), NY (New York NYSED)"),
  licenseNumber: z
    .string()
    .optional()
    .describe('License number to look up (e.g. "RN9414870" for FL, "825282" for NY)'),
  lastName: z
    .string()
    .optional()
    .describe("Last name for person name search"),
  firstName: z
    .string()
    .optional()
    .describe("First name for person name search (optional)"),
  licenseType: z
    .string()
    .optional()
    .describe("License type filter: RN, LPN, NP, APRN, CNA"),
  limit: z
    .number()
    .int()
    .min(1)
    .max(25)
    .default(10)
    .describe("Number of results to return (max 25)"),
},

src/index.ts:227-282 (registration)

Tool registration for verify_nurse_license.

server.tool(
  "verify_nurse_license",
  "Verify a nurse's license across US states (FL, NY). Search by license number or name. Returns license status, expiration, qualifications, and enforcement actions from official state nursing boards.",
  {
    state: z
      .enum(["FL", "NY"])
      .describe("US state code: FL (Florida DOH MQA), NY (New York NYSED)"),
    licenseNumber: z
      .string()
      .optional()
      .describe('License number to look up (e.g. "RN9414870" for FL, "825282" for NY)'),
    lastName: z
      .string()
      .optional()
      .describe("Last name for person name search"),
    firstName: z
      .string()
      .optional()
      .describe("First name for person name search (optional)"),
    licenseType: z
      .string()
      .optional()
      .describe("License type filter: RN, LPN, NP, APRN, CNA"),
    limit: z
      .number()
      .int()
      .min(1)
      .max(25)
      .default(10)
      .describe("Number of results to return (max 25)"),
  },
  async ({ state, licenseNumber, lastName, firstName, licenseType, limit }) => {
    const params = new URLSearchParams();
    params.set("state", state);
    params.set("limit", String(limit));
    if (licenseNumber) params.set("licenseNumber", licenseNumber);
    if (lastName) params.set("lastName", lastName);
    if (firstName) params.set("firstName", firstName);
    if (licenseType) params.set("licenseType", licenseType);

    const url = `${BACKEND_URL}/nurse-license/verify?${params.toString()}`;
    const res = await fetch(url);
    const data = await res.json();

    if (!data.success) {
      return {
        isError: true,
        content: [{ type: "text", text: `Error: ${data.error}` }],
      };
    }

    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

Marketplace Search MCP