# dev.latamref/reference-data (remote · latamref.dev)

LatAm govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 22 countries; Brazil free.

- Trust score: 69/100 (medium)
- Change this week: +7
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `latamref.dev`: 69/100 (this document), [markdown](https://verifymcp.io/servers/dev-latamref-reference-data/latamref.md), [page](https://verifymcp.io/servers/dev-latamref-reference-data/latamref)

## Channel facts

- Endpoint: `https://latamref.dev/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.5.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 10 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 74/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1601 tokens (~160/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http dev-latamref-reference-data https://latamref.dev/mcp
```

### Codex

```toml
[mcp_servers.dev-latamref-reference-data]
url = "https://latamref.dev/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dev-latamref-reference-data": {
      "type": "remote",
      "url": "https://latamref.dev/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dev-latamref-reference-data --url https://latamref.dev/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  dev-latamref-reference-data:
    url: "https://latamref.dev/mcp"
```

### Other

```json
{
  "mcpServers": {
    "dev-latamref-reference-data": {
      "type": "http",
      "url": "https://latamref.dev/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 68, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 67, +4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 63, 0)

- [security] Tool “get_public_holidays” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 143 → 160
- [cosmetic] “get_public_holidays” added an optional parameter “subdivision”
- [cosmetic] “count_working_days” added an optional parameter “subdivision”

### 2026-07-28 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 62, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 62)

First indexed and scored.

## MCP tools (10)

### `list_series` (~44 tokens)

FREE. Catalog of all latamref reference-data series: supported countries, series ids, descriptions, freshness metadata and per-series URLs. Call this first to discover what data exists.

### `get_public_holidays` (~151 tokens)

FREE. Official public-holiday calendar for a supported country, including gazetted movable holidays, with the official government source cited. Some countries also carry sub-national calendars (e.g. the German Laender): the `subdivisions` field lists them, and passing `subdivision` (ISO 3166-2, e.g. 'DE-BY') returns the national calendar merged with that region's statutory days.

Input parameters:

- `country` (string, required): ISO country code
- `subdivision` (string): Optional ISO 3166-2 region code (e.g. 'DE-BY'). Returns national + that region's statutory holidays, each tagged national/regional. Omit for the national calendar.

### `get_series` (~129 tokens)

PAID ($0.001). Current value of a reference series — e.g. series=policy-rate, vat, minimum-wage. Every value carries its official source citation, effective date, last-confirmed date and staleness flag. Pass api_key if you have one; otherwise the response explains how to pay via x402.

Input parameters:

- `api_key` (string): API key (bypasses x402; metered for invoicing)
- `country` (string, required): ISO country code
- `series` (string, required): Series id, e.g. policy-rate, vat, minimum-wage

### `get_series_history` (~114 tokens)

PAID ($0.001). Historical values of a reference series with effective date ranges, optionally filtered by from/to (YYYY-MM-DD). Pass api_key if you have one; otherwise the response explains how to pay via x402.

Input parameters:

- `api_key` (string): API key
- `country` (string, required): ISO country code
- `from` (string): Earliest effective date, YYYY-MM-DD
- `series` (string, required): Series id
- `to` (string): Latest effective date, YYYY-MM-DD

### `check_minimum_wage` (~162 tokens)

PAID ($0.05). Compliance verdict: is a salary at, above or below the country's statutory minimum wage? Returns verdict, margin, the statutory floor and the legal instrument it rests on. Honest statuses when no enforceable floor exists or the period doesn't match the floor's period (cross-period conversion is never guessed). Pass api_key if you have one; otherwise the response explains how to pay via x402.

Input parameters:

- `amount` (number, required): Wage to check, in the country's own currency
- `api_key` (string): API key (bypasses x402; metered for invoicing)
- `country` (string, required): ISO country code
- `period` (string, required): Period the amount covers — must match the statutory floor's period

### `compute_vat` (~150 tokens)

PAID ($0.02). VAT breakdown for an amount: net, tax and gross using the country's current statutory rate, including per-levy components where the rate is composite (e.g. Ghana VAT + NHIL + GETFund). mode=add treats the amount as net; mode=extract backs VAT out of a gross amount. Pass api_key if you have one; otherwise the response explains how to pay via x402.

Input parameters:

- `amount` (number, required): Amount in the country's own currency
- `api_key` (string): API key
- `country` (string, required): ISO country code
- `mode` (string): add = amount is net (default); extract = amount is gross

### `count_working_days` (~194 tokens)

PAID ($0.02). Working days in a date range for a country: weekends (Egypt's Fri–Sat handled) and statutory public holidays applied, with the holidays hit by name and the next working day after the range. Range max 366 days. Pass api_key if you have one; otherwise the response explains how to pay via x402.

Input parameters:

- `api_key` (string): API key
- `country` (string, required): ISO country code
- `from` (string, required): Range start, YYYY-MM-DD, inclusive
- `subdivision` (string): Optional ISO 3166-2 region code (e.g. 'DE-BY') to apply that region's statutory holidays on top of the national calendar. Regions are listed under `subdivisions` by get_public_holidays. Unknown code…
- `to` (string, required): Range end, YYYY-MM-DD, inclusive

### `settlement_date` (~392 tokens)

PAID ($0.05). Settlement/value date: the date n business days after a trade date, computed on the INTERSECTION of the calendars you name, with a per-day trail showing every skipped day and why, on which calendar. Supply business_days for a cycle you are trading under, or market + instrument_class to have a settlement cycle applied that we cite to its primary source (e.g. US equities T+1 under 17 CFR 240.15c6-1(a); UK gilts T+1 by DMO convention, which is NOT the T+2 equity cycle; Japan equities T+2 but JGBs T+1). Calendars are NATIONAL statutory holiday calendars with researched statutory weekend rules (Israel Saturday-only, Gulf Friday+Saturday, India Sundays plus the 2nd and 4th Saturday), NOT CSD or exchange calendars — each response states the basis and any known divergence. Use 'eu.t2' for the euro cash leg. We refuse FREE rather than guess: beyond published calendar coverage, no cited cycle for the instrument (government bonds never inherit an equity cycle), a cycle not in force on the trade date, or FX spot value dates. Free companion: GET /settlement-conventions.

Input parameters:

- `api_key` (string): API key (bypasses x402; metered for invoicing)
- `business_days` (integer): The offset you are trading under (T+n)
- `calendars` (array, required): Calendar ids to intersect: two-letter ISO country codes, plus 'eu.t2' for the euro cash leg
- `instrument_class` (string): Instrument class — a government bond never inherits an equity cycle
- `market` (string): ISO country of the market whose cited cycle should apply (with instrument_class)
- `trade_date` (string, required): Trade/reference date, YYYY-MM-DD. Day 0: never counted, never rolled.

### `compute_income_tax` (~210 tokens)

PAID ($0.05). Statutory income tax on a TAXABLE-income figure using the country's verified marginal bracket schedule, with full per-bracket workings, effective rate and marginal rate. Handles inflation-indexed tax units (Colombia UVT, Chile UTA, Peru UIT, Uruguay BPC) — you pass local currency. IMPORTANT: this is tax on taxable income, NOT net take-home pay — reliefs/allowances and social-security contributions are the caller's concern and are not applied (see the response scope_note). Pass api_key if you have one; otherwise the response explains how to pay via x402.

Input parameters:

- `api_key` (string): API key (bypasses x402; metered for invoicing)
- `country` (string, required): ISO country code
- `taxable_income` (number, required): Taxable income in the country's local currency, in the schedule's own period basis (annual for most; monthly for Côte d'Ivoire, Uganda, Ethiopia, Costa Rica)

### `get_snapshot` (~55 tokens)

PAID ($0.02). Snapshot of every series for every country in one call. Pass api_key if you have one; otherwise the response explains how to pay via x402.

Input parameters:

- `api_key` (string): API key

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/dev-latamref-reference-data/latamref#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 68
- 2026-08-01: 68
- 2026-07-31: 68
- 2026-07-30: 67
- 2026-07-29: 63
- 2026-07-28: 63
- 2026-07-27: 62
- 2026-07-26: 62

## Links

- Remote endpoint: https://latamref.dev/mcp
- Website: https://latamref.dev/
- Changelog RSS feed: https://verifymcp.io/servers/dev-latamref-reference-data/latamref/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/dev-latamref-reference-data/latamref/changelog.json
- HTML version of this page: https://verifymcp.io/servers/dev-latamref-reference-data/latamref