# reference-data-mcp-server

An MCP server for country, timezone, unit, MIME, and HTTP status lookups when an agent needs reference data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1931 installs · ★ 1 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/reference-data-mcp-server
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/reference-data-mcp-server

## What it does

This server gives an agent queryable reference data for countries, timezones, periodic-table elements, physical constants, measurement units, HTTP status codes, and MIME types. It can filter countries by region, language, or currency, resolve timezone names, and translate a local time from one zone to another.

The package exposes 10 tools plus MCP resources for countries, elements, and timezones. It runs without API keys or request limits. `ref_timezone_convert` expects a local ISO 8601 datetime with no offset; a datetime inside a spring-forward gap is rejected. The setup below connects to the hosted HTTP endpoint.

## Requirements
- Remote server: `https://reference-data-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http reference-data-mcp-server https://reference-data-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add reference-data-mcp-server --url https://reference-data-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reference-data-mcp-server": {
            "url": "https://reference-data-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reference-data-mcp-server": {
            "type": "http",
            "url": "https://reference-data-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http reference-data-mcp-server https://reference-data-mcp-server--cyanheads.run.tools
```

## When to use it
- look up a country from its ISO code or name
- filter countries by language or currency
- convert a local datetime between IANA zones
- convert a value between compatible units
- resolve a MIME type or HTTP status code

## Example prompts
- Use `ref_geo_lookup` to find country details for `BR`, including its capital, currency, and timezone IDs.
- Convert `2026-05-24T15:30:00` from `Europe/Berlin` to `America/New_York` with `ref_timezone_convert`.
- Find the MIME type for `.webp` and explain HTTP status `404`.

## Similar
- [reference-data](https://affpapa.org/en/nevibecode/skills/reference-data.md) — skill · 715 installs
- [traveltype](https://affpapa.org/en/nevibecode/mcp/traveltype.md) — MCP server · 1770 installs
- [cwicr-takeoff-helper](https://affpapa.org/en/nevibecode/skills/cwicr-takeoff-helper.md) — skill · 149 installs
- [pint-compute](https://affpapa.org/en/nevibecode/skills/pint-compute.md) — skill · 486 installs
- [drawing-converter](https://affpapa.org/en/nevibecode/mcp/drawing-converter.md) — MCP server
- [iii-sdk-reference](https://affpapa.org/en/nevibecode/skills/iii-sdk-reference.md) — skill · 4900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
