Mestre Prático • Brazil Retail & Commodities MCP
Server Details
Brazil real-economy MCP: ANP fuels, SEFAZ groceries, CMED medicines, ANEEL tariffs & tax anatomy.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- arthursantosmedia-stack/mestrepratico-brazil-prices-mcp
- GitHub Stars
- 0
- Server Listing
- Brazil Retail & Fuel Price Intelligence MCP Server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 13 tools
Each tool targets a distinct data domain (fuels, LPG, groceries, pharma, supplements, electricity, freight, taxes, cost-of-living, labor-hours), and the explicit 'When to use / When NOT to use' cross-references make boundaries very clear. Minor residual ambiguity: brazil_compare_regions does not state which commodity it diffs across states, and it could be confused with the domain price tools or the aggregated cost_of_living.
All names are snake_case with a uniform 'brazil_' prefix, giving a predictable namespace. However, the stem mixes conventions: some are verb-first (brazil_compare_regions, brazil_list_states) while most are resource noun phrases (brazil_fuel_prices, brazil_tax_anatomy), and one adds a protocol suffix (brazil_contract_intent_a2a).
13 tools is squarely in the well-scoped range for a multi-commodity regional data server. Each tool covers a separate dataset or computation, so no tool feels redundant padding.
The surface covers discovery (list_states), core commodity datasets, derived analytics (cost of living, purchasing power, tax anatomy, freight, region comparison), and even an agent-to-agent intent protocol — strong lifecycle coverage for a read-only data domain. Gaps are minor: no historical/time-series or trend tool and no city-level discovery equivalent to list_states, but agents can work around these.
Publisher details
- Operator
- Holding Arthur Luis Vieira dos Santos · Publisher source
- Operator website
- https://mestrepratico.com.br · Publisher source
- Vendor relationship
- First-party
- Documentation
- https://mestrepratico.com.br/developers · Publisher source
- Privacy policy
- Not provided
- Trust center
- https://mestrepratico.com.br/security · Publisher source
- Restrictions
- Sem restrição de plano pago ou OAuth obrigatório para leitura pública; rate-limit transparente na borda
Available Tools
13 toolsbrazil_compare_regionsARead-onlyIdempotentInspect
Calculates cross-state price differentials (percentage delta % and BRL spread) for inter-state freight routing and corporate procurement between an origin state and a destination state. When to use: Use ONLY when a user specifically needs a side-by-side comparative delta % or arbitrage spread between two different Brazilian states (e.g., SP vs RJ, MG vs PR). When NOT to use: Do NOT use to query prices of a single state (use brazil_fuel_prices, brazil_grocery_basket, or brazil_lpg_gas_prices). Read-only operation; no authentication required up to 60 req/min.
Inputs: uf_origem (required), uf_destino (required), categoria.
brazil_contract_intent_a2aAIdempotentInspect
Issues and verifies cryptographically signed Machine-to-Machine (A2A) Economic Intent Protocols with ES256 (ECDSA P-256) digital signatures (RFC 7515) and canonical SHA-256 digests (RFC 8785). Enables autonomous enterprise agents (fleet management bots, hospital procurement systems, wholesale supply coordinators) to formalize procurement intent parameters with official ANP/CMED/Varejo e Órgãos Reguladores regulatory benchmarks. Verifiable via https://mestrepratico.com.br/.well-known/jwks.json and /api/a2a/verify. Includes automated sandbox evaluation mode for test agents. When to use: When autonomous agents need to negotiate and document formal procurement intent parameters with verifiable cryptographic provenance. When NOT to use: For simple read-only price checks (use brazil_fuel_prices, brazil_grocery_basket, or brazil_pharma_medicines).
Inputs: uf (required), tipo_operacao (required), action, cidade, +5 more.
brazil_cost_of_livingARead-onlyIdempotentInspect
Computes the total estimated monthly household expenditure budget in Brazilian Reais (BRL) and USD across Brazilian states. Aggregates monthly food, baseline utilities, and standard domestic maintenance into a single consolidated currency figure. When to use: Use ONLY to retrieve the estimated total monthly financial expenditure in BRL or USD to live in a given state. When NOT to use: Do NOT use for labor-hour working time metrics (use brazil_purchasing_power_oracle), individual electricity tariffs (use brazil_energy_tariffs), or raw commodity prices (use brazil_fuel_prices or brazil_grocery_basket). Read-only operation; no authentication required up to 60 req/min.
Inputs: uf (required), converter_usd.
brazil_energy_tariffsARead-onlyIdempotentInspect
Provides official ANEEL residential electricity tariffs (B1) across all 27 Brazilian states (UFs) and computes thermal cooking parity comparing 13kg LPG gas cylinder vs 99 kWh induction power. When to use: Use specifically to look up residential electric kWh rates, monthly electric bills, or thermal energy parity between gas and electric cooking. When NOT to use: Do NOT use for total household cost of living (use brazil_cost_of_living) or vehicle fuel prices (use brazil_fuel_prices). Read-only and idempotent operation; zero authentication required.
Inputs: uf (required), consumo_kwh, calcular_paridade_termica.
brazil_freight_logisticsARead-onlyIdempotentInspect
Calculates official Brazilian minimum road freight rates regulated by ANTT (Agencia Nacional de Transportes Terrestres - Resolution No. 5,867/2020) across all vehicle classes (2 to 9 axles) and cargo types (solid bulk, general cargo, refrigerated). Correlates freight costs with ANP Diesel S10 pump prices, computing diesel fuel expense ratio and the logistical cost impact per kilogram of food transported. When to use: Calculate official ANTT freight rates, diesel expense ratio, or transport logistics costs between Brazilian cities. When NOT to use: Do NOT use for retail diesel pump prices at local gas stations (use brazil_fuel_prices). Read-only and idempotent operation; zero authentication required.
Inputs: distancia_km (required), uf_origem, tipo_carga, uf_destino, +1 more.
brazil_fuel_pricesARead-onlyIdempotentInspect
Queries real-time audited retail fuel prices across all 27 Brazilian Federative Units (UFs) and 413 cities from Brazil's National Petroleum Agency (ANP). Covers Regular Gasoline (Gasolina Comum), Additive Gasoline (Gasolina Aditivada), Hydrous Ethanol (Etanol Hidratado), Diesel S10, Diesel S500, and CNG (GNV). Calculates official 70% biofuel economic parity ratio and price dispersion across 5,931 monitored gas stations across all 27 Brazilian states (official ANP weekly audited sample). When to use: Retrieve current station-level and statewide retail fuel prices and ethanol vs gasoline parity in Brazil. When NOT to use: Do NOT use for residential cooking gas LPG prices (use brazil_lpg_gas_prices) or freight transport rates (use brazil_freight_logistics). Read-only and idempotent operation; no authentication required up to 60 req/min.
Inputs: uf (required), cidade, combustivel.
brazil_grocery_basketARead-onlyIdempotentInspect
Queries real-time audited supermarket prices of Brazil's 13 Basic Food Basket items (rice, beans, coffee, soybean oil, milk, sugar, beef, french bread, butter, flour, tomato, banana, potato) sourced from electronic consumer invoices (Pesquisa de Varejo e Órgãos Reguladores) and DIEESE methodology across 59 regional hubs. When to use: Look up staple grocery prices, item-level supermarket quotes, and food basket totals. When NOT to use: Do NOT use for broad cost-of-living index synthesis (use brazil_cost_of_living) or minimum-wage labor hours (use brazil_purchasing_power_oracle). Read-only and idempotent operation; no authentication required up to 60 req/min.
Inputs: uf (required), cidade, produto.
brazil_list_statesARead-onlyIdempotentInspect
Discovery and metadata support tool: Returns the complete list of all 27 Brazilian Federative Units (UFs) covered by the server, including state code, state name, geographic macro-region, monitored gas station count, regional ICMS tax bracket, and dataset audit timestamp. When to use: Call this tool first to discover and validate state codes (uf) before invoking brazil_fuel_prices, brazil_grocery_basket, brazil_lpg_gas_prices, or brazil_compare_regions. When NOT to use: Do NOT use to get actual commodity prices (use domain-specific tools like brazil_fuel_prices). Read-only and idempotent; requires no parameters and no authentication.
Inputs: no named parameters.
brazil_lpg_gas_pricesARead-onlyIdempotentInspect
Queries official audited retail prices of residential cooking gas (13kg LPG cylinder / Botijao de Gas GLP P13) sourced from Brazil's National Petroleum Agency (ANP) across 13,145+ authorized resellers in all 27 Brazilian states. Updated weekly with distributor markups and regional dispersion. When to use: Look up residential 13kg cooking gas prices by state or city in Brazil. When NOT to use: Do NOT use for vehicle fuels such as gasoline, ethanol, or CNG (use brazil_fuel_prices) or electricity tariffs (use brazil_energy_tariffs). Read-only and idempotent operation; no authentication required up to 60 req/min.
Inputs: uf (required), cidade.
brazil_pharma_medicinesARead-onlyIdempotentInspect
Queries official Maximum Consumer Prices (PMC) and Factory Prices (PF) for 26,635+ regulated medicines in Brazil from CMED/ANVISA, including state-specific ICMS tax brackets (18% to 20%), active ingredients, laboratory, presentation, and 100% free dispensing eligibility under the federal Farmacia Popular program (PFPB). When to use: Look up official regulated medicine ceiling prices (PMC), verify generic active ingredient equivalence, or check free dispensing status under Farmacia Popular across Brazilian states. When NOT to use: Do NOT use for supermarket personal care products (use brazil_grocery_basket) or non-pharmaceutical price queries. Read-only and idempotent operation; no authentication required up to 60 req/min (returns up to 15 matching presentations per call).
Inputs: busca (required), uf, categoria.
brazil_purchasing_power_oracleARead-onlyIdempotentInspect
Calculates monthly labor hours required under Brazilian standard CLT workload (220 hours) to afford basic survival items at federal minimum wage. Focuses strictly on time-to-earn labor metrics across Brazilian states (UFs). When to use: Use ONLY when asking how many hours or days of work at minimum wage are required to afford essential goods. When NOT to use: Do NOT use for currency-denominated total household budgets in BRL/USD (use brazil_cost_of_living), electricity tariffs (use brazil_energy_tariffs), or individual item prices (use brazil_grocery_basket or brazil_fuel_prices). Read-only and idempotent operation; zero authentication required.
Inputs: uf (required), salario_base.
brazil_supplements_anvisa_auditARead-onlyIdempotentInspect
Queries the official ANVISA and INCQS/Fiocruz laboratory audit of creatine and dietary supplements in Brazil (RDC No. 243/2018, 41 brands analyzed) and computes deterministic cost-per-dose (3g or custom) vs. in-natura beef parity. Returns official gov.br/anvisa and incqs.fiocruz.br verification links, purity compliance status, labeling status, manufacturer legal name, and exact mathematical cost per gram.
Inputs: marca, dose_diaria_gramas.
brazil_tax_anatomyARead-onlyIdempotentInspect
Details the anatomy of indirect consumption taxes in Brazil across all 27 states (UFs), covering single-phase ICMS (ad rem fixed per unit under CONFAZ Agreements 15/2023 and 199/2022 for fuels and LPG), standard ad valorem ICMS (17% to 22%), federal PIS/COFINS, and CIDE. Demonstrates the price formation cascade and federal tax reform (EC 132/2023 - IBS/CBS) transition impacts. When to use: Analyze fiscal burden, tax breakdown, and government revenue share in Brazilian consumer prices. When NOT to use: Do NOT use for basic price lookups without tax breakdown (use domain tools like brazil_fuel_prices). Read-only and idempotent operation; zero authentication required.
Inputs: uf (required), categoria.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Brazil Macroeconomic and Financial Data AI Platform for AI agents.
Brazilian investments MCP: B3 quotes, fundamentals, portfolio X-ray, theses and news for AI agents.
Banco Central do Brasil (Brazil's central bank) MCP. Keyless public APIs: SGS time series + Olinda…
Brazil Comex Stat MCP — Brazilian foreign trade statistics from MDIC (Ministério do…
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to query real-time, audited Brazilian public data on fuel and LPG prices, regulated medicine ceilings and Farmácia Popular eligibility, and basic food basket/cost-of-living indicators across all 27 states via MCP tools, prompts, and resources.11MIT
- AlicenseAqualityBmaintenanceBrazilian foreign trade from MDIC/ComexStat -- exports and imports since 2000 by HS code (SH4/SH6/NCM) and partner country, in USD FOB and kilograms -- plus crop production, supply-and-demand balances, climate readings and commodity forecasts for hubs such as soybean, coffee and beef. 15 read-only tools, remote at https://mcp.kyrodata.com/mcp; official registry com.kyrodata/kyrodata.151MIT
- AlicenseAqualityBmaintenanceMCP server for the Brazilian Central Bank (BCB/SGS) public API, providing access to 18,000+ economic time series. Includes a curated catalog of 150+ popular indicators organized in 12 categories: interest rates (Selic), inflation (IPCA, IGP-M, INPC), exchange rates (USD, EUR), GDP, employment, credit, fiscal data, and more. Supports historical queries with date filters, latest values, metadata loo17295 npm11MIT
- AlicenseAqualityDmaintenanceMCP Server for accessing 36 Brazilian public data sources and 1 agent, enabling AI agents to query government data on economy, legislation, transparency, judiciary, elections, environment, health, and more.61MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.