{"service":"Toolrail","description":"Utility API for AI agents: PDF generation, public holidays and business days for supported countries, EU VAT, ECB FX rates, IBAN/phone validation, QR codes and Chilean operational data. Pay per call via x402 (USDC on Base / Solana). No API keys, no subscriptions.","payments":{"protocol":"x402","mode":"mainnet"},"endpoints":[{"route":"POST /pdf","price":"$0.01","description":"Generate a print-ready PDF from JSON data (invoice, report, contract templates) or raw HTML. Returns application/pdf. No account or subscription needed. Use when an agent must hand a person a document: invoices, quotes, reports or contracts as a PDF file.","example":"curl -X POST https://toolrail.dev/pdf -H \"Content-Type: application/json\" -d '{\"template\":\"invoice\",\"data\":{\"number\":\"F-001\",\"currency\":\"USD\",\"tax_rate\":19,\"issuer\":{\"name\":\"Acme\"},\"client\":{\"name\":\"Client Inc\"},\"items\":[{\"description\":\"Consulting\",\"quantity\":2,\"unit_price\":150}]}}' -o invoice.pdf"},{"route":"GET /vat/rates","price":"$0.002","description":"Current VAT rates for supported European countries (EU-27 + UK, CH, NO...). Standard, reduced and super-reduced rates, provided through the third-party vatnode dataset; verify applicability for your transaction. Latin American codes (CL, MX, PE...) are answered from the /latam/iva dataset. Use when pricing, invoicing or checking tax for a customer in Europe and you need that country's VAT rate.","example":"curl \"https://toolrail.dev/vat/rates?country=DE\""},{"route":"POST /vat/validate","price":"$0.003","description":"Validate an EU VAT number against the official European Commission VIES registry, with retries and caching for reliability. Returns validity, company name and address. Use when onboarding or invoicing an EU business and you must confirm its VAT number is registered.","example":"curl -X POST https://toolrail.dev/vat/validate -H \"Content-Type: application/json\" -d '{\"countryCode\":\"IE\",\"vatNumber\":\"6388047V\"}'"},{"route":"POST /vat/price","price":"$0.002","description":"VAT price calculator for supported European countries: net-to-gross or gross-to-net with the current standard or reduced rate. Returns net, VAT amount and gross. Use when you have a price and a European country and need the amount with or without VAT.","example":"curl -X POST https://toolrail.dev/vat/price -H \"Content-Type: application/json\" -d '{\"amount\":100,\"country\":\"DE\",\"direction\":\"net-to-gross\"}'"},{"route":"GET /fx/convert","price":"$0.003","description":"Convert between ~30 major currencies (including BRL and MXN) using official European Central Bank reference rates, current or historical since 1999; for CLP, ARS, COP or PEN use /latam/fx. Use when converting an amount between major currencies at an official reference rate, today or on a past date.","example":"curl \"https://toolrail.dev/fx/convert?from=USD&to=EUR&amount=100\""},{"route":"GET /fx/rates","price":"$0.003","description":"Full ECB reference rate table for any base currency, current or for a historical date since 1999. Use when you need many exchange rates at once against one base currency, today or historically.","example":"curl \"https://toolrail.dev/fx/rates?base=USD\""},{"route":"GET /days/holidays","price":"$0.003","description":"Official public holidays for supported countries (any year 1975-2075): date, local and English name, nationwide vs regional flag. Chile enhanced with a curated statutory table. Use when checking whether a date is a public holiday in a country or listing a year's holidays.","example":"curl \"https://toolrail.dev/days/holidays?country=DE&year=2026\""},{"route":"GET /days/business-days","price":"$0.003","description":"Business-day calculator for supported countries: add N working days to a date skipping weekends and official public holidays. Essential for scheduling, deadlines and logistics. Use when computing a deadline, delivery or payment date that must skip weekends and public holidays.","example":"curl \"https://toolrail.dev/days/business-days?country=US&from=2026-08-01&days=10\""},{"route":"POST /validate/iban","price":"$0.002","description":"Validate an IBAN (international bank account number): ISO 13616 mod-97 check digits and per-country length registry for 88 countries. Returns formatted IBAN and BBAN. Use when someone enters a bank account (IBAN) and you must catch typos before a transfer.","example":"curl -X POST https://toolrail.dev/validate/iban -H \"Content-Type: application/json\" -d '{\"iban\":\"DE89 3704 0044 0532 0130 00\"}'"},{"route":"POST /validate/phone","price":"$0.002","description":"Validate and format phone numbers for ~240 regions (Google libphonenumber): validity, region, line type, E.164 / international / national formats. Use when normalizing or checking phone numbers before saving a contact or sending SMS or WhatsApp.","example":"curl -X POST https://toolrail.dev/validate/phone -H \"Content-Type: application/json\" -d '{\"phone\":\"+56 9 6123 4567\"}'"},{"route":"POST /validate/tax-id","price":"$0.002","description":"Validate the format and supported check-digit rules of tax IDs across Latin America and Spain: Chile RUT, Argentina CUIT/CUIL, Brazil CPF/CNPJ, Mexico RFC, Peru RUC, Colombia NIT, Spain NIF/NIE. Does not verify identity or registration with a tax authority. Use when checking a Latin American or Spanish tax ID's format before saving a customer or an invoice.","example":"curl -X POST https://toolrail.dev/validate/tax-id -H \"Content-Type: application/json\" -d '{\"country\":\"BR\",\"id\":\"529.982.247-25\"}'"},{"route":"GET /latam/indexacion","price":"$0.005","description":"Latin American inflation-indexed units used in real contracts, mortgages and rents: UF (Chile), UVA (Argentina), UVR (Colombia), UDI (Mexico) and UI (Uruguay) — live official values with local-currency conversion; UF and UI also for a given date. Use when a contract, rent or loan is expressed in UF, UVA, UVR, UDI or UI and you need its value in local currency.","example":"curl \"https://toolrail.dev/latam/indexacion?unidad=uva&monto=100\""},{"route":"GET /latam/dolar-argentina","price":"$0.005","description":"Argentine dollar quotes in one call: oficial, blue (parallel) and euro rates with the official-blue gap, plus MEP, contado con liquidación, mayorista, cripto and tarjeta quotes with their gap against the official rate. Use when you need the Argentine peso exchange rate, a specific Argentine dollar (blue, MEP, CCL, tarjeta) or the gaps between them.","example":"curl \"https://toolrail.dev/latam/dolar-argentina\""},{"route":"GET /latam/fx","price":"$0.015","description":"LATAM exchange rates against USD in one call: CLP, ARS oficial+blue with gap, BRL PTAX, MXN FIX, COP TRM and PEN SBS. Returns source and observation information per currency; Argentine blue is a market quote, not an official central-bank rate. Partial results are identified. Use when you need official central-bank exchange rates for several Latin American currencies against the US dollar in a single call.","example":"curl \"https://toolrail.dev/latam/fx\""},{"route":"GET /latam/iva","price":"$0.002","description":"VAT (IVA) rates for 17 Latin American countries, including Argentina, Chile, Colombia, Mexico, Peru (IGV) and the Dominican Republic (ITBIS): standard and reduced rates, plus net-to-gross or gross-to-net calculation. Reviewed dataset with source and review date; Brazil is excluded because it has no single rate. Use when pricing, quoting or invoicing in Latin America and you need the local VAT rate or the amount with or without tax.","example":"curl \"https://toolrail.dev/latam/iva?pais=CL&monto=100000&direccion=neto-a-bruto\""},{"route":"GET /latam/unidades-tributarias","price":"$0.003","description":"Annual tax units used to express fines, thresholds and fees in Latin America: UIT (Peru), UVT (Colombia) and UMA (Mexico). Official value for a date with its legal act and validity window, plus conversion of N units to local currency. Use when a law, fine, tax threshold or fee is stated in UIT, UVT or UMA and you need the amount in local currency.","example":"curl \"https://toolrail.dev/latam/unidades-tributarias?unidad=uvt&cantidad=10\""},{"route":"GET /latam/tasas-politica","price":"$0.01","description":"Latin American monetary policy rates in one call: Chile TPM, Brazil Selic target, Mexico target rate, Colombia and Peru policy rates, each with its central bank, date (Peru: monthly period) and source. Partial results are identified when a central bank does not answer. Use when you need current central-bank interest rates for several Latin American countries; filter with ?paises=CL,BR.","example":"curl \"https://toolrail.dev/latam/tasas-politica?paises=CL,BR,MX\""},{"route":"GET /br/indices","price":"$0.005","description":"Brazil's key official rates in one call: SELIC target, annualized CDI, monthly IPCA inflation and PTAX dollar — straight from Banco Central do Brasil's SGS API. Use when you need Brazil's interest rate (SELIC/CDI), inflation (IPCA) or official dollar (PTAX).","example":"curl \"https://toolrail.dev/br/indices\""},{"route":"GET /br/cep","price":"$0.002","description":"Brazilian postal code (CEP) lookup: street, neighborhood, city, state and IBGE code for any of Brazil's 700k+ CEPs. Use when you have a Brazilian postal code (CEP) and need the full address.","example":"curl \"https://toolrail.dev/br/cep?cep=01310-100\""},{"route":"GET /br/cnpj","price":"$0.005","description":"Brazilian company lookup by CNPJ from the Receita Federal open register: legal and trade name, registration status and date, opening date, legal nature, size, share capital, main CNAE activity and address. Check digits are validated first, including the alphanumeric CNPJ. Partners and contact data are excluded. Use when you have a Brazilian CNPJ and need to confirm the company exists and is active before invoicing or onboarding it.","example":"curl \"https://toolrail.dev/br/cnpj?cnpj=19.131.243/0001-97\""},{"route":"GET /ar/indices","price":"$0.005","description":"Argentina's macro pulse: latest monthly inflation, compounded year-over-year inflation, and country risk (riesgo país) in basis points. Use when you need Argentina's latest inflation or country risk for a report or a price adjustment.","example":"curl \"https://toolrail.dev/ar/indices\""},{"route":"GET /co/trm","price":"$0.005","description":"Colombia's official TRM (Tasa Representativa del Mercado) — the legal COP/USD rate used for taxes and contracts, with validity dates. Use when you need the official COP/USD rate for Colombian taxes, invoices or contracts.","example":"curl \"https://toolrail.dev/co/trm\""},{"route":"GET /pe/tipo-cambio","price":"$0.005","description":"Peru's official SBS exchange rate (buy/sell PEN per USD) from the central bank (BCRP). Use when you need the official PEN/USD exchange rate for Peru.","example":"curl \"https://toolrail.dev/pe/tipo-cambio\""},{"route":"GET /mx/indicadores","price":"$0.005","description":"Mexico's official dollar rates from Banco de México: the FIX by determination date and the rate for paying dollar obligations today (the FIX published in the DOF the previous banking day), plus the TIIE 28-day rate. Use when you need Mexico's FIX, the exchange rate to settle a dollar obligation, or the TIIE.","example":"curl \"https://toolrail.dev/mx/indicadores\""},{"route":"GET /cl/reajuste","price":"$0.01","description":"Chilean IPC adjustment calculator: official INE inflation between two months (from the index levels, matching the INE variation) to reajust any amount — the standard calculation for rents, alimony and contracts in Chile. Use when adjusting a Chilean rent, debt or alimony amount for inflation (IPC) between two months.","example":"curl \"https://toolrail.dev/cl/reajuste?desde=2025-01&hasta=2025-06&monto=500000\""},{"route":"POST /qr","price":"$0.002","description":"Generate a QR code as PNG or SVG from any text or URL (up to 2000 chars, 64-2048 px). Pairs with the PDF endpoint for payment links and labels. Use when you need a scannable QR image for a URL, payment link or label.","example":"curl -X POST https://toolrail.dev/qr -H \"Content-Type: application/json\" -d '{\"data\":\"https://toolrail.dev\",\"format\":\"png\",\"size\":512}' -o qr.png"},{"route":"GET /cl/indicadores","price":"$0.005","description":"Chilean economic indicators: UF, UTM, dolar observado, euro, IPC, monetary policy rate (TPM), IMACEC, copper price, unemployment rate and IVP — current or for a given date (the UF also for future dates up to the 9th of next month, as it is published in advance). Official Banco Central de Chile and INE data. Use when you need a Chilean economic indicator for today or a past date.","example":"curl \"https://toolrail.dev/cl/indicadores?indicador=uf\""},{"route":"GET /cl/uf","price":"$0.005","description":"Convert amounts between UF (Unidad de Fomento) and Chilean pesos at any past date, or a future date up to the 9th of next month (the UF is published in advance: on 11 November, 30 November already works). Essential for Chilean contracts, rents and insurance. Use when an amount is expressed in UF and you need Chilean pesos, or the reverse.","example":"curl \"https://toolrail.dev/cl/uf?monto=50&direccion=uf-clp\""},{"route":"GET /cl/dias-habiles","price":"$0.003","description":"Chilean business-day calculator: add N working days to a date respecting national holidays. Types: administrativo (Mon-Fri) or corrido. Use when computing a legal or administrative deadline in Chile in business days (días hábiles).","example":"curl \"https://toolrail.dev/cl/dias-habiles?desde=2026-08-01&plazo=10\""},{"route":"GET /cl/feriados","price":"$0.003","description":"Official Chilean public holidays for 2026-2027 as structured JSON, including statutory moved holidays. Use when you need Chile's official holiday calendar (feriados) for scheduling.","example":"curl \"https://toolrail.dev/cl/feriados?ano=2026\""},{"route":"POST /cl/rut","price":"$0.002","description":"Validate and format a Chilean RUT (tax ID) including check digit (modulo 11). Use when a Chilean RUT is entered in a form or file and you must catch typos before saving.","example":"curl -X POST https://toolrail.dev/cl/rut -H \"Content-Type: application/json\" -d '{\"rut\":\"12.345.678-5\"}'"},{"route":"POST /cl/sueldo-liquido","price":"$0.01","description":"Chilean net salary calculator: gross to net with AFP, health, unemployment insurance and impuesto unico using live UF/UTM values and current legal brackets. Use when estimating a Chilean employee's take-home (líquido) pay from a gross salary.","example":"curl -X POST https://toolrail.dev/cl/sueldo-liquido -H \"Content-Type: application/json\" -d '{\"bruto\":1500000,\"afp\":\"modelo\"}'"},{"route":"GET /cl/honorarios","price":"$0.002","description":"Chilean boleta de honorarios calculator: gross to net, or the gross to issue for a target net, with the withholding rate of each year under Ley 21.133 (15.25% in 2026, 16% in 2027, 17% from 2028), in whole pesos. Use when a Chilean freelancer or company needs the net amount of a fee receipt (boleta de honorarios) or the gross amount to issue.","example":"curl \"https://toolrail.dev/cl/honorarios?monto=1000000&direccion=bruto-a-liquido\""},{"route":"GET /guia/pdf","price":"$7.00","description":"PDF edition of 'Build your own x402 API' — available in Spanish, English or Portuguese (?lang=es|en|pt). A real-world walkthrough of building Toolrail: architecture, real bugs found and fixed, security checklist, discovery channels, and an honest revenue simulation. Includes a printable launch checklist. One-time purchase. Use when you want a practical guide to building and selling your own paid API with x402.","example":"curl \"https://toolrail.dev/guia/pdf?lang=en\" -o guide-x402.pdf"}],"free_endpoints":["GET /","GET /es","GET /probar","GET /try","GET /integrar","GET /integrate","GET /api/uf-chile","GET /api/validar-rut","GET /api/dias-habiles-chile","GET /api/dolar-argentina","GET /api/iva-europa","GET /api/iva-latam","GET /calculadoras","GET /calculadora/sueldo-liquido","GET /calculadora/honorarios","GET /calculadora/dias-habiles","GET /uf-hoy","GET /health","GET /pdf/templates","GET /openapi.json","GET /llms.txt","GET /skill.md","POST /mcp","GET /.well-known/agent-card.json","GET /.well-known/agent-catalog.json","POST /a2a"],"a2a":{"card":"https://toolrail.dev/.well-known/agent-card.json","url":"https://toolrail.dev/a2a","scope":"free catalog discovery only; paid calls use x402 HTTP routes"},"mcp":{"url":"https://toolrail.dev/mcp","transport":"streamable-http","tools":31,"cost":"free demo (30 tool calls/UTC day/client)","upgrade":"https://toolrail.dev/skill.md","setup":"claude mcp add --transport http toolrail https://toolrail.dev/mcp"},"docs":"https://toolrail.dev/pdf/templates","openapi":"https://toolrail.dev/openapi.json"}