Server definition
- Hash
- sha256:8832b87eb7feaedc8a9044eff149a423032afdedc34068d27cf3dcae9af2e75f
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": "Pure in-memory reference data server. No external API calls, no auth required. Use ref_geo_lookup/search for country data, ref_timezone_lookup/convert for timezone operations, ref_element_lookup/search for periodic table, ref_constant_lookup for CODATA 2022 physical constants, ref_unit_convert for unit conversion, ref_http_status for HTTP status codes, ref_mime_type for MIME type and file extension lookups.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"query": {
"description": "Constant name, symbol, or common alias (e.g., \"speed of light\", \"c\", \"Avogadro\", \"N_A\", \"Planck constant\", \"h\").",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ref_constant_lookup",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"name",
"symbol",
"value",
"unit",
"uncertainty",
"uncertainty_relative",
"description",
"codata_id",
"exact",
"match_strategy",
"dataset_version",
"related"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"codata_id": {
"description": "CODATA identifier string, or null if not in CODATA registry.",
"type": [
"string",
"null"
]
},
"dataset_version": {
"description": "Data source version (CODATA year).",
"type": "string"
},
"description": {
"description": "Short description of the constant and its significance.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_match`: No constant matched the query. Other values are possible when a failure originates below the handler.",
"examples": [
"no_match"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"exact": {
"description": "True when the constant has an exact defined value (no experimental uncertainty).",
"type": "boolean"
},
"match_strategy": {
"description": "How this constant was matched: exact_symbol = case-sensitive symbol hit (e.g. \"G\"), exact_name = exact alias/name match, fuzzy = partial or contains match. fuzzy signals the query was imprecise and the result is the closest candidate.",
"enum": [
"exact_symbol",
"exact_name",
"fuzzy"
],
"type": "string"
},
"name": {
"description": "Full CODATA constant name.",
"type": "string"
},
"related": {
"description": "Related constants that also matched the query.",
"items": {
"additionalProperties": false,
"description": "A related constant that also matched the query.",
"properties": {
"name": {
"description": "Related constant name.",
"type": "string"
},
"symbol": {
"description": "Related constant symbol.",
"type": "string"
}
},
"required": [
"name",
"symbol"
],
"type": "object"
},
"type": "array"
},
"symbol": {
"description": "Standard mathematical symbol.",
"type": "string"
},
"uncertainty": {
"description": "Absolute standard uncertainty in SI units. Null for exactly-defined constants.",
"type": [
"number",
"null"
]
},
"uncertainty_relative": {
"description": "Relative standard uncertainty or \"exact (defined)\" for exact values.",
"type": [
"string",
"null"
]
},
"unit": {
"description": "SI unit expression (e.g., \"m s⁻¹\", \"J K⁻¹\", \"dimensionless\").",
"type": "string"
},
"value": {
"description": "Numeric value in SI units.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"by": {
"default": "auto",
"description": "Lookup mode: auto tries atomic number, then symbol, then name.",
"enum": [
"auto",
"name",
"symbol",
"number"
],
"type": "string"
},
"query": {
"description": "Element name (e.g., \"tungsten\"), chemical symbol (e.g., \"W\"), or atomic number as a string (e.g., \"74\").",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ref_element_lookup",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"number",
"symbol",
"name",
"atomic_mass",
"atomic_mass_estimated",
"electron_configuration",
"group",
"period",
"block",
"category",
"electronegativity_pauling",
"density_g_per_cm3",
"melting_point_k",
"boiling_point_k",
"discovery_year",
"discovery_scientists",
"appearance",
"phase_at_stp",
"radioactive",
"natural",
"dataset_version"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appearance": {
"description": "Physical appearance description. Null for synthetic elements not macroscopically observed.",
"type": [
"string",
"null"
]
},
"atomic_mass": {
"description": "Standard atomic mass in unified atomic mass units (u). Null for unstable elements with no standard mass.",
"type": [
"number",
"null"
]
},
"atomic_mass_estimated": {
"description": "True when the atomic mass is estimated or based on the most stable isotope rather than a natural abundance average.",
"type": "boolean"
},
"block": {
"description": "Electron block: s, p, d, or f.",
"type": "string"
},
"boiling_point_k": {
"description": "Boiling point in kelvin at standard pressure. Null for unstable or synthetic elements.",
"type": [
"number",
"null"
]
},
"category": {
"description": "Element category (e.g., \"transition metal\", \"noble gas\", \"lanthanide\").",
"type": "string"
},
"dataset_version": {
"description": "Data source version identifier.",
"type": "string"
},
"density_g_per_cm3": {
"description": "Density in grams per cubic centimeter at STP. Null for synthetic or poorly studied elements.",
"type": [
"number",
"null"
]
},
"discovery_scientists": {
"description": "Scientist(s) credited with discovery. Null for elements known since antiquity.",
"type": [
"string",
"null"
]
},
"discovery_year": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Year of discovery. Null for elements known since antiquity."
},
"electron_configuration": {
"description": "Electron configuration using noble gas shorthand (e.g., \"[Ar] 3d6 4s2\").",
"type": "string"
},
"electronegativity_pauling": {
"description": "Pauling electronegativity scale value. Null for noble gases and heavy synthetic elements.",
"type": [
"number",
"null"
]
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_match`: No element matched the query. Other values are possible when a failure originates below the handler.",
"examples": [
"no_match"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"group": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Periodic table group number (1–18). Null for lanthanides and actinides."
},
"melting_point_k": {
"description": "Melting point in kelvin at standard pressure. Null for unstable or synthetic elements.",
"type": [
"number",
"null"
]
},
"name": {
"description": "IUPAC element name.",
"type": "string"
},
"natural": {
"description": "True if the element occurs naturally on Earth.",
"type": "boolean"
},
"number": {
"description": "Atomic number (proton count).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"period": {
"description": "Periodic table period number (1–7).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"phase_at_stp": {
"description": "Phase at standard temperature and pressure: Solid, Liquid, or Gas.",
"type": "string"
},
"radioactive": {
"description": "True if all isotopes are radioactive (no stable isotopes).",
"type": "boolean"
},
"symbol": {
"description": "Chemical symbol (e.g., \"Fe\").",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"atomic_mass_range": {
"description": "Inclusive range of atomic mass in unified atomic mass units.",
"properties": {
"max": {
"description": "Maximum value (inclusive).",
"type": "number"
},
"min": {
"description": "Minimum value (inclusive).",
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"atomic_number_range": {
"description": "Inclusive range of atomic numbers to include.",
"properties": {
"max": {
"description": "Maximum value (inclusive).",
"type": "number"
},
"min": {
"description": "Minimum value (inclusive).",
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"category": {
"description": "Element category (partial match): alkali metal, alkaline earth metal, transition metal, post-transition metal, metalloid, reactive nonmetal, noble gas, lanthanide, actinide.",
"type": "string"
},
"group": {
"description": "Periodic table group number (1–18). Lanthanides and actinides have no group.",
"maximum": 18,
"minimum": 1,
"type": "integer"
},
"period": {
"description": "Periodic table period (1–7).",
"maximum": 7,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "ref_element_search",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalMatches",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Active filters applied to the search.",
"properties": {
"atomic_mass_range": {
"additionalProperties": false,
"description": "Atomic mass range applied.",
"properties": {
"max": {
"description": "Maximum value (inclusive).",
"type": "number"
},
"min": {
"description": "Minimum value (inclusive).",
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"atomic_number_range": {
"additionalProperties": false,
"description": "Atomic number range applied.",
"properties": {
"max": {
"description": "Maximum value (inclusive).",
"type": "number"
},
"min": {
"description": "Minimum value (inclusive).",
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"category": {
"description": "Category filter applied.",
"type": "string"
},
"group": {
"description": "Group filter applied.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"period": {
"description": "Period filter applied.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_filters`: No filter was provided. Other values are possible when a failure originates below the handler.",
"examples": [
"no_filters"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Recovery hint when no elements matched — echoes active filters and suggests how to broaden.",
"type": "string"
},
"results": {
"description": "Matching element summaries.",
"items": {
"additionalProperties": false,
"description": "Summary for a matching element.",
"properties": {
"atomic_mass": {
"description": "Atomic mass in unified atomic mass units. Null for unstable elements.",
"type": [
"number",
"null"
]
},
"atomic_mass_estimated": {
"description": "True when the atomic mass is estimated.",
"type": "boolean"
},
"category": {
"description": "Element category.",
"type": "string"
},
"name": {
"description": "IUPAC element name.",
"type": "string"
},
"number": {
"description": "Atomic number.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"symbol": {
"description": "Chemical symbol.",
"type": "string"
}
},
"required": [
"number",
"symbol",
"name",
"atomic_mass",
"atomic_mass_estimated",
"category"
],
"type": "object"
},
"type": "array"
},
"totalMatches": {
"description": "Number of elements matching all filters.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"by": {
"default": "auto",
"description": "Lookup strategy: auto tries alpha2, alpha3, then name in order.",
"enum": [
"auto",
"name",
"alpha2",
"alpha3"
],
"type": "string"
},
"query": {
"description": "Country name (e.g., \"Germany\"), ISO alpha-2 code (e.g., \"DE\"), or ISO alpha-3 code (e.g., \"DEU\").",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ref_geo_lookup",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"alpha2",
"alpha3",
"name",
"native_name",
"capital",
"region",
"subregion",
"languages",
"currencies",
"calling_codes",
"tld",
"flag",
"timezones"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"alpha2": {
"description": "ISO 3166-1 alpha-2 code (2 letters).",
"type": "string"
},
"alpha3": {
"description": "ISO 3166-1 alpha-3 code (3 letters).",
"type": "string"
},
"calling_codes": {
"description": "International dialing codes with leading + (e.g., \"+1\", \"+44\").",
"items": {
"type": "string"
},
"type": "array"
},
"capital": {
"description": "Capital city name, or null if not applicable (e.g., Antarctica).",
"type": [
"string",
"null"
]
},
"currencies": {
"description": "Currencies used in the country.",
"items": {
"additionalProperties": false,
"description": "Currency used in the country.",
"properties": {
"code": {
"description": "ISO 4217 currency code (e.g., \"USD\").",
"type": "string"
},
"name": {
"description": "Full currency name.",
"type": "string"
},
"symbol": {
"description": "Currency symbol (e.g., \"$\"), or null if unknown.",
"type": [
"string",
"null"
]
}
},
"required": [
"code",
"name",
"symbol"
],
"type": "object"
},
"type": "array"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_match`: No country matched the query. Other values are possible when a failure originates below the handler.",
"examples": [
"no_match"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"flag": {
"description": "Flag emoji (e.g., 🇩🇪).",
"type": "string"
},
"languages": {
"description": "Official or widely spoken languages in the country.",
"items": {
"additionalProperties": false,
"description": "Language spoken in the country.",
"properties": {
"code": {
"description": "ISO 639-1 language code (e.g., \"en\").",
"type": "string"
},
"name": {
"description": "English name of the language.",
"type": "string"
}
},
"required": [
"code",
"name"
],
"type": "object"
},
"type": "array"
},
"name": {
"description": "Official English country name.",
"type": "string"
},
"native_name": {
"description": "Country name in the primary native language.",
"type": "string"
},
"notice": {
"description": "Present only when the country was resolved via fuzzy name matching (starts-with or contains), not an exact code or name hit. Echoes the query and the resolved country so the caller can normalize follow-up lookups.",
"type": "string"
},
"region": {
"description": "Continent-level region (Africa, Americas, Asia, Europe, Oceania, Antarctic).",
"type": "string"
},
"subregion": {
"description": "Subregion within the continent (e.g., \"Western Europe\"), or null if unavailable.",
"type": [
"string",
"null"
]
},
"timezones": {
"description": "IANA timezone IDs observed in this country (e.g., \"America/New_York\").",
"items": {
"type": "string"
},
"type": "array"
},
"tld": {
"description": "Country-code top-level domain (e.g., \".de\"), or null if not applicable.",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"currency": {
"description": "ISO 4217 currency code (e.g., \"EUR\") or currency name (e.g., \"Euro\").",
"type": "string"
},
"keyword": {
"description": "Matches against country name, native name, capital city, and subregion.",
"type": "string"
},
"language": {
"description": "ISO 639-1 language code (e.g., \"pt\") or language name (e.g., \"Portuguese\").",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum number of results to return (1–100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"region": {
"description": "Filter by continent region: Africa, Americas, Asia, Europe, Oceania, or Antarctic.",
"type": "string"
},
"subregion": {
"description": "Filter by subregion (e.g., \"Western Europe\", \"Southeast Asia\", \"South America\").",
"type": "string"
}
},
"type": "object"
},
"name": "ref_geo_search",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"totalMatches",
"truncated",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"additionalProperties": false,
"description": "Active filters applied to the search.",
"properties": {
"currency": {
"description": "Currency filter applied.",
"type": "string"
},
"keyword": {
"description": "Keyword filter applied.",
"type": "string"
},
"language": {
"description": "Language filter applied.",
"type": "string"
},
"limit": {
"description": "Result limit applied.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"region": {
"description": "Region filter applied.",
"type": "string"
},
"subregion": {
"description": "Subregion filter applied.",
"type": "string"
}
},
"required": [
"limit"
],
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_filters`: No filter or keyword was provided. Other values are possible when a failure originates below the handler.",
"examples": [
"no_filters"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Recovery hint when no countries matched — echoes active filters and suggests how to broaden.",
"type": "string"
},
"results": {
"description": "Matching country summaries, up to limit.",
"items": {
"additionalProperties": false,
"description": "Summary for a matching country.",
"properties": {
"alpha2": {
"description": "ISO alpha-2 code.",
"type": "string"
},
"alpha3": {
"description": "ISO alpha-3 code.",
"type": "string"
},
"capital": {
"description": "Capital city, or null if not applicable.",
"type": [
"string",
"null"
]
},
"currency_code": {
"description": "Primary currency ISO 4217 code.",
"type": [
"string",
"null"
]
},
"flag": {
"description": "Flag emoji.",
"type": "string"
},
"name": {
"description": "English country name.",
"type": "string"
},
"region": {
"description": "Continent-level region.",
"type": "string"
}
},
"required": [
"alpha2",
"alpha3",
"name",
"capital",
"region",
"currency_code",
"flag"
],
"type": "object"
},
"type": "array"
},
"totalMatches": {
"description": "Total countries matching the filters before limit is applied.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"truncated": {
"description": "True when totalMatches exceeds the limit and results are cut off.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"query": {
"description": "Numeric status code (e.g., \"404\" or \"422\") or descriptive keyword (e.g., \"not found\", \"too many requests\", \"unprocessable\").",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ref_http_status",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"code",
"reason_phrase",
"description",
"category",
"cacheable",
"rfc",
"rfc_section"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"alternatives": {
"description": "Other status codes that matched the keyword query. Present only for keyword searches with multiple matches.",
"items": {
"additionalProperties": false,
"description": "An alternative HTTP status code that also matched.",
"properties": {
"category": {
"description": "Status code category.",
"type": "string"
},
"code": {
"description": "HTTP status code.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"reason_phrase": {
"description": "Reason phrase.",
"type": "string"
}
},
"required": [
"code",
"reason_phrase",
"category"
],
"type": "object"
},
"type": "array"
},
"cacheable": {
"description": "Whether this status code is cacheable by default per RFC 9110.",
"type": "boolean"
},
"category": {
"description": "Status code category (1xx Informational, 2xx Success, 3xx Redirection, 4xx Client Error, 5xx Server Error).",
"type": "string"
},
"code": {
"description": "HTTP status code number.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"description": {
"description": "Human-readable description of when and why this status is used.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_match`: No HTTP status code matched the query. Other values are possible when a failure originates below the handler.",
"examples": [
"no_match"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"reason_phrase": {
"description": "IANA reason phrase (e.g., \"Not Found\").",
"type": "string"
},
"rfc": {
"description": "Defining RFC (e.g., \"RFC 9110\").",
"type": "string"
},
"rfc_section": {
"description": "RFC section number (e.g., \"15.5.5\"), or null if not applicable.",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"query": {
"description": "MIME type string (e.g., \"application/json\", \"image/webp\") or file extension with or without leading dot (e.g., \".webp\", \"webp\", \"js\", \".html\").",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ref_mime_type",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"type",
"extensions",
"compressible",
"source"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"alternatives": {
"description": "Other MIME types that also map to the queried extension, when multiple types share the extension.",
"items": {
"additionalProperties": false,
"description": "An alternative MIME type mapping to the same extension.",
"properties": {
"source": {
"description": "Data source for this type (e.g., \"iana\", \"apache\").",
"type": [
"string",
"null"
]
},
"type": {
"description": "Alternative MIME type.",
"type": "string"
}
},
"required": [
"type",
"source"
],
"type": "object"
},
"type": "array"
},
"compressible": {
"description": "True when this type is compressible (e.g., text and JSON types); false when not; null when unknown.",
"type": [
"boolean",
"null"
]
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_match`: The MIME type or file extension is not recognized. Other values are possible when a failure originates below the handler.",
"examples": [
"no_match"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"extensions": {
"description": "Known file extensions for this MIME type, without leading dots.",
"items": {
"type": "string"
},
"type": "array"
},
"source": {
"description": "Data source: \"iana\" (IANA registry), \"apache\", \"nginx\", or null.",
"type": [
"string",
"null"
]
},
"type": {
"description": "Canonical MIME type string (e.g., \"image/jpeg\").",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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\").",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"datetime": {
"description": "Local datetime in ISO 8601 format without timezone offset (e.g., \"2026-05-24T15:30:00\"). Do not include \"Z\" or an offset suffix.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$",
"type": "string"
},
"from_tz": {
"description": "Source IANA timezone ID or unambiguous city name (e.g., \"Asia/Tokyo\" or \"Tokyo\").",
"type": "string"
},
"to_tz": {
"description": "Target IANA timezone ID or unambiguous city name (e.g., \"America/New_York\" or \"New York\").",
"type": "string"
}
},
"required": [
"datetime",
"from_tz",
"to_tz"
],
"type": "object"
},
"name": "ref_timezone_convert",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"source",
"target",
"utc_equivalent"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_timezone`: Source or target timezone ID is unrecognized. `invalid_datetime`: Datetime has out-of-range calendar components (e.g. month 13, February 30) or falls in a daylight-saving spring-forward gap that never occurs in the source timezone. (Malformed format is rejected by the input schema.). Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_timezone",
"invalid_datetime"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"source": {
"additionalProperties": false,
"description": "Source datetime details.",
"properties": {
"datetime": {
"description": "Input local datetime echoed back (e.g., \"2026-05-24T15:30:00\").",
"type": "string"
},
"offset": {
"description": "UTC offset at the source datetime (e.g., \"+09:00\").",
"type": "string"
},
"tz": {
"description": "Resolved source IANA timezone ID.",
"type": "string"
}
},
"required": [
"datetime",
"tz",
"offset"
],
"type": "object"
},
"target": {
"additionalProperties": false,
"description": "Target datetime details.",
"properties": {
"datetime": {
"description": "Equivalent local datetime in the target timezone.",
"type": "string"
},
"offset": {
"description": "UTC offset in the target timezone at the converted moment.",
"type": "string"
},
"tz": {
"description": "Resolved target IANA timezone ID.",
"type": "string"
}
},
"required": [
"datetime",
"tz",
"offset"
],
"type": "object"
},
"utc_equivalent": {
"description": "The UTC equivalent of the input datetime (ISO 8601 with Z suffix).",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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\".",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"at": {
"description": "ISO 8601 datetime to evaluate timezone state at a specific moment (e.g., \"2026-01-15T12:00:00\"). Defaults to current time.",
"type": "string"
},
"by": {
"default": "auto",
"description": "Lookup mode: iana for exact IANA ID, country for ISO alpha-2 code, auto tries all strategies.",
"enum": [
"iana",
"country",
"auto"
],
"type": "string"
},
"query": {
"description": "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\").",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ref_timezone_lookup",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"timezones",
"evaluated_at"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `no_match`: No timezone matched the query. `invalid_at`: The at parameter is not a valid ISO 8601 datetime string. Other values are possible when a failure originates below the handler.",
"examples": [
"no_match",
"invalid_at"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"evaluated_at": {
"description": "ISO 8601 UTC datetime at which timezone state was evaluated.",
"type": "string"
},
"timezones": {
"description": "Matching timezone records. Multiple records when querying by country.",
"items": {
"additionalProperties": false,
"description": "Timezone record with offset and DST info.",
"properties": {
"countries": {
"description": "ISO alpha-2 country codes observing this timezone.",
"items": {
"type": "string"
},
"type": "array"
},
"current_offset_hours": {
"description": "Current UTC offset in hours (e.g., -5.0 for UTC-05:00).",
"type": "number"
},
"dst_abbreviation": {
"description": "DST timezone abbreviation (e.g., \"EDT\"), or null when DST not active or timezone has no DST.",
"type": [
"string",
"null"
]
},
"dst_active": {
"description": "Whether daylight saving time is currently active.",
"type": "boolean"
},
"iana_id": {
"description": "IANA timezone identifier (e.g., \"America/New_York\").",
"type": "string"
},
"major_cities": {
"description": "Major cities in this timezone.",
"items": {
"type": "string"
},
"type": "array"
},
"standard_abbreviation": {
"description": "Standard timezone abbreviation (e.g., \"EST\").",
"type": [
"string",
"null"
]
},
"standard_offset_hours": {
"description": "Standard (non-DST) UTC offset in hours.",
"type": "number"
}
},
"required": [
"iana_id",
"current_offset_hours",
"standard_offset_hours",
"dst_active",
"dst_abbreviation",
"standard_abbreviation",
"major_cities",
"countries"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"from": {
"description": "Source unit abbreviation (e.g., \"km\", \"C\", \"m/h\", \"kWh\", \"kg\").",
"type": "string"
},
"to": {
"description": "Target unit abbreviation (e.g., \"mi\", \"F\", \"m/s\", \"kJ\", \"lb\").",
"type": "string"
},
"value": {
"description": "Numeric quantity to convert.",
"type": "number"
}
},
"required": [
"value",
"from",
"to"
],
"type": "object"
},
"name": "ref_unit_convert",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"value",
"from_unit",
"to_unit",
"result",
"result_precision",
"measure"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `incompatible_units`: The source and target units measure different physical quantities. `unknown_unit`: One or both units are not recognized by the underlying library. `below_absolute_zero`: The input temperature is below absolute zero (0 K = -273.15 °C = -459.67 °F). Other values are possible when a failure originates below the handler.",
"examples": [
"incompatible_units",
"unknown_unit",
"below_absolute_zero"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"from_unit": {
"description": "Source unit as recognized.",
"type": "string"
},
"measure": {
"description": "Physical quantity being measured (e.g., \"length\", \"mass\", \"temperature\").",
"type": "string"
},
"result": {
"description": "Converted value (full precision float).",
"type": "number"
},
"result_precision": {
"description": "Human-readable rounded form of the result.",
"type": "string"
},
"to_unit": {
"description": "Target unit as recognized.",
"type": "string"
},
"value": {
"description": "Input value as provided.",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:8832b87eb7feaedc8a9044eff149a423032afdedc34068d27cf3dcae9af2e75f | sha256sum