reference-data-mcp-server
Server Details
Countries, timezones, elements, constants, HTTP status codes, unit conversion, and MIME type lookup.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/reference-data-mcp-server
- GitHub Stars
- 1
- Server Listing
- @cyanheads/reference-data-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 10 tools
Each tool is scoped to a distinct reference domain or operation: constants, elements, countries, HTTP statuses, MIME types, timezones, and units. Lookup/search pairs for elements and geo are clearly separated by specific-record vs filtered-summary behavior, and timezone lookup vs convert serve different tasks. No two tools appear to answer the same query.
The ref_ prefix and mostly <domain>_<action> structure create a predictable pattern, as seen in ref_element_lookup, ref_element_search, ref_timezone_lookup, and ref_unit_convert. However, ref_http_status and ref_mime_type omit an explicit action suffix, slightly breaking the otherwise consistent convention. These deviations are minor and easy to infer.
Ten tools is a well-scoped size for a multi-domain reference server; each category gets one or two focused tools without redundancy. This is neither too thin nor too heavy, and every tool has a clear purpose.
Core reference workflows are fully covered: specific lookups for constants, elements, countries, HTTP statuses, and MIME types are paired with broader operations like element/country filtering, timezone conversion, and unit conversion. Static reference data does not need CRUD, and query variants such as aliases, partial names, extensions, and keywords are handled. Obvious gaps like currency conversion or list-all endpoints fall outside the server's apparent scope.
Available Tools
10 toolsref_constant_lookupPhysical Constant LookupARead-onlyInspect
Look up a fundamental physical constant by name, symbol, or common alias. Returns the CODATA 2022 value, SI unit expression, relative standard uncertainty, and a short description. Recognizes common names and symbols — "speed of light", "c", "Avogadro's number", "N_A", "Planck", "h", "Boltzmann", "k_B" all resolve correctly. Fuzzy matching returns the closest match plus alternatives.
Inputs: query (required). Returns: name, unit, error, exact, +9 more
ref_element_lookupElement LookupARead-onlyInspect
Look 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.
Inputs: query (required), by. Returns: name, block, error, group, +18 more
ref_element_searchElement SearchARead-onlyInspect
Filter periodic table elements by category, group, period, atomic number range, or atomic mass range. At least one filter is required. Returns matching elements as a summary list. Use ref_element_lookup for the full record on a specific element. Valid categories: alkali metal, alkaline earth metal, transition metal, post-transition metal, metalloid, reactive nonmetal, noble gas, lanthanide, actinide.
Inputs: group, period, category, atomic_mass_range, +1 more. Returns: error, notice, results, totalMatches, +1 more
ref_geo_lookupCountry LookupARead-onlyInspect
Look up a country by name, ISO alpha-2 code (2 letters), or ISO alpha-3 code (3 letters). Returns the full record: capital, region, official languages, currencies, calling codes, TLD, flag emoji, and IANA timezone IDs. Accepts fuzzy name matching — "Brasil" and "Brazil" both resolve.
Inputs: query (required), by. Returns: tld, flag, name, error, +11 more
ref_geo_searchCountry SearchARead-onlyInspect
Search and filter countries by region, subregion, language, currency, or free-text keyword. At least one filter is required. Returns a ranked list of matching country summaries. Use ref_geo_lookup to get the full record for a specific result.
Inputs: limit, region, keyword, currency, +2 more. Returns: error, notice, results, truncated, +2 more
ref_http_statusHTTP Status Code LookupARead-onlyInspect
Look up an HTTP status code by number or keyword. Returns the reason phrase, description, category (1xx Informational, 2xx Success, 3xx Redirection, 4xx Client Error, 5xx Server Error), whether the code is cacheable by default, and the defining RFC with section reference. For keyword queries, returns the closest match plus alternatives.
Inputs: query (required). Returns: rfc, code, error, category, +5 more
ref_mime_typeMIME Type LookupARead-onlyInspect
Look up a MIME type by type string or file extension. Accepts "image/webp", ".webp", or "webp". Returns the canonical MIME type, known file extensions, whether the type is compressible (relevant for Content-Encoding decisions), and the data source (iana, apache, nginx). For extension lookups, returns the canonical MIME type — e.g., ".jpg" resolves to "image/jpeg". When multiple types map to an extension, the canonical type is returned first with alternatives listed.
Inputs: query (required). Returns: type, error, source, extensions, +2 more
ref_timezone_convertTimezone ConversionARead-onlyInspect
Convert a local datetime from one timezone to another. Takes a local time string (no UTC offset, e.g., "2026-05-24T15:30:00") interpreted as local time in the source timezone, returns the equivalent local time in the target timezone. Shows both UTC offsets so DST transitions are visible. Accepts full IANA IDs (e.g., "Asia/Tokyo") or unambiguous city names (e.g., "Tokyo").
Inputs: to_tz (required), from_tz (required), datetime (required). Returns: error, source, target, utc_equivalent
ref_timezone_lookupTimezone LookupARead-onlyInspect
Get timezone info by IANA ID, country code, or partial city/region name. Returns current UTC offset, standard offset, whether DST is currently active, and major cities in the timezone. When querying by country code (ISO alpha-2), returns all timezones observed in that country. Accepts partial matches — "Tokyo" resolves to "Asia/Tokyo", "NY" resolves to "America/New_York".
Inputs: query (required), at, by. Returns: error, timezones, evaluated_at
ref_unit_convertUnit ConversionARead-onlyInspect
Convert a numeric value between compatible units of measure. Supports: length (mm, cm, m, km, in, ft, yd, mi), mass (mcg, mg, g, kg, oz, lb, mt = metric tonne / 1000 kg, t = US short ton / 907.18 kg), volume (ml, cl, dl, l, kl, tsp, Tbs, fl-oz, cup, pnt, qt, gal, m3), temperature (C, F, K, R — non-linear conversions handled), speed (m/s, km/h, knot, ft/s), pressure (Pa, kPa, MPa, hPa, bar, torr, psi), energy (J, kJ, Wh, kWh, MWh), power (W, mW, kW, MW, GW), frequency (Hz, kHz, MHz, GHz), digital storage (b, Kb, Mb, Gb, Tb, B, KB, MB, GB, TB), and angle (deg, rad, grad). Incompatible units (e.g., km to kg) return an error identifying the quantity mismatch.
Inputs: to (required), from (required), value (required). Returns: error, value, result, measure, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Weather, geocoding, FX rates, holidays, time zones, countries, earthquakes, sun and moon.
Weather, geocoding, FX rates, holidays, time zones, countries, earthquakes, sun and moon.
Exchange rates, public holidays for 100+ countries, time zones and conversions
Reference data API for classification systems, real-time world data, and unit conversions
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to look up a sourced, versioned dataset covering every country in Arabic, English, or both: names, nationalities, capitals, currencies, languages, time zones, dial codes, phone validation, address formats, and ISO 3166-2 subdivisions. Supports country search with Arabic-aware normalization, phone parsing to E.164, nationality selection, and subdivision lookups.118 npm-

foss42 MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables local, no-API-key access to country data lookup and search, text and case conversion, and human-friendly number and date formatting through MCP tools.3Apache 2.0- AlicenseNot gradedqualityDmaintenanceConverts units, currencies, timezones, and dates with a generous free tier of 500 calls/month.1MIT
- AlicenseAqualityBmaintenanceProvides accurate time zone conversions, DST-safe scheduling, holidays for 200+ countries, business day calculations, and cross-zone meeting slot suggestions.51MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.