{"name":"usaref","description":"North American government reference data for AI agents: central-bank policy rates, VAT, minimum wages, CPI inflation, corporate and personal income tax, and public holidays across 10 countries. Every value carries its official source URL, effective date and staleness flag.","version":"1.0.0","provider":{"organization":"3L Group Consulting","url":"https://usaref.dev"},"documentationUrl":"https://usaref.dev/openapi.json","interfaces":[{"transport":"mcp-streamable-http","url":"https://usaref.dev/mcp","description":"MCP server: free discovery tools plus paid data tools"},{"transport":"rest-openapi","url":"https://usaref.dev/openapi.json","description":"OpenAPI REST surface"}],"capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"payment":{"protocol":"x402","network":"eip155:8453","payTo":"0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6","discovery":"https://usaref.dev/.well-known/x402.json","note":"Paid endpoints answer 402 with payment instructions; a valid X-API-Key is also accepted."},"skills":[{"id":"list_series","name":"List available series","description":"Catalog of 14 series types across 10 North American countries","tags":["catalog","discovery"],"free":true},{"id":"get_public_holidays","name":"Public holidays","description":"Official public holidays for a country and year","tags":["holidays","calendar"],"free":true},{"id":"get_changes","name":"Change and freshness feed","description":"Free, unmetered feed of series whose current value moved, plus how recently the served set was re-verified. Poll this instead of re-buying a series.","tags":["changes","freshness","discovery"],"free":true},{"id":"get_calendar","name":"Re-verification calendar","description":"Free, unmetered re-verification window for this brand. reverify_by is derived from last_confirmed + update_cycle_days. status unknown omits any next date. Notes are not parsed. Not an MPC, budget, or wage-review date.","tags":["calendar","freshness","discovery"],"free":true},{"id":"get_series","name":"Get a reference value","description":"One cited reference value (policy rate, VAT, minimum wage, CPI, corporate or personal income tax) with source URL and effective date","tags":["reference-data","government"],"free":false},{"id":"get_series_history","name":"Series history","description":"Historical values for a series over a date range","tags":["history","time-series"],"free":false},{"id":"get_snapshot","name":"Regional snapshot","description":"Every current series value for every country in the region","tags":["bulk","snapshot"],"free":false},{"id":"get_country_brief","name":"Country brief","description":"Every series for one country in one call, each cited","tags":["bundle","country-profile"],"free":false},{"id":"validate_tax_id","name":"Validate a tax ID / VAT number","description":"Format and (where published) official check-digit validation of a tax ID or VAT number: valid/invalid, normalised form, id type, failure reason, cited","tags":["tax-id","vat-number","validation"],"free":false},{"id":"compare_series","name":"Compare across countries","description":"One series across up to 10 countries in one call, each row cited","tags":["bundle","compare"],"free":false},{"id":"vat_determine","name":"Cross-border VAT determination (for x402/API sellers)","description":"For a seller making a cross-border digital sale: which jurisdiction's VAT applies, who accounts for it, the registration trigger and rate basis — each cited to the statute (EU, UK & South Africa; defined supply pairs). Handles the wallet-only, unidentified-buyer case that x402 settlements produce.","tags":["vat","tax","compliance","x402-sellers","cross-border"],"free":false},{"id":"compute_statutory_interest","name":"Statutory interest","description":"Simple interest on a principal at the cited statutory-interest series rate (Actual/365). A series with no numeric rate is refused free. Optional receipt:true on the paid HTTP 200, included in this answer's price. Verify with verify_answer_receipt (free).","tags":["interest","statutory-interest"],"free":false},{"id":"verify_answer_receipt","name":"Verify an answer receipt","description":"Free check of an answer receipt (kind answer_receipt) against the public key at /certified/public-key. Confirms this service signed that receipt. Not a series certified extract and not legal advice.","tags":["receipt","verification"],"free":true}],"countries":["bs","ca","cr","do","gt","hn","mx","pa","sv","us"]}