Tools

Ten tools grouped by domain — geo, timezone, periodic table, physical constants, unit conversion, HTTP, and web:

ref_geo_lookup

Look up a country by name, ISO alpha-2 or alpha-3 code.

• Accepts fuzzy name matching — "Brasil" and "Brazil" both resolve
• Returns full record: capital, region, subregion, official languages, currencies, calling codes, TLD, flag emoji, and IANA timezone IDs
• Lookup modes: auto (tries alpha-2, alpha-3, then name), name, alpha2, alpha3

ref_geo_search

Search and filter countries with at least one filter required.

• Filters: keyword (name, native name, capital, subregion), region, subregion, language (ISO 639-1 code or name), currency (ISO 4217 code or name)
• Returns ranked summaries (alpha-2/3, name, capital, region, primary currency, flag)
• Paginated with configurable limit (1–100); truncated flag when results are cut off

ref_timezone_lookup

Get timezone info for an IANA ID, country code, or city name.

• Partial city matching: "Tokyo" resolves to "Asia/Tokyo", "NY" to "America/New_York"
• Country code queries return all timezones observed in that country
• Optional at parameter evaluates DST state at a specific ISO 8601 moment
• Returns current offset, standard offset, DST status, abbreviations, major cities, and country codes

ref_timezone_convert

Convert a local datetime between timezones.

• Input is a local ISO 8601 datetime without offset (e.g., "2026-05-24T15:30:00")
• Accepts full IANA IDs or unambiguous city names
• Handles DST transitions with a two-pass offset refinement
• Returns source and target local datetimes with their respective UTC offsets, plus the UTC equivalent

ref_element_lookup

Look up any of the 118 periodic table elements.

• Accepts name, symbol, or atomic number
• Full property set: atomic mass (with estimated flag), electron configuration, group, period, block, category, Pauling electronegativity, density, melting and boiling points in kelvin, phase at STP, radioactivity, natural occurrence, and discovery data
• Data sourced from PubChem/IUPAC 2024; synthetic/unstable elements return null for experimentally inaccessible properties

ref_element_search

Filter elements across the full periodic table.

• Filters: category (partial match), group (1–18), period (1–7), atomic number range, atomic mass range
• At least one filter required; returns summaries with atomic number, symbol, name, mass, and category

ref_constant_lookup

Look up CODATA 2022 physical constants (32 entries).

• Fuzzy alias matching: "speed of light", "c", "Avogadro's number", "N_A", "Planck", "h", "Boltzmann", "k_B" all resolve
• Returns value, SI unit expression, absolute and relative uncertainty, exact-definition flag, CODATA identifier, and up to 3 related constants

ref_unit_convert

Convert between units in 11 measurement domains.

• Supported: length (mm–mi), mass (mcg–t), volume (ml–m³), temperature (C/F/K/R, non-linear), speed (m/s, km/h, knot, ft/s), pressure (Pa–psi), energy (J–MWh), power (W–GW), frequency (Hz–GHz), digital storage (b–TB), angle (deg/rad/grad)
• Mass mt is the metric tonne (1000 kg); t is the US short ton (907.18 kg) — distinct units, easily confused
• Incompatible unit pairs return a structured error identifying the quantity mismatch
• Temperatures below absolute zero return a specific error with the Kelvin equivalent

ref_http_status

Look up HTTP status codes by number or keyword.

• Numeric queries (e.g., "404") return an exact match
• Keyword queries (e.g., "not found", "too many requests") return the closest match plus alternatives
• Returns: reason phrase, description, category (1xx–5xx), cacheability per RFC 9110, defining RFC with section reference

ref_mime_type

Look up MIME types by type string or file extension.

• Accepts "image/webp", ".webp", or "webp" interchangeably
• Extension lookups return the canonical MIME type first; additional types sharing the extension are listed as alternatives
• Returns: extensions, compressibility flag (relevant for Content-Encoding decisions), and data source (iana/apache/nginx)

Resources

All resource data is also reachable via tools. Use ref_geo_lookup, ref_element_lookup, and ref_timezone_lookup when you need flexible query modes or country search.

Features

Built on @cyanheads/mcp-ts-core:

• Declarative tool, resource, and prompt definitions — single file per primitive, framework handles registration and validation
• Unified error handling — handlers throw, framework catches, classifies, and formats
• Pluggable auth: none, jwt, oauth
• Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
• Structured logging with optional OpenTelemetry tracing
• STDIO and Streamable HTTP transports

Reference-data-specific:

• Entirely in-memory — all datasets load at startup; no runtime network calls, no API keys, no rate limits
• Works offline and in air-gapped environments
• Seven specialized services: geo (countries-list), timezone (Node.js Intl + @vvo/tzdb), elements (PubChem/IUPAC 2024, 118 elements), constants (CODATA 2022, 32 entries), units (convert-units), HTTP status (IANA registry), MIME types (mime-db, ~1,000 types)

Agent-friendly output: