Skip to main content
Glama

find_authorized_lab

Locate CDC-recognized laboratories for specimen collection and submission by disease and city. Filter results, paginate, and verify provenance for informed decision support.

Instructions

Find CDC recognized-lab rows. decision_support_only=true; verify_current_official_source=true; not_validated_for_hospital_deployment=true; does_not_confirm_current_acceptance=true. 不得輸入病人資料。搜尋結果一次最多 20 筆,要看更多用 offset 翻頁;一家機構的每個檢驗方法各是一筆。疾病和縣市可以分開填(query=傷寒, city=台南市),也可以用空格隔開寫在 query(台南 傷寒);整句問句不會拆。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
cityNo
limitNo
queryYes
offsetNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
itemsYes
limitYes
notesYes
queryYes
offsetYes
safetyYes
warningsYes
data_modeYes
operationYes
truncatedYes
provenanceYes
sample_onlyYes
availabilityYes
result_statusYes
source_statusYes
total_matchesYes
returned_countYes
coverage_detailYes
coverage_statusYes
evaluated_as_ofYes
contract_versionNopublic-contract-v1
evaluated_timezoneYes
snapshot_traceableYes
replacement_operationYes
availability_reason_codeYes
historical_truth_supportedYes
currently_reproducible_from_upstreamYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.1.3
    • addedOutput schema / $defs / CDCManualClauseRecord
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "One numbered clause, figure caption or appendix form of the manual, as printed.",
      +  "properties": {
      +    "block_kind": {
      +      "enum": [
      +        "clause",
      +        "figure",
      +        "appendix"
      +      ],
      +      "title": "Block Kind",
      +      "type": "string"
      +    },
      +    "chapter": {
      +      "title": "Chapter",
      +      "type": "string"
      +    },
      +    "clause_number": {
      +      "title": "Clause Number",
      +      "type": "string"
      +    },
      +    "record_type": {
      +      "const": "cdc_manual_clause",
      +      "default": "cdc_manual_clause",
      +      "title": "Record Type",
      +      "type": "string"
      +    },
      +    "text": {
      +      "title": "Text",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "block_kind",
      +    "clause_number",
      +    "chapter",
      +    "text"
      +  ],
      +  "title": "CDCManualClauseRecord",
      +  "type": "object"
      +}
    • addedOutput schema / $defs / ItemEnvelope / properties / record / discriminator / mapping / cdc_manual_clause
      Added value: +"#/$defs/CDCManualClauseRecord"
    • changedOutput schema / $defs / ItemEnvelope / properties / record / oneOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/NHIRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/NHISearchRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/CDCSpecimenRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/CDCTestingLocationRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/CDCLabRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/TFDARecord"
      -  },
      -  {
      -    "$ref": "#/$defs/TFDASearchRecord"
      -  }
      -]New value: +[
      +  {
      +    "$ref": "#/$defs/NHIRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/NHISearchRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/CDCSpecimenRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/CDCTestingLocationRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/CDCManualClauseRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/CDCLabRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/TFDARecord"
      +  },
      +  {
      +    "$ref": "#/$defs/TFDASearchRecord"
      +  }
      +]
    • changedOutput schema / properties / operation / enum
      Previous value: -[
      -  "get_data_status",
      -  "search_disease",
      -  "get_specimen_requirement",
      -  "get_collection_method",
      -  "get_container",
      -  "get_transport_requirement",
      -  "get_submission_rule",
      -  "get_testing_location",
      -  "find_authorized_lab",
      -  "get_lab_scope",
      -  "search_payment_items",
      -  "search_lab_code",
      -  "get_points",
      -  "get_payment_rule",
      -  "search_reviewed_ivd",
      -  "search_ivd_candidates",
      -  "search_ivd",
      -  "get_license",
      -  "find_manufacturer",
      -  "list_matching_license_records",
      -  "compare_products",
      -  "standards_status",
      -  "eqa_status"
      -]New value: +[
      +  "get_data_status",
      +  "search_disease",
      +  "get_specimen_requirement",
      +  "get_collection_method",
      +  "get_container",
      +  "get_transport_requirement",
      +  "get_submission_rule",
      +  "get_testing_location",
      +  "search_manual_procedure",
      +  "find_authorized_lab",
      +  "get_lab_scope",
      +  "search_payment_items",
      +  "search_lab_code",
      +  "get_points",
      +  "get_payment_rule",
      +  "search_reviewed_ivd",
      +  "search_ivd_candidates",
      +  "search_ivd",
      +  "get_license",
      +  "find_manufacturer",
      +  "list_matching_license_records",
      +  "compare_products",
      +  "standards_status",
      +  "eqa_status"
      +]
    • changedOutput schema / properties / replacement_operation / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "get_data_status",
      -      "search_disease",
      -      "get_specimen_requirement",
      -      "get_collection_method",
      -      "get_container",
      -      "get_transport_requirement",
      -      "get_submission_rule",
      -      "get_testing_location",
      -      "find_authorized_lab",
      -      "get_lab_scope",
      -      "search_payment_items",
      -      "search_lab_code",
      -      "get_points",
      -      "get_payment_rule",
      -      "search_reviewed_ivd",
      -      "search_ivd_candidates",
      -      "search_ivd",
      -      "get_license",
      -      "find_manufacturer",
      -      "list_matching_license_records",
      -      "compare_products",
      -      "standards_status",
      -      "eqa_status"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "get_data_status",
      +      "search_disease",
      +      "get_specimen_requirement",
      +      "get_collection_method",
      +      "get_container",
      +      "get_transport_requirement",
      +      "get_submission_rule",
      +      "get_testing_location",
      +      "search_manual_procedure",
      +      "find_authorized_lab",
      +      "get_lab_scope",
      +      "search_payment_items",
      +      "search_lab_code",
      +      "get_points",
      +      "get_payment_rule",
      +      "search_reviewed_ivd",
      +      "search_ivd_candidates",
      +      "search_ivd",
      +      "get_license",
      +      "find_manufacturer",
      +      "list_matching_license_records",
      +      "compare_products",
      +      "standards_status",
      +      "eqa_status"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed8 schema fields changedv0.1.2
    • addedInput schema / properties / limit
      Added value: +{
      +  "default": 20,
      +  "title": "Limit",
      +  "type": "integer"
      +}
    • addedInput schema / properties / offset
      Added value: +{
      +  "default": 0,
      +  "title": "Offset",
      +  "type": "integer"
      +}
    • addedOutput schema / $defs / CDCReceivingUnitContact
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "One 7.9 receiving unit as the manual prints it (OD-18).",
      +  "properties": {
      +    "address": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Address"
      +    },
      +    "fax": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Fax"
      +    },
      +    "phone": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Phone"
      +    },
      +    "unit_name": {
      +      "title": "Unit Name",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "unit_name",
      +    "phone",
      +    "fax",
      +    "address"
      +  ],
      +  "title": "CDCReceivingUnitContact",
      +  "type": "object"
      +}
    • addedOutput schema / $defs / CDCTestingLocationRecord
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "One chapter 7 row: where a test is sent and how long it takes (OD-18).\n\nThe manual prints 檢驗期限 in most sections and 檢驗期間 in 7.7 (autopsy specimens), so the\ntwo official column names stay separate fields and are never merged into one duration.\n`receiving_unit_contacts` are the 7.9 rows whose unit name appears in this row's 收件單位\ntext; the join happens when the question is answered and every contact keeps its own page,\nsection and row hash in the item's evidence.",
      +  "properties": {
      +    "bsl_raw": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Bsl Raw"
      +    },
      +    "collecting_unit": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Collecting Unit"
      +    },
      +    "disease": {
      +      "title": "Disease",
      +      "type": "string"
      +    },
      +    "method": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Method"
      +    },
      +    "notes": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Notes"
      +    },
      +    "receiving_unit": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Receiving Unit"
      +    },
      +    "receiving_unit_contacts": {
      +      "items": {
      +        "$ref": "#/$defs/CDCReceivingUnitContact"
      +      },
      +      "title": "Receiving Unit Contacts",
      +      "type": "array"
      +    },
      +    "record_type": {
      +      "const": "cdc_testing_location",
      +      "default": "cdc_testing_location",
      +      "title": "Record Type",
      +      "type": "string"
      +    },
      +    "specimen": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Specimen"
      +    },
      +    "testing_period_raw": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Testing Period Raw"
      +    },
      +    "turnaround_raw": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Turnaround Raw"
      +    }
      +  },
      +  "required": [
      +    "disease",
      +    "collecting_unit",
      +    "specimen",
      +    "method",
      +    "turnaround_raw",
      +    "testing_period_raw",
      +    "receiving_unit",
      +    "bsl_raw",
      +    "notes",
      +    "receiving_unit_contacts"
      +  ],
      +  "title": "CDCTestingLocationRecord",
      +  "type": "object"
      +}
    • addedOutput schema / $defs / ItemEnvelope / properties / record / discriminator / mapping / cdc_testing_location
      Added value: +"#/$defs/CDCTestingLocationRecord"
    • changedOutput schema / $defs / ItemEnvelope / properties / record / oneOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/NHIRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/NHISearchRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/CDCSpecimenRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/CDCLabRecord"
      -  },
      -  {
      -    "$ref": "#/$defs/TFDARecord"
      -  },
      -  {
      -    "$ref": "#/$defs/TFDASearchRecord"
      -  }
      -]New value: +[
      +  {
      +    "$ref": "#/$defs/NHIRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/NHISearchRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/CDCSpecimenRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/CDCTestingLocationRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/CDCLabRecord"
      +  },
      +  {
      +    "$ref": "#/$defs/TFDARecord"
      +  },
      +  {
      +    "$ref": "#/$defs/TFDASearchRecord"
      +  }
      +]
    • changedOutput schema / properties / operation / enum
      Previous value: -[
      -  "get_data_status",
      -  "search_disease",
      -  "get_specimen_requirement",
      -  "get_collection_method",
      -  "get_container",
      -  "get_transport_requirement",
      -  "get_submission_rule",
      -  "find_authorized_lab",
      -  "get_lab_scope",
      -  "search_payment_items",
      -  "search_lab_code",
      -  "get_points",
      -  "get_payment_rule",
      -  "search_reviewed_ivd",
      -  "search_ivd_candidates",
      -  "search_ivd",
      -  "get_license",
      -  "find_manufacturer",
      -  "list_matching_license_records",
      -  "compare_products",
      -  "standards_status",
      -  "eqa_status"
      -]New value: +[
      +  "get_data_status",
      +  "search_disease",
      +  "get_specimen_requirement",
      +  "get_collection_method",
      +  "get_container",
      +  "get_transport_requirement",
      +  "get_submission_rule",
      +  "get_testing_location",
      +  "find_authorized_lab",
      +  "get_lab_scope",
      +  "search_payment_items",
      +  "search_lab_code",
      +  "get_points",
      +  "get_payment_rule",
      +  "search_reviewed_ivd",
      +  "search_ivd_candidates",
      +  "search_ivd",
      +  "get_license",
      +  "find_manufacturer",
      +  "list_matching_license_records",
      +  "compare_products",
      +  "standards_status",
      +  "eqa_status"
      +]
    • changedOutput schema / properties / replacement_operation / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "get_data_status",
      -      "search_disease",
      -      "get_specimen_requirement",
      -      "get_collection_method",
      -      "get_container",
      -      "get_transport_requirement",
      -      "get_submission_rule",
      -      "find_authorized_lab",
      -      "get_lab_scope",
      -      "search_payment_items",
      -      "search_lab_code",
      -      "get_points",
      -      "get_payment_rule",
      -      "search_reviewed_ivd",
      -      "search_ivd_candidates",
      -      "search_ivd",
      -      "get_license",
      -      "find_manufacturer",
      -      "list_matching_license_records",
      -      "compare_products",
      -      "standards_status",
      -      "eqa_status"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "get_data_status",
      +      "search_disease",
      +      "get_specimen_requirement",
      +      "get_collection_method",
      +      "get_container",
      +      "get_transport_requirement",
      +      "get_submission_rule",
      +      "get_testing_location",
      +      "find_authorized_lab",
      +      "get_lab_scope",
      +      "search_payment_items",
      +      "search_lab_code",
      +      "get_points",
      +      "get_payment_rule",
      +      "search_reviewed_ivd",
      +      "search_ivd_candidates",
      +      "search_ivd",
      +      "get_license",
      +      "find_manufacturer",
      +      "list_matching_license_records",
      +      "compare_products",
      +      "standards_status",
      +      "eqa_status"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. First observedv0.1.1

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations present, the description carries the full burden of disclosing behavior, and it does so thoroughly: it discloses decision-support-only status, the need to verify against the current official source, non-validation for hospital deployment, non-confirmation of current acceptance, and a prohibition on entering patient data. These are meaningful behavioral constraints beyond a simple read operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but every clause earns its place, from the purpose statement through the safety flags to the pagination and query-format rules. Key behavioral constraints are front-loaded, and the Chinese usage notes are compact rather than verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 4 parameters, no annotations, and an output schema that already handles return structure, the description covers what an agent needs to call the tool correctly: search semantics, pagination, result granularity, safety caveats, and input restrictions. No major missing information remains.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate for all parameter meaning. It explains query and city with concrete examples, clarifies that a full sentence will not be parsed, describes the 20-row page limit and offset-based pagination, and explains what a single result row represents. All four parameters are effectively documented.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Find CDC recognized-lab rows.' This clearly identifies the core operation and the entity being searched. It does not explicitly contrast itself with siblings like search_lab_code or get_lab_scope, so differentiation is left to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives concrete usage patterns: separate disease and city parameters, combine them with a space in query, or avoid full-sentence queries ('整句問句不會拆'). It also explains pagination via offset and the row cardinality (one row per test method). It does not name alternative tools to switch to, so the 'when not to use' guidance is partial.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.