Lookup UNICEF Indicator by Exact Code
lookup_by_codeRetrieve detailed metadata for a UNICEF indicator by providing its exact SDMX code. Designed for code-based lookups, not text searches.
Instructions
Strict canonical lookup of a UNICEF indicator by its exact code.
Use this INSTEAD of search_indicators when you already have a UNICEF indicator code (e.g. CME_MRY0T4, IM_DTP3, ED_15-24_LR). Do NOT pass natural-language descriptions, synonyms, or partial names — this tool is canonical-only.
Two-tool separation introduced in v0.9.0 to give the LLM a self-describing choice at tool-selection time:
have a CODE? → lookup_by_code(code)
have WORDS? → search_indicators(query)
Returns the same canonical metadata shape as get_indicator_info on success. On unknown code, returns an error with an explicit abstain_instruction directing the model to stop — NOT to fall back to search_indicators (which would re-enter the loop that 96% of v9 Arm B stuck queries hit).
Returns:
on success: {status: "ok", code, name, description, dataflow, sdmx_api, disaggregation_filters, ambiguity_flag: false, ...}
on unknown code: {status: "error", error, ambiguity_flag: false, abstain_instruction, tip}
on natural-language input mistakenly passed: {status: "error", error, abstain_instruction directing to search_indicators}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | Exact UNICEF SDMX indicator code (e.g. 'CME_MRY0T4'). Same envelope as get_indicator_info — both route through a shared _build_indicator_envelope helper, so the disaggregation_filters block is literally identical across both tools. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||