Skip to content
Conduit

mcp server

mestre-pratico-mcp-server

Official Model Context Protocol (MCP) Server for Brazilian Public Data: Audited Fuel Prices (ANP), LPG Cooking Gas (ANP), Regulated Medicines PMC & Farmacia Popular (ANVISA/CMED), and Basic Food Baske

nutripreco-oficial/mestre-pratico-mcp-servercommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mestre-pratico-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mestrepratico/brazil-prices-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 26, 2026

Mestre Prático & NutriPreço — Brazil Retail, Fuel & Healthcare Price Intelligence MCP Server

MCP Protocol Anthropic MCP Registry Glama Grade A Small Print Verified ModelScope MCP Cloudflare Edge License: MIT Status: Online

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).

🤝 Open Governance & Continuous Calibration (The Kaizen Principle)

"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.

🛡️ Active Maintenance Guarantee & Legal Grounding

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.

💡 Building in Public — How You Can Help Us Improve

If you are building AI agents, testing connectors, or auditing data accuracy across Brazilian retail and logistics:

[!IMPORTANT]

📊 Architectural Note on Historical Time-Series, Multi-Lab Pharmaceutical Comparisons & Full-Horizon Datasets

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

🌐 Live Remote MCP Endpoint (Zero-Install HTTP / Edge)

  • 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

🤖 Agent-to-Agent (A2A) Layer — Full Tri-Pillar MCP Compliance

Our server is a certified Full Tri-Pillar Model Context Protocol (MCP) implementation providing complete cognitive agency across 3 protocol primitives:

  1. tools (12 Sovereign Tools): Instant sub-100ms RPC function calling across fuel, grocery, medicines, labor-hours, electricity tariffs, freight, and taxes.
  2. 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.
  3. 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.).

🛠️ The 12 Sovereign 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 NamePrimary AuthorityPublic Spot Sample (Free Tier)Enterprise Unlock (Bearer <API_KEY>)
brazil_fuel_pricesANP / SEFAZ NFC-eTop 3 audited stations + state averages (Gasoline, Ethanol, Diesel S10, CNG)Full 4,750+ stations across 417+ cities + Weekly Historical Time-Series
brazil_grocery_basketSEFAZ NFC-e / SupermarketsSpot regional basket total & top supermarket chains (13 essential items)Store-by-store SKU breakdown + Daily Historical Inflation Time-Series
brazil_cost_of_livingMacroeconomic / DieeseSingle-state combined monthly food + fuel + transport index in BRL/USDMulti-city longitudinal purchasing-power parity (PPP) & Historical Trends
brazil_lpg_gas_pricesANP Open DataTop 2 authorized 13kg LPG cooking gas resellers + state average/min/maxAll 13,145+ resellers with neighborhood delivery spread + Historical Series
brazil_pharma_medicinesCMED / ANVISA / SUSUp to 3 matching presentations with Factory Price (PF), PMC, and Farmácia PopularFull 26,635+ ANVISA catalog + Multi-Lab Generic vs. Reference Comparison & History
brazil_list_statesDiscovery MetadataAll 27 Brazilian UF codes, station coverage counts, ICMS tax rates, timestampsFull municipality slug directory & real-time webhook sync metadata
brazil_purchasing_power_oracleDIEESE / BACEN / IBGE / ANEELMinimum wage labor-hours required to purchase monthly 13-item grocery basket, 13kg LPG, fuel & 150 kWh electricityReal purchasing power parity (PPP) by state & Historical Labor-Hours Trend
brazil_energy_tariffsANEEL / ANPHomologated residential B1 electricity rates across all 27 UFs + Thermal cooking parity (GLP vs induction)Distribution network cost-breakdown & Seasonal Tariff Flags (Bandeiras Tarifárias)
brazil_freight_logisticsANTT / ANPRoad freight cost floor per distance/axle + Diesel S10 consumption and transport cost per kg of foodFleet dispatch optimization & Bulk Grain Highway Corridor Freight Curves
brazil_tax_anatomyCONFAZ / EC 132Constitutional tax decomposition (ICMS Monofásico vs. Net Product) across all 27 UFsState-by-state fiscal anatomy & Tax Reform IBS/CBS Dual-Rate Transition Analysis
brazil_compare_regionsCross-State SynthesisSide-by-side fuel & grocery differential + 70% ethanol/gasoline parity ratioMulti-Sector Cross-State Comparison (including Pharma ICMS 18% vs 20% & LPG)
brazil_contract_intent_a2aLinux Foundation A2A ProtocolM2M Economic Intent Protocol with SHA-256 seal & 24h price lockMulti-Agent Machine Liquidation & Regulatory Escrow Settlement

💼 Commercial Licensing & Pricing Tiers

TierThroughput & CoverageHistorical Time-Series & BulkMonthly Investment
1. Community / EvaluationCurated sample (max 3 items/call, 10 calls/window) with mandatory source attributionSpot (T+0) onlyFree (US$ 0)
2. Commercial AI Agent / StartupUnlimited queries across all 417+ cities + Edge ASN Whitelist (Authorization: Bearer)12-Month Historical Time-Series + Pharma ComparatorUS$ 490 / mo (or R$ 2.450/mês)
3. Enterprise / Global PlatformDedicated high-frequency SLA, custom webhooks, raw bulk feeds & legal indemnityFull 36-Month Historical Time-Series + All 7 VerticalsUS$ 1,950 / mo (or R$ 9.800/mês)

⚡ 1-Click Install via Smithery (Claude Desktop, Cursor, Cline)

Install automatically with a single terminal command:

npx -y @smithery/cli install @mestrepratico/brazil-prices-mcp

Or connect directly via remote HTTP:

⚡ Quick Connect (Claude Desktop, Cursor, Windsurf, Glama)

{
  "mcpServers": {
    "mestrepratico-brazil": {
      "type": "http",
      "url": "https://mestrepratico.com.br/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_ENTERPRISE_API_KEY_OPTIONAL"
      }
    }
  }
}

🛡️ Security & Intellectual Property Governance

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.

↑↓ navigate openesc close