This server lets you query, compare, and synthesize Brazilian retail, fuel, grocery, LPG, pharmaceutical, energy, freight, tax, and cost-of-living data.
Query audited fuel prices by state, city, and fuel type.
Query grocery basket prices, product offers, and regional food costs.
Calculate purchasing power, labor-hours, and cost-of-living/PPP indices.
Check electricity tariffs, monthly bills, and LPG-vs-induction cooking parity.
Estimate ANTT freight floors and diesel cost impact.
Decompose ICMS/PIS/COFINS taxes and Tax Reform effects.
Retrieve 13kg LPG cooking gas prices and reseller data.
Search CMED/ANVISA medicine prices and Farmácia Popular eligibility.
List all 27 Brazilian states and coverage metadata.
Compare fuel, LPG, and grocery costs between two states.
Use MCP prompts/resources and NLWeb ask/who endpoints for direct QA and agent workflows.
Implements the Linux Foundation A2A (Agent-to-Agent) protocol through the brazil_contract_intent_a2a tool, enabling machine-to-machine economic intent exchange with SHA-256 sealing and 24-hour price locks for multi-agent settlement workflows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Mestre Prático & NutriPreço Official MCP Server qual o preço médio da gasolina em Cabo Frio, RJ?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
In addition to JSON-RPC 2.0 MCP, this server natively implements the NLWeb Protocol (Standardized by Microsoft / Schema.org consortium):
Direct QA Endpoint: GET/POST https://mestrepratico.com.br/ask?q={query} (Modes: generate, summarize, list)
Agent Identity Endpoint: GET https://mestrepratico.com.br/who
Factual Attribution: Indissociable canonical attribution to https://mestrepratico.com.br with Schema.org JSON-LD grounding.
Official sovereign Model Context Protocol (MCP) server providing real-time audited Fuel Prices (ANP), Basic Grocery Basket Indices (SEFAZ NFC-e / Decree 11.936/2024), Residential LPG Cooking Gas 13kg (ANP), Regulated Pharmaceuticals & Farmácia Popular (CMED / ANVISA), and Macroeconomic Cost-of-Living Synthesis across all 27 Brazilian states and 417+ cities.
Built and maintained by Holding Arthur Luis Vieira dos Santos — Tecnologia e Inteligência de Varejo Inova Simples (I.S.) (CNPJ 69.423.752/0001-61 — Mestre Prático & NutriPreço).
Related MCP server: mcp-brasil
"Our First Sovereign MCP: Engineered to Evolve with the Community"
This is the first Model Context Protocol server developed and published by Holding Arthur Luis Vieira dos Santos. Brazil's continental economy — spanning 27 federal units and 5,570 municipalities — is a living, dynamic ecosystem. We do not operate under the illusion of perfection; instead, we operate under the Kaizen Principle: transparent engineering, continuous active calibration, and absolute honesty with developers and autonomous AI agents.
Every macroeconomic indicator, tax rate, and regulatory ceiling returned by our 12 sovereign tools is strictly calibrated against official primary authorities:
National Minimum Wage: Calibrated to R$ 1,621.00 / month (R$ 7.37 / hour) in accordance with Federal Decree No. 12,797/2025 (Decreto nº 12.797/2025).
Freight & Logistics Floor: Anchored to ANTT Resolution No. 5,867/2020 & Decree No. 11.936/2024 (Basic Grocery Basket composition).
Fuels & Cooking Gas (LPG): Sourced from official ANP (Agência Nacional do Petróleo, Gás Natural e Biocombustíveis) regulatory surveys.
Pharmaceutical Ceilings: Calibrated to CMED (Câmara de Regulação do Mercado de Medicamentos) / ANVISA maximum consumer price lists (PMC) and SUS Farmácia Popular coverage.
If you are building AI agents, testing connectors, or auditing data accuracy across Brazilian retail and logistics:
Found an edge-case, tax nuance, or regional variance? Open an Issue or Pull Request on our GitHub repository.
Need a specialized metric, webhook trigger, or schema enhancement? Our engineering team reviews and calibrates data feeds daily.
Direct Technical Desk: contato@mestrepratico.com.br | holding@mestrepratico.com.br
GitHub Issues: nutripreco-oficial/mestre-pratico-mcp-server/issues
By deliberate commercial governance and intellectual property protection under Brazilian Copyright Law No. 9.610/98 (Art. 7, XIII), the unauthenticated Community / Discovery Tier exposes real-time spot prices (T+0) with curated horizon sampling (max 3 stations / 2 LPG resellers / 3 medicines per query).
Full Historical Price Time-Series (12-to-36 month ANP/SEFAZ/CMED inflation curves), Multi-Laboratory Pharmaceutical Therapeutic Equivalence & Cross-State Price Comparisons, and Uncapped 417+ City Bulk Datasets are fully indexed in our sovereign vault and exclusively unlocked for Enterprise & Commercial API Licensees (Authorization: Bearer <ENTERPRISE_API_KEY>).
👉 Corporate Partnerships & Dedicated Enterprise Keys: contato@mestrepratico.com.br | https://mestrepratico.com.br/developers
Endpoint URL: https://mestrepratico.com.br/mcp/v1
Transport: Streamable HTTP (POST /mcp/v1 JSON-RPC 2.0 & GET /mcp/v1 discovery manifest) + Local stdio Bridge (index.js / Docker).
Developers & Corporate Portal: https://mestrepratico.com.br/developers
Our server is a certified Full Tri-Pillar Model Context Protocol (MCP) implementation providing complete cognitive agency across 3 protocol primitives:
tools (12 Sovereign Tools): Instant sub-100ms RPC function calling across fuel, grocery, medicines, labor-hours, electricity tariffs, freight, and taxes.
prompts (5 Cognitive A2A Workflows): Structured multi-step reasoning templates (analisar_orcamento_familiar, auditar_viabilidade_logistica_antt, raio_x_tributario_reforma, auditar_preco_farmacia, analise_combustivel_frota) that guide autonomous agents to audit, compute, and synthesize executive memos.
resources (8 Canonical URIs): Direct live data hydration for AI agents without prompt injection risk (mcp://brazil/macro/bcb-series, mcp://brazil/energy/aneel-tariffs, mcp://brazil/logistics/antt-freight-table, mcp://brazil/tax/confaz-icms-monofasico, etc.).
brazil_* Tools (Glama Grade A — TDQS 4.4/5.0)All 12 tools enforce strict brazil_* naming consistency, JSON Schema input constraints, and official MCP annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true):
Tool Name | Primary Authority | Public Spot Sample ( | Enterprise Unlock ( |
| ANP / SEFAZ NFC-e | Top 3 audited stations + state averages (Gasoline, Ethanol, Diesel S10, CNG) | Full 4,750+ stations across 417+ cities + Weekly Historical Time-Series |
| SEFAZ NFC-e / Supermarkets | Spot regional basket total & top supermarket chains (13 essential items) | Store-by-store SKU breakdown + Daily Historical Inflation Time-Series |
| Macroeconomic / Dieese | Single-state combined monthly food + fuel + transport index in BRL/USD | Multi-city longitudinal purchasing-power parity (PPP) & Historical Trends |
| ANP Open Data | Top 2 authorized 13kg LPG cooking gas resellers + state average/min/max | All 13,145+ resellers with neighborhood delivery spread + Historical Series |
| CMED / ANVISA / SUS | Up to 3 matching presentations with Factory Price (PF), PMC, and Farmácia Popular | Full 26,635+ ANVISA catalog + Multi-Lab Generic vs. Reference Comparison & History |
| Discovery Metadata | All 27 Brazilian UF codes, station coverage counts, ICMS tax rates, timestamps | Full municipality slug directory & real-time webhook sync metadata |
| DIEESE / BACEN / IBGE / ANEEL | Minimum wage labor-hours required to purchase monthly 13-item grocery basket, 13kg LPG, fuel & 150 kWh electricity | Real purchasing power parity (PPP) by state & Historical Labor-Hours Trend |
| ANEEL / ANP | Homologated residential B1 electricity rates across all 27 UFs + Thermal cooking parity (GLP vs induction) | Distribution network cost-breakdown & Seasonal Tariff Flags (Bandeiras Tarifárias) |
| ANTT / ANP | Road freight cost floor per distance/axle + Diesel S10 consumption and transport cost per kg of food | Fleet dispatch optimization & Bulk Grain Highway Corridor Freight Curves |
| CONFAZ / EC 132 | Constitutional tax decomposition (ICMS Monofásico vs. Net Product) across all 27 UFs | State-by-state fiscal anatomy & Tax Reform IBS/CBS Dual-Rate Transition Analysis |
| Cross-State Synthesis | Side-by-side fuel & grocery differential + 70% ethanol/gasoline parity ratio | Multi-Sector Cross-State Comparison (including Pharma ICMS 18% vs 20% & LPG) |
| Linux Foundation A2A Protocol | M2M Economic Intent Protocol with SHA-256 seal & 24h price lock | Multi-Agent Machine Liquidation & Regulatory Escrow Settlement |
In strict accordance with the Founding Charter of Holding Arthur Luis Vieira dos Santos, legacy monthly subscription contracts have been decommissioned in favor of a frictionless, autonomous AI-native pricing architecture:
Tier | Rate Limit & Access | Pricing | Settlement Protocol | Features & Scope |
🌱 Community & Open Grounding | 60 req/min (Zero-Auth / Anonymous) | Free (R$ 0,00) | None required | All 12 canonical |
⚡ Sovereign High-Throughput RAG | 2,400 req/min (Dedicated Edge Capacity) | R$ 5,00 / 1.000 reqs (or ~0.001 USDC / call) | HTTP 402 / x402 Micropayments or Pix | High-frequency agent swarms, sub-15ms Anycast SLA, municipality-level pump telemetry, raw bulk feeds & cryptographic audit receipts. |
Autonomous agents exceeding community rate limits or requesting batch feeds can pay per query natively via RFC HTTP 402 without manual human invoicing:
GET /mcp/v1 HTTP/1.1
Host: mestrepratico.com.br
X-Payment: mp_x402_<session_token>Discovery Endpoint: https://mestrepratico.com.br/.well-known/x402
Supported Rails: Pix (instant BRL), Base, Solana, Polygon, Lightning (USDC/SATS).
Corporate Partnerships & Dedicated SLAs: contato@mestrepratico.com.br | Developer Portal
Install automatically with a single terminal command:
npx -y @smithery/cli install @mestrepratico/brazil-prices-mcpOr connect directly via remote HTTP:
{
"mcpServers": {
"mestrepratico-brazil": {
"type": "http",
"url": "https://mestrepratico.com.br/mcp/v1",
"headers": {
"Authorization": "Bearer YOUR_ENTERPRISE_API_KEY_OPTIONAL"
}
}
}
}Protected by forensic Canary Tokens (NC-CANARY-BRL-*) under Brazilian Copyright Law No. 9.610/98 (Art. 7, XIII), Berne Convention, and 17 U.S.C. § 1202. Unauthorized proxy rotation, systematic scraping, or removal of source attribution ("Fonte: Mestre Prático — mestrepratico.com.br") triggers automatic Edge ASN blocking (HTTP 402/403) and statutory liquidated damages of US$ 100,000.00 (R$ 500.000,00) per infringement.
Comparative synthesis tool: Compares weighted average prices and percentage deltas for fuels (gasoline, ethanol, diesel), 13kg LPG cooking gas, and basic food basket costs side-by-side between any two Brazilian states (origin UF vs. destination UF). Read-only operation; no authentication required up to 60 req/min. Use brazil_list_states to discover valid UF codes, or brazil_fuel_prices and brazil_grocery_basket for single-state station/store drilldowns.
Inputs: origem_uf (required), destino_uf (required), indicador.
Computes a consolidated regional cost-of-living index and purchasing power parity (PPP) in Brazil, combining average fuel expenditure, basic food basket cost, and live USD/BRL exchange rate conversion. Updated daily. Read-only operation; no authentication required up to 60 req/min. Use brazil_fuel_prices or brazil_grocery_basket for granular item-level breakdowns, or brazil_compare_regions to compare two states side-by-side.
Inputs: uf, comparar_com_dolar.
Provides official ANEEL (Agência Nacional de Energia Elétrica) residential electricity tariffs (B1) across all 27 Brazilian states (UFs), covering state concessionaires (e.g. Light, Enel, Cemig, Copel, Equatorial, Celesc). Computes estimated monthly electric bills for a given consumption baseline (default 150 kWh), and calculates thermal cooking parity: comparing the cost of residential cooking with an ANP 13kg LPG cylinder against 99 kWh of electric induction cooking. Read-only operation; zero authentication required.
Inputs: uf, consumo_mensal_kwh, incluir_paridade_termica_gas.
Calculates official Brazilian minimum road freight rates regulated by ANTT (Agência 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. Read-only operation; zero authentication required.
Inputs: uf_origem, tipo_carga, uf_destino, distancia_km, +1 more.
Queries real-time audited retail fuel prices in Brazil (Regular Gasoline, Additive Gasoline, Hydrous Ethanol, Diesel S10, and CNG) sourced from Brazil's National Petroleum Agency (ANP) across 4,750+ stations in all 27 states and 417+ cities. Updated weekly with daily SEFAZ NFC-e cross-validation. Read-only operation; no authentication required for standard rate limits (60 req/min, max 50 stations returned per call). Use brazil_list_states first to discover valid state codes (uf), or brazil_compare_regions to compare averages between two states.
Inputs: uf (required), cidade, combustivel.
Queries and compares real-time audited prices of Brazil's 13 Basic Food Basket items (rice, beans, coffee, soy oil, milk, sugar, beef, bread, butter, etc.) sourced from electronic consumer invoices (NFC-e SEFAZ) and DIEESE methodology across 59 regional hubs. Updated daily. Read-only operation; no authentication required up to 60 req/min. Use brazil_list_states to check regional coverage, brazil_cost_of_living for full household budget synthesis, or brazil_compare_regions for cross-state comparisons.
Inputs: uf (required), cidade, produto.
Discovery and metadata support tool: Returns the complete list of all 27 Brazilian Federative Units (UFs) covered by the server, including state code, full name, monitored gas station count, regional ICMS tax bracket, and dataset audit timestamp. Read-only and idempotent; requires no parameters and no authentication. Call this tool first to validate UF codes before invoking brazil_fuel_prices, brazil_grocery_basket, brazil_lpg_gas_prices, or brazil_compare_regions.
Inputs: no named parameters.
Queries official audited prices of residential cooking gas (13kg LPG cylinder / Botijao GLP P13) sourced from Brazil's National Petroleum Agency (ANP) across 13,145+ authorized resellers in all 27 Brazilian states. Updated weekly. Read-only operation; no authentication required up to 60 req/min. Use brazil_list_states to list valid UF codes or brazil_compare_regions to compare LPG costs between states.
Inputs: uf (required), cidade.
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 free eligibility under the federal Farmacia Popular program. Updated monthly per CMED resolution. Read-only operation; no authentication required up to 60 req/min (returns up to 15 matching presentations per call).
Inputs: termo (required), uf, tipo.
Calculates real purchasing power parity (PPP) and labor-hour requirements across all 27 Brazilian states (UFs). Computes the exact working hours required to afford essential household survival goods: the 13 essential grocery items (SEFAZ NFC-e / DIEESE), residential 13kg cooking gas (ANP), fuel (50L gasoline tank), and electricity (150 kWh ANEEL). Correlates with Banco Central do Brasil (BCB SGS) interest and inflation rates, thermal parity (LPG vs. electric induction cooking), and CONFAZ tax anatomy. Read-only operation; zero authentication required.
Inputs: uf, salario_mensal_brl.
Performs constitutional and fiscal tax decomposition across all 27 Brazilian states (UFs) based on CONFAZ (Conselho Nacional de Política Fazendária) Agreements (ICMS Monofásico No. 15/2023 & No. 199/2022), Federal Decree No. 11,936/2024, and Tax Reform Constitutional Amendment EC 132/2023. Decomposes exact state ICMS, federal PIS/COFINS, and net physical product values for retail fuels, 13kg cooking gas, the basic food basket, and CMED pharmaceuticals. Read-only operation; zero authentication required.
Inputs: uf, categoria.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 11 tools
Most tools target a clearly distinct resource (fuels, grocery, LPG, energy, freight, tax, pharma, states), so selection is straightforward. However, three aggregation tools—brazil_cost_of_living, brazil_purchasing_power_oracle, and brazil_compare_regions—all synthesize PPP/cost-of-living style outputs, creating some boundary fuzziness an agent must reason through.
Every tool uses the identical brazil_<snake_case_noun> convention (brazil_fuel_prices, brazil_list_states, brazil_compare_regions), so the naming is fully predictable and easy to scan. No mixing of conventions.
Eleven tools is well within the appropriate range and each maps to a distinct data domain or supporting function (list/compare). No tool feels redundant or padded for the scope.
The surface broadly covers Brazil's consumer-cost domain: fuels, grocery basket, LPG, electricity, freight, taxes, pharmaceuticals, plus discovery/aggregation helpers. Minor gaps exist (e.g., no historical/time-series queries or cross-domain search), but core analytical workflows are covered.
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
Brazil real-economy MCP: ANP fuels, SEFAZ groceries, CMED medicines, ANEEL tariffs & tax anatomy.
AI-powered commodity price forecasts and Brazil trade intelligence via MCP. Access Brazilian exports and imports from MDIC/ComexStat since 2000, by HS4, HS6 and NCM code, partner country, USD FOB and kilograms — plus crop production, supply & demand, climate data and production forecasts for major commodities including soybeans, coffee, corn, beef and cocoa. Compare trade flows, markets, countries and time periods with like-for-like windows. Every answer identifies the measurement period and data source. 15 read-only tools. Metered in credits. Connect directly via Streamable HTTP — no installation required: https://mcp.kyrodata.com/mcp Authentication: Bearer key or OAuth 2.1 (PKCE). Official MCP registry: com.kyrodata/kyrodata
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
