Skip to main content
Chemia Discovery
Browse the documentation

resolve_material_name tool

Resolves a commercial or common name, a formula or a Chemia ID to one canonical material, with its Chemia ID, formula and dataset. It is not charged against the daily allowance.

At a glance
Toolresolve_material_name
TitleResolve material name
GroupLook up a material
ChargedNo
Read-onlyYes
Parameters2, of which 1 required

What parameters does resolve_material_name take?

Parameters of resolve_material_name
ParameterTypeRequiredDefaultWhat it does
namestringYesnoneWhat to resolve: a common name such as "sapphire", a formula such as Al2O3, a Chemia ID such as CH-MAT-1599, or an internal id. Resolution tries the Chemia ID, then the internal id, then the name table (which pins one structure for a known name), then a formula match in the dataset.
source_idstring or nullNonot setDataset to resolve in, an id from list_material_sources. Null (the default) uses the server's default dataset. source, requested_source and source_downgraded in the response say what ran. An id that is not in the catalogue falls back to the registry default without an error.

Does resolve_material_name use my daily allowance?

  • Charged: no, it never uses the daily allowance.
  • Who can call it: your client lists the tools your account is entitled to, so a tool appears only when you can use it.

The allowance and the account rules are explained in Access and limits.

Annotations the server sets on resolve_material_name
AnnotationValueMeaning
idempotentHinttrueIf true, calling the tool again with the same arguments has no additional effect.
openWorldHintfalseIf true, the tool may interact with an open world of external entities.
readOnlyHinttrueIf true, the tool does not modify its environment.

What does a call to resolve_material_name look like?

A common name.

Example arguments for resolve_material_name
{
  "name": "sapphire"
}

These arguments show how a call is written and validate against the tool's input schema.

How should I read resolve_material_name results?

  • Good to know. The tool answers with one material by design. A formula that fits several structures returns status "ambiguous" with up to 8 candidates, the full total and the ground_state. The candidates are in Chemia ID order, not stability order, so the first is not the most stable; find_material_entries lists every entry.
  • Check this. A common name is pinned to one specific structure. When that structure is not in the dataset you queried, the lowest-energy entry of the formula in that dataset stands in, so the Chemia ID returned can be a different structure than the name usually means.

"Good to know" explains a field whose meaning is not obvious, "Check this" marks a result that can look right and still mislead, and "Coverage note" says what the data does not cover. Reading results explains all three.

How does the server describe resolve_material_name?

This is the description an assistant sees for the tool.

Resolve a commercial or common material name to one canonical material, for example "sapphire" -> "Al2O3".

Returns that material's chemia_id (the user-facing Chemia identifier), its canonical formula, and the dataset_tag it belongs to. status is "found" (exactly one match), "ambiguous" (several matched, check candidates), or "not_found". This tool answers with ONE material by design; for "how many entries exist for X", that is a different question than this tool answers.

Resolved against the database, so it is dataset-scoped like every other lookup here: source_id explicitly picks a dataset from list_material_sources, and source/source_downgraded on the response report which one actually ran and whether your request was narrowed.

resolve_material_name is in the group "Look up a material". The other tools in it:

  • classify_material: Classifies materials as metal, semi-metal, semiconductor or insulator from their band gap, one result per input in the same order.
  • find_material_entries: Lists every entry that matches a formula, a common name or a Chemia ID, with its structure and stability, so you can see all the polymorphs of a compound and pick the one you mean.
  • get_all_material_properties: Lists every stored property of one material in a single call, each with its value, unit and kind of evidence, plus the material's structure.
  • get_material_property: Reads one stored property of one material, with its unit, the kind of evidence it comes from, and the material's structure.

The Tool reference lists every tool.