Element Lookup
ref_element_lookupLook up a periodic table element by name, chemical symbol, or atomic number. Returns the full data record: atomic number, symbol, name, atomic mass (in unified atomic mass units), electron configuration, group, period, block, category (e.g., "noble gas", "transition metal"), Pauling electronegativity, density (g/cm³), melting and boiling points in kelvin, and discovery year. Properties unavailable for synthetic or insufficiently studied elements are returned as null.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "ref_element_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | Lookup mode: auto tries atomic number, then symbol, then name. | auto |
| query | Yes | Element name (e.g., "tungsten"), chemical symbol (e.g., "W"), or atomic number as a string (e.g., "74"). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | IUPAC element name. | |
| block | No | Electron block: s, p, d, or f. | |
| error | No | Present when the call failed. Absent on success. | |
| group | No | Periodic table group number (1–18). Null for lanthanides and actinides. | |
| number | No | Atomic number (proton count). | |
| period | No | Periodic table period number (1–7). | |
| symbol | No | Chemical symbol (e.g., "Fe"). | |
| natural | No | True if the element occurs naturally on Earth. | |
| category | No | Element category (e.g., "transition metal", "noble gas", "lanthanide"). | |
| appearance | No | Physical appearance description. Null for synthetic elements not macroscopically observed. | |
| atomic_mass | No | Standard atomic mass in unified atomic mass units (u). Null for unstable elements with no standard mass. | |
| radioactive | No | True if all isotopes are radioactive (no stable isotopes). | |
| phase_at_stp | No | Phase at standard temperature and pressure: Solid, Liquid, or Gas. | |
| discovery_year | No | Year of discovery. Null for elements known since antiquity. | |
| boiling_point_k | No | Boiling point in kelvin at standard pressure. Null for unstable or synthetic elements. | |
| dataset_version | No | Data source version identifier. | |
| melting_point_k | No | Melting point in kelvin at standard pressure. Null for unstable or synthetic elements. | |
| density_g_per_cm3 | No | Density in grams per cubic centimeter at STP. Null for synthetic or poorly studied elements. | |
| discovery_scientists | No | Scientist(s) credited with discovery. Null for elements known since antiquity. | |
| atomic_mass_estimated | No | True when the atomic mass is estimated or based on the most stable isotope rather than a natural abundance average. | |
| electron_configuration | No | Electron configuration using noble gas shorthand (e.g., "[Ar] 3d6 4s2"). | |
| electronegativity_pauling | No | Pauling electronegativity scale value. Null for noble gases and heavy synthetic elements. |