MuseDirectory
All connectors / Finance & Bills
Finance & Bills

usaref reference-data

North American government reference data: tax rates, VAT, minimum wage, holidays, FX and settlement cycles.

Connects to official government data for USA, Canada and 8 other North American countries. Muse can look up current tax brackets, VAT rates, minimum wages, public holidays, working-day counts, employment costs and settlement dates for financial and payroll compliance.

Try asking Muse: "Check if a salary offer meets the minimum wage requirement in Quebec."

Working now?
Working
Worked last 7 days
93.4% of checks
How to get it
Extra setup
Account
No account needed
Price
Not stated

Source: Found in the official MCP Registry (dev.usaref/reference-data) · First listed September 24, 2026

Last 24 hours

Each bar is one check, every 15 minutes. Green means it answered. Last checked 50 min ago.

Is it safe to connect?

What Muse can see: It does not ask you to sign in, so it cannot see your accounts. It only sees what Muse sends it from your request.

Before it acts: Read what Muse plans to do before you approve it, and remove the app from Muse when you stop using it.

musedirectory.ai is not part of Meta. More about how Muse handles your information

How to add it to Muse

Not in Muse's Connectors list yet, but Muse can still use it. Copy the request below and paste it into Muse. Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

Open Muse
https://usaref.dev/mcp

Not in Muse's Connectors list yet. Muse can still use it: its page gives you a request to paste into Muse.

Technical details: safety screening, tools, response time and recent checks

Response time at the last check: 955ms. Worked in 93.4% of checks over 30 days.

Screening · September 24, 2026

Screened, no issues found

MCP handshake
Pass
Answered in 822ms
Domain against threat feeds (Cloudflare security DNS)
Pass
usaref.dev not flagged
Published packages against the OSV malicious-package database
n/a
No npm or PyPI package published
Hidden instructions or invisible characters in tool text
Pass
11 tools read, nothing found
Inputs asking for passwords, card numbers or seed phrases
Pass
None found
Domain and redirects
Pass
No redirects off the domain
AI review of purpose and tool behavior
Pass
No concerns

Screening looks for known threats and hidden instructions at the time of the check, and runs again weekly and whenever the tool list changes. It cannot see the server's code, so only connect what you need and review what Muse asks to do. How screening works.

Tools · 16

list_seriesFREE. Catalog of all usaref reference-data series: supported countries, series ids, descriptions, freshness metadata and per-series URLs. Call this first to discover what data exists. Paid answer tools accept receipt=true (included in the answer price, no extra USDC) and, on a pa
get_public_holidaysFREE. 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 `subdivisio
get_seriesPAID ($0.005). 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
get_series_historyPAID ($0.005). 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. After a 200, bind get_changes (free poll) or register_alert (HMAC pus
check_minimum_wagePAID ($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 perio
compute_vatPAID ($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.
count_working_daysPAID ($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 exp
settlement_datePAID ($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 +
compute_income_taxPAID ($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
compute_statutory_interestPAID ($0.05). Simple statutory interest on a principal at the cited statutory-interest series rate: Actual/365 simple, principal × (rate/100) × (days/365). Pass days, or from and to as YYYY-MM-DD (from inclusive, to exclusive). If both are sent and disagree, the call is refused f
compute_employment_costPAID ($0.10). Cost to employ: prices every statutory contribution on both the employee and employer sides for a gross salary, returning line-by-line amounts with instrument citations and an explicit refused list for schemes that could not be priced (unknown, not zero). Does NOT c
verify_answer_receiptFREE. 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 signature is not inside the receipt, and public_key_pem to verify offline. If public_key_pem is omitted, the tool may GET
get_snapshotPAID ($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. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.10) on this ser
get_changesFREE 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 series whose current value took effect on or after `since` (default last 30 days), newest first, each with last_confirmed and
get_calendarFREE, 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_cycle_days (the same window that sets stale) and, only when current.effective_to is a non-empty string, next_effective_
register_alertBind 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.10. First 3 deliveries are free; later deliveries are $0.10 and refunded if the webhook fails to send. HMAC-SHA256 signed. Two wat

Recent checks

2026-09-28 08:31:22live · HTTP 200955ms
2026-09-28 06:15:54live · HTTP 2001298ms
2026-09-28 03:46:16live · HTTP 200756ms
2026-09-28 01:31:02live · HTTP 2001365ms
2026-09-27 23:15:51live · HTTP 200999ms
2026-09-27 20:46:25live · HTTP 2002661ms
2026-09-27 18:31:17live · HTTP 2001815ms
2026-09-27 16:16:01live · HTTP 2003417ms
2026-09-27 14:15:53live · HTTP 2002381ms
2026-09-27 11:46:30degraded · HTTP 2006081ms
2026-09-27 09:31:29live · HTTP 2001769ms
2026-09-27 07:01:59live · HTTP 2002902ms

Link

https://usaref.dev/mcp

Questions about usaref reference-data in Muse

How do I connect usaref reference-data to Muse?

Not in Muse's Connectors list yet, but Muse can still use it. Paste this into Muse: "Use usaref reference-data to help me. It is a free service with an MCP server at https://usaref.dev/mcp. It does not need an API key. Ask me before you share anything with it." Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

Is usaref reference-data working right now?

At the last check (September 28, 2026, 08:31 UTC) the endpoint was working, answering in 955ms. Over the last 7 days it answered 93.4% of health checks. It is checked every 15 minutes.

Is usaref reference-data safe to connect to Muse?

It was screened on September 24, 2026 with the result "screened, no issues found". Screening checks the domain against threat feeds and reads the tools for hidden instructions and requests for passwords or card numbers. It cannot see the server's code, so grant only the access you need.

What can usaref reference-data do in Muse?

It exposes 16 tools, including list_series, get_public_holidays, get_series, get_series_history. For example, you could ask Muse: "Check if a salary offer meets the minimum wage requirement in Quebec."

Follow usaref reference-data

Tell me if usaref reference-data goes down, comes back, or changes its tools
One email per change. You confirm first, and every email has a link to stop.
Made this app? Claim it or get a status badge

Is this yours?

This listing was added from public sources (Found in the official MCP Registry (dev.usaref/reference-data)). If you build usaref reference-data, claim it to correct the details and get your badge.

Claim this listing

usaref reference-data status badge

Paste this on your site or README. It always shows the latest check.

<a href="https://musedirectory.ai/connector/usaref-reference-data"><img src="https://musedirectory.ai/badge/usaref-reference-data.svg" alt="usaref reference-data on musedirectory.ai" width="236" height="40"></a>

More for app makers