# Afriref Reference Data MCP server

Source: https://glimind.com/server/mcp-registry%2Fdev.afriref%2Freference-data
Registry id: `mcp-registry/dev.afriref/reference-data`
Status: live (checked 2026-10-27T03:34:48.111Z)

## Verdict

Afriref Reference Data MCP server answered 98.83% of Glimind's liveness checks over 30 days, better than 7% of MCP servers, with 1798 ms median handshake and 103 outages in 90 days. Its agent-readiness grade is A (92/100) across 34 tools, costing an agent about 12,260 tokens to load. Checked every few minutes; no tool is ever called.

## Measurements (30 days)

| Metric | Value | Better than |
|---|---|---|
| Uptime, 30 days | 98.83% | 7% of MCP servers |
| Median handshake latency | 1798 ms | 7% of MCP servers |
| p95 handshake latency | 4658 ms | — |
| Checks in 30 days | 4,715 | — |
| Outages, 90 days | 103 | — |
| Median recovery | 7 min | — |
| Agent-readiness score | 92/100 (A) | 73% of MCP servers |
| Tools | 34 | — |
| Tool-list size for an agent | ~12,260 tokens | 15% of MCP servers |
| Days observed | 29 | — |

## Install

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

Claude Code:

```sh
claude mcp add --transport http afriref-reference-data-mcp-server https://afriref.dev/mcp
```

## Tools (34)

- `add_business_days`: FREE, unmetered. The date n business days after (or, for negative n, before) a start date. The start date is day 0 and never counted; n = 0 returns the date its
- `business_days_between`: FREE, unmetered. Business days between two dates. business_days counts (from, to] and is negative when to is before from, so add_business_days(from, business_da
- `charge_sale`: PAID ($0.50). Charge this sale: should this invoice carry VAT, which country's and how much - place of supply under the EU, UK and South Africa rules, net/VAT/g
- `charge_sale_certified`: PAID ($0.75). The charge_sale dossier plus an Ed25519-signed certified extract of the governing VAT rate, for a filing. Refused free when the governing source c
- `check_minimum_wage`: PAID ($0.02). Compliance verdict: is a salary at, above or below the country's statutory minimum wage? Returns verdict, margin, the statutory floor and the lega
- `compare_series`: PAID ($0.02). One series (e.g. vat, policy-rate, minimum-wage, corporate-tax) across up to 10 countries of this brand in one call; each row carries its own sour
- `compute_income_tax`: PAID ($0.02). Statutory income tax on a TAXABLE-income figure using the country's verified marginal bracket schedule, with full per-bracket workings, effective 
- `compute_payroll`: PAID ($0.05). Gross-to-net take-home pay for Nigeria or Kenya: applies PAYE (on the verified brackets) plus the statutory employee deductions (Nigeria: pension/
- `compute_statutory_interest`: PAID ($0.02). Simple statutory interest on a principal at the cited statutory-interest series rate: Actual/365 simple, principal × (rate/100) × (days/365). Pass
- `compute_vat`: PAID ($0.01). VAT breakdown for an amount: net, tax and gross using the country's current statutory rate, including per-levy components where the rate is compos
- `cost_hire`: PAID ($0.50). Cost this hire: one cited dossier for a salary - wage-floor verdict, employer and employee contributions (or PAYE net pay for NG/KE), employer cos
- `count_working_days`: PAID ($0.002). 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 na
- `domain_age`: PAID ($0.005). Not for registries without RDAP, e.g. .za/.co.za, .me, .de, .io, .eu: refused free (422). Use when you need to know which registrar holds a domai
- `domain_check`: PAID ($0.01). Use when mail lands in spam, before an email campaign, for vendor due diligence or to confirm a Microsoft 365 tenant: graded SPF, DKIM, DMARC, MX,
- `evidence_pack`: PAID ($0.25). Country evidence pack: the full cited country brief plus up to 3 Ed25519-signed certified extracts (default the first certifiable of vat, policy-r
- `get_calendar`: FREE, unmetered. GET /v1/calendar for this brand's continent. Optional country (ISO 3166-1 alpha-2) and series. Derives reverify_by from last_confirmed + update
- `get_changes`: FREE unmetered change + freshness feed. After any paid series or answer call, call this before you assume the cached value is still the law. Returns every serie
- `get_country_brief`: PAID ($0.01). Country brief: every reference series we hold for one country (policy rate, VAT/GST, CPI, taxes, minimum wage, holidays...) in one call, each with
- `get_filing_deadlines`: PAID ($0.003, same as any series). Recurring statutory tax deadlines for a country — VAT/GST returns and payments, PAYE/payroll withholding remittances, corpora
- `get_key_balance`: FREE. Remaining allowance for an API key (free, card or metered): plan, quota, used, remaining, reset date and what the key covers. Never metered. Pass api_key,
- `get_public_holidays`: FREE. Official public-holiday calendar for a supported country, including gazetted movable holidays, with the official government source cited. Some countries a
- `get_public_holidays_worldwide`: FREE with any API key, including the free key by email (https://afriref.dev/free-key). Same as get_public_holidays, but for every country across all seven brand
- `get_series`: PAID ($0.003). Current value of a reference series — e.g. series=policy-rate, vat, minimum-wage. Every value carries its official source citation, effective dat
- `get_series_history`: PAID ($0.003). 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 (in
- `get_snapshot`: PAID ($0.02). Snapshot of every series for every country in one call. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response e
- `hire_compare`: PAID ($0.75 for 2 countries, $1.00 for 3-5). Employer cost, employer and employee contributions, on-cost percent and wage-floor verdict side by side and ranked,
- `invoice_payable`: PAID ($0.40). Is this invoice overdue, by how many days, and how much statutory late-payment interest is owed (Actual/365 simple, rate and workings cited). Late
- `is_business_day`: FREE, unmetered. Is this date a business day in this country? Returns is_business_day, the reason (weekend, public_holiday, makeup_workday…), the holiday names,
- `list_series`: FREE. Catalog of all afriref reference-data series: supported countries, series ids, descriptions, freshness metadata and per-series URLs. Call this first to di
- `next_filings`: PAID ($0.35). Upcoming VAT, PAYE and corporate-tax due dates in a window (default the next 90 days), rolled for weekends and national public holidays, each rule
- `register_alert`: Bind a webhook so the next gazette does not silently stale a value you already paid for. REGISTERING IS FREE. Register: $0 · Delivery after trial: $0.05. First 
- `settlement_date`: PAID ($0.02). 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 s
- `validate_tax_id`: PAID ($0.003). Offline format and check-digit validation of a business tax ID or VAT number for one country of this brand: valid/invalid, normalised form, id ty
- `verify_answer_receipt`: FREE. Verify an answer receipt (kind answer_receipt) with the Ed25519 public key only. Pass the receipt object or its canonical JSON, signature_value when the s

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.