ebarimt-ref

Local reference lookup for Mongolian eBarimt: districts (khoroo codes), VAT-free/zero/no-VAT tax product codes, and GS1 БҮНА classification codes. Ships as an MCP server so Claude can answer "find me the district / classification / VAT-free product code" without a web UI or a database server — everything lives in a single committed SQLite file.

Setup

pnpm install
pnpm refresh   # fetches districts + tax codes from api.ebarimt.mn, parses data/gs1_gs1.xlsx
pnpm test      # sanity checks: row counts + known lookups

pnpm refresh only works from a Mongolian IP (the eBarimt API is geo-restricted). The .db file is committed to this repo by design, so consumers of this repo never need to run refresh themselves — only re-run it when the source data changes.

Related MCP server: medical-codes-mcp-server

CLI

pnpm search classification "улаан буудай"
pnpm search tax "хөгжлийн бэрхшээл"
pnpm search district "Сонгинохайрхан"
pnpm search code 3420

MCP registration (Claude Code)

.mcp.json:

{
  "mcpServers": {
    "ebarimt-ref": {
      "command": "pnpm",
      "args": ["--dir", "/Users/tsolmonkhorloo/Documents/dreamon/ebarimt-ref", "mcp"]
    }
  }
}

Or one-liner:

claude mcp add ebarimt-ref -- pnpm --dir /Users/tsolmonkhorloo/Documents/dreamon/ebarimt-ref mcp

Tools exposed: search_classification, search_tax_product, find_district, lookup_code, ref_status, api_doc.

API reference docs

docs/api/ holds the eBarimt developer docs (PosAPI 3, easy-register, operator) scraped from developer.itc.gov.mn. Exposed via the api_doc MCP tool: call with no args to list, with slug (e.g. pos-api/12-receipt-save) to read.