Reference Data Mcp Server

cyanheads/reference-data-mcp-server

A Swiss Army knife for reference lookups that saves you from opening a dozen browser tabs. Wraps ten tools covering countries (with ISO codes, capitals, currencies, timezones), IANA timezone conversions with DST handling, all 118 periodic elements with full IUPAC properties, CODATA 2022 physical constants, unit conversions across 11 domains, HTTP status code details with RFC citations, and MIME type resolution. Useful when you're writing documentation, validating API responses, building forms with country dropdowns, or just need to convert 42 kilometers per hour to meters per second without context switching. Data comes from PubChem, IANA, and CODATA 2022. Available over stdio or streamable HTTP at reference-data.caseyjhand.com/mcp.

GitHub stars: 1
tools: 10
transport: STDIO, HTTP
env vars: 6
last updated: Oct 28, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://reference-data.caseyjhand.com/mcp --name reference-data

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http reference-data https://reference-data.caseyjhand.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 10 tools

Verified live against the running server on Nov 6, 2026.

ref_geo_lookupLook 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 r...2 params

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 r...

Parameters* required

bystring

Lookup strategy: auto tries alpha2, alpha3, then name in order.one of auto · name · alpha2 · alpha3default: auto

query*string

Country name (e.g., "Germany"), ISO alpha-2 code (e.g., "DE"), or ISO alpha-3 code (e.g., "DEU").

ref_geo_searchSearch 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.6 params

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.

Parameters* required

currencystring

ISO 4217 currency code (e.g., "EUR") or currency name (e.g., "Euro").

keywordstring

Matches against country name, native name, capital city, and subregion.

languagestring

ISO 639-1 language code (e.g., "pt") or language name (e.g., "Portuguese").

limitinteger

Maximum number of results to return (1–100).default: 20

regionstring

Filter by continent region: Africa, Americas, Asia, Europe, Oceania, or Antarctic.

subregionstring

Filter by subregion (e.g., "Western Europe", "Southeast Asia", "South America").

ref_timezone_lookupGet 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....3 params

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....

Parameters* required

atstring

ISO 8601 datetime to evaluate timezone state at a specific moment (e.g., "2026-01-15T12:00:00"). Defaults to current time.

bystring

Lookup mode: iana for exact IANA ID, country for ISO alpha-2 code, auto tries all strategies.one of iana · country · autodefault: auto

query*string

IANA timezone ID (e.g., "America/New_York"), ISO alpha-2 country code (e.g., "US"), or partial city/region name (e.g., "Tokyo", "London").

ref_timezone_convertConvert 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 a...3 params

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 a...

Parameters* required

datetime*string

Local datetime in ISO 8601 format without timezone offset (e.g., "2026-05-24T15:30:00"). Do not include "Z" or an offset suffix.

from_tz*string

Source IANA timezone ID or unambiguous city name (e.g., "Asia/Tokyo" or "Tokyo").

to_tz*string

Target IANA timezone ID or unambiguous city name (e.g., "America/New_York" or "New York").

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"), P...2 params

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"), P...

Parameters* required

bystring

Lookup mode: auto tries atomic number, then symbol, then name.one of auto · name · symbol · numberdefault: auto

query*string

Element name (e.g., "tungsten"), chemical symbol (e.g., "W"), or atomic number as a string (e.g., "74").

ref_element_searchFilter 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,...5 params

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,...

Parameters* required

atomic_mass_rangeobject

Inclusive range of atomic mass in unified atomic mass units.

atomic_number_rangeobject

Inclusive range of atomic numbers to include.

categorystring

Element category (partial match): alkali metal, alkaline earth metal, transition metal, post-transition metal, metalloid, reactive nonmetal, noble gas, lanthanide, actinide.

groupinteger

Periodic table group number (1–18). Lanthanides and actinides have no group.

periodinteger

Periodic table period (1–7).

ref_constant_lookupLook 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...1 params

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...

Parameters* required

query*string

Constant name, symbol, or common alias (e.g., "speed of light", "c", "Avogadro", "N_A", "Planck constant", "h").

ref_unit_convertConvert 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), temperat...3 params

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), temperat...

Parameters* required

from*string

Source unit abbreviation (e.g., "km", "C", "m/h", "kWh", "kg").

to*string

Target unit abbreviation (e.g., "mi", "F", "m/s", "kJ", "lb").

value*number

Numeric quantity to convert.

ref_http_statusLook 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...1 params

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...

Parameters* required

query*string

Numeric status code (e.g., "404" or "422") or descriptive keyword (e.g., "not found", "too many requests", "unprocessable").

ref_mime_typeLook 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 ex...1 params

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 ex...

Parameters* required

query*string

MIME type string (e.g., "application/json", "image/webp") or file extension with or without leading dot (e.g., ".webp", "webp", "js", ".html").

Configuration

MCP_LOG_LEVELdefault: info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

MCP_HTTP_HOSTdefault: 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault: none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Readme

@cyanheads/reference-data-mcp-server

Look up countries, timezones, periodic table elements, physical constants, units, HTTP status codes, and MIME types via MCP. STDIO or Streamable HTTP.

10 Tools • 3 Reference Resource Families • 1 Agent Skill

View the full README on GitHub

Details

Repository: github.com/cyanheads/reference-data-mcp-server
Category: Data & Analytics
Package: @cyanheads/reference-data-mcp-server
Transport: STDIO, HTTP
Registry: MCP registry, active
Resources: 1
Tools verified: Nov 6, 2026

Related Data & Analytics MCP servers

View all

Gogcli Mcp Sheetschrischall/gogcli-mcpExtended Google Sheets for Claude via gogcli — auth + full Sheets support1stars

Dingdawg Data Agentdingdawg/dingdawg-agent-1AI data agent — schema analysis, query optimization, PII detection, pipelines.0stars

Nordic Datamnymann/nordic-data-mcpCompany, KYB, VAT, sanctions, LEI and address data for 15 EU countries.1stars

Data Gov Inpipeworx-io/mcp-data-gov-inIndia Open Government Data (OGD) Platform MCP — data.gov.in1stars

Data Nypipeworx-io/mcp-data-nydata.ny.gov Socrata MCP.1stars

RTK Motion — Motion Capture, Biomechanics, Threat & Fleet Intelligencertkmotion/motion-intelligenceMocap, rehab biomechanics, threat intel, fleet vision. 21 MCP tools, 10 free. x402/USDC paid.0stars

Reference Data Mcp Server

Install

Tools

Configuration

Readme

@cyanheads/reference-data-mcp-server

Details

More from cyanheads

Related Data & Analytics MCP servers