Alpaca Trading API integration for Model Context Protocol (MCP)
Nothing to run from here
Reference Data is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
22
tools declared
—
trust score
remote
at its publisher
—
calls last 7d
What it does
N American govt data, cited to source: rates, VAT, tax, wages, holidays, FX. 10 countries; USA free.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http usaref-reference-data-mcp https://usaref.dev/mcp
# 2 — ask your agent for something these tools do
# list_series, get_public_holidays, get_public_holidays_worldwide and 19 more
Reference Data costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
USAll 1 server
usaref1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http usaref-reference-data-mcp https://usaref.dev/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
22 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
FREE. 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 paid success, return an Ed25519 answer receipt (kind answer_receipt). That receipt is not a series certified extract and i
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | no | Optional ISO country code. Returns full per-series metadata (source, freshness, bands) for that country only. |
| detail | boolean | no | Default false. Without country, false returns a compact index (country -> series ids). true returns the full catalog, which is large. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| subdivision | string | no | 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. |
FREE with any API key, including the free key by email (https://usaref.dev/free-key). Same as get_public_holidays, but for every country across all seven brands, not only North American. Unmetered: never counts against the key's allowance. Pass api_key, or send the key as the X-API-Key header on /mcp.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code, any covered country |
| subdivision | string | no | 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. |
| api_key | string | no | Any valid API key. Optional when the key is sent as the X-API-Key header on /mcp. |
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, or send the key as the X-API-Key header on /mcp.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| api_key | string | no | API key. Optional when sent as the X-API-Key header on /mcp. |
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, and the next and previous business day. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Friday+Saturday, Israel Saturday-only, India 2nd/4th Saturdays, Nepal's 2026 change, China's multi-day breaks
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO 3166-1 alpha-2 country code, e.g. 'za', 'ae', 'in'. Every country we hold a holiday calendar for is accepted on every brand, not only this brand's region. |
| date | string | yes | Date to classify, YYYY-MM-DD |
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 itself if it is a business day, otherwise the next one. Lists every non-business day skipped and why. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Friday+Saturday, Israel Saturday-only, India 2nd/4th
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO 3166-1 alpha-2 country code, e.g. 'za', 'ae', 'in'. Every country we hold a holiday calendar for is accepted on every brand, not only this brand's region. |
| date | string | yes | Start date (day 0), YYYY-MM-DD |
| n | integer | yes | Business days to add; negative walks backward |
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_days) lands on to whenever to is a business day; business_days_inclusive counts both ends. Also returns weekend days and the public holidays in range. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Fr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO 3166-1 alpha-2 country code, e.g. 'za', 'ae', 'in'. Every country we hold a holiday calendar for is accepted on every brand, not only this brand's region. |
| from | string | yes | Range start, YYYY-MM-DD |
| to | string | yes | Range end, YYYY-MM-DD |
PAID ($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 (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every US series is free to try. After a 200, bind get_changes (free poll) or r
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| series | string | yes | Series id, e.g. policy-rate, vat, minimum-wage |
| api_key | string | no | API key (bypasses x402; metered for invoicing) |
PAID ($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 (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every US series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.10) on th
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| series | string | yes | Series id |
| from | string | no | Earliest effective date, YYYY-MM-DD |
| to | string | no | Latest effective date, YYYY-MM-DD |
| api_key | string | no | API key |
PAID ($0.005, same as any series). Recurring statutory tax deadlines for a country — VAT/GST returns and payments, PAYE/payroll withholding remittances, corporate income tax returns and provisional/instalment payments — as RULES, each cited to the official source with the verbatim phrase that states it, plus the actual DUE DATES in a window, rolled for the country's weekend and national public hol
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| from | string | no | Window start, YYYY-MM-DD. Default today |
| to | string | no | Window end, YYYY-MM-DD. Default from + 365 days; at most 400 days after from |
| tax | string | no | Only this tax's rules and dates |
| year_end | string | no | Company accounting year end, MM-DD (e.g. 06-30). Applies to rules marked year_end_variable |
| api_key | string | no | API key (bypasses x402; metered for invoicing) |
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 (instant card checkout at /pricing); otherwis
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| amount | number | yes | Wage to check, in the country's own currency |
| period | string | yes | Period the amount covers — must match the statutory floor's period |
| receipt | boolean | no | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET |
| api_key | string | no | API key (bypasses x402; metered for invoicing) |
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 (instant card checkout at /pricing); otherwise the response explains how to pay via x402. T
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| amount | number | yes | Amount in the country's own currency |
| mode | string | no | add = amount is net (default); extract = amount is gross |
| receipt | boolean | no | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET |
| api_key | string | no | API key |
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 (instant card checkout at /pricing); otherwise the response explains how to pay via x402. The evaluation country is free to try (see list_series).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| from | string | yes | Range start, YYYY-MM-DD, inclusive |
| to | string | yes | Range end, YYYY-MM-DD, inclusive |
| subdivision | string | no | 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 i |
| receipt | boolean | no | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET |
| api_key | string | no | API key |
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 C
| Parameter | Type | Required | Notes |
|---|---|---|---|
| trade_date | string | yes | Trade/reference date, YYYY-MM-DD. Day 0: never counted, never rolled. |
| calendars | array | yes | Calendar ids to intersect: two-letter ISO country codes, plus 'eu.t2' for the euro cash leg |
| business_days | integer | no | The offset you are trading under (T+n) |
| market | string | no | ISO country of the market whose cited cycle should apply (with instrument_class) |
| instrument_class | string | no | Instrument class — a government bond never inherits an equity cycle |
| receipt | boolean | no | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET |
| api_key | string | no | API key (bypasses x402; metered for invoicing) |
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. You pass the amount in 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 resp
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| taxable_income | number | yes | 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) |
| receipt | boolean | no | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET |
| api_key | string | no | API key (bypasses x402; metered for invoicing) |
PAID ($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 free. A series with no numeric rate after materialization (mechanism-only) is refused free — a non-answer is not sold. No
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code |
| principal | number | yes | Principal in the country's own currency. Must be a finite number greater than 0. |
| days | number | no | Day-count days. Omit when from and to are set. If both are sent and disagree, the answer is refused free (HTTP 400). |
| from | string | no | Period start, YYYY-MM-DD, inclusive. Pair with to. Day count is calendar days from inclusive to to exclusive (UTC dates). |
| to | string | no | Period end, YYYY-MM-DD, exclusive. |
| receipt | boolean | no | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET |
| api_key | string | no | API key (bypasses x402; metered for invoicing) |
PAID ($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 compute income tax — use compute_payroll for gross-to-net take-home where supported. Pass api_key if you have one (instan
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | yes | ISO country code with a costed contribution schedule |
| gross | number | yes | Gross pay in local currency |
| period | string | no | Period the gross covers (default month) |
| subdivision | string | no | Optional ISO 3166-2 regional schedule (e.g. CA-QC, DE-SN) |
| nationality | string | no | Gulf nationality for pension reach |
| contract | string | no | Contract type where rates differ |
| workplace_pension | boolean | no | Auto-enrolment / PPK participation (default true) |
| childless_over_23 | boolean | no | Germany care surcharge |
| children_under_25 | number | no | Germany per-child care reduction |
| zusatzbeitrag_rate | number | no | Germany sickness-fund supplement |
| receipt | boolean | no | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET |
| api_key | string | no | API key (bypasses x402; metered for invoicing) |
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 signature is not inside the receipt, and public_key_pem to verify offline. If public_key_pem is omitted, the tool may GET signature.public_key (/certified/public-key) and read public_key_pem. Never send a private key. A valid signature shows
| Parameter | Type | Required | Notes |
|---|---|---|---|
| receipt | yes | Answer receipt object (signature may be nested) or the canonical JSON of that object. A canonical JSON string of the signed body (signature omitted) is accepted when signature_value is also passed. | |
| signature_value | string | no | Base64 Ed25519 signature. Required when the receipt object or JSON string does not already include signature.value. Overrides a nested signature when both are sent. |
| public_key_pem | string | no | SPKI public key PEM from GET /certified/public-key (field public_key_pem). Required for offline verify. A private key PEM is refused. |
| public_key_url | string | no | Optional GET /certified/public-key URL used only when public_key_pem is omitted. Ignored when the PEM is present. |
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 explains how to pay via x402. Every US series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.10) on this series so a later gazette does not silently retire the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| api_key | string | no | API key |
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 series whose current value took effect on or after since (default last 30 days), newest first, each with last_confirmed and stale, PLUS a dataset-wide freshness summary: how many of the served series were re-verified within 1/7/30/90 days, how
| Parameter | Type | Required | Notes |
|---|---|---|---|
| since | string | no | YYYY-MM-DD. Omit for the server default (last 30 days). Free, unmetered. |
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_cycle_days (the same window that sets stale) and, only when current.effective_to is a non-empty string, next_effective_known with basis effective_to. status unknown omits that date. Never parses notes. Does not invent MPC, budget, or wage-
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | no | Optional ISO 3166-1 alpha-2. Omit for every series on this brand's continent. Unknown to the catalog is 404 free. Not two letters is 400 free. |
| series | string | no | Optional series id (for example policy-rate). Omit for every series. A valid country with no match stays free. |
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.10. First 3 deliveries are free; later deliveries are $0.10 and refunded if the webhook fails to send. HMAC-SHA256 signed. Two watch types on the same call: • series: ["za/vat-registration-threshold", "ke/*", "*"] → series.changed when the serv
| Parameter | Type | Required | Notes |
|---|---|---|---|
| url | string | yes | Webhook endpoint that will receive HMAC-SHA256 signed events |
| series | array | no | Value watches, e.g. ["za/vat-registration-threshold", "ke/*", "*"] |
| sources | array | no | Exact official-source URLs from a series source.url. Unknown URLs are refused free. |
| api_key | string | no | Optional prepaid key stored on the subscription to fund deliveries after the trial. This call does not meter it. |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Reference Data or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.5.0.
1.5.0
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Reference Data can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.