Mestre Prático • Brazil Retail & Commodities MCP

io.github.arthursantosmedia-stack由 GitHub 帳號 arthursantosmedia-stack 發布v1.8.0更新於 Oct 25, 2026

Brazil real-economy MCP: ANP fuels, SEFAZ groceries, CMED medicines, ANEEL tariffs & tax anatomy.

已驗證Streamable HTTP可網頁執行金融資料與分析商業與電商

概覽

AI 產生的概覽

面向巴西零售與大宗商品價格的遠端 MCP 伺服器:涵蓋 27 個州的燃油、液化瓦斯、食品籃、藥品、電價、運費與稅費。

可以做什麼
  • 依州與城市查詢經稽核的燃油、13 公斤液化瓦斯桶與基本食品籃價格
  • 查詢受管制藥品的最高消費價與藥局給付範圍
  • 取得住宅電價,並比較瓦斯與電磁爐的烹調成本
  • 計算最低工資所需工時、家庭生活成本與公路運費下限
  • 拆解消費稅結構,並比較各州之間的價差
  • 簽發機器對機器的採購意圖紀錄
適用情境
適合需要巴西即時消費價格、地區成本比較或稅費與運費資料的情境,例如家庭預算、採購、物流或市場分析。它針對巴西本地問題,不適用於其他地區的一般價格查詢。
執行需求
遠端 streamable HTTP 端點,不需本機安裝或套件。免費社群層不需驗證但有速率限制;企業 API 金鑰透過 Authorization Bearer 標頭提供,可解鎖更完整的資料集與更高額度,另有按次計費層級。
安裝前請注意
免費層每次查詢只回傳少量樣本(少數加油站、經銷商或藥品),完整歷史與批次資料需付費企業金鑰。更高吞吐量按請求計費,透過 HTTP 402 微支付或 Pix 結算,自動化代理可能因此產生費用。採購意圖工具會產生與結算相關的簽章紀錄。請求會送往第三方巴西服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mestre Prático • Brazil Retail & Commodities MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.arthursantosmedia-stack%2Fmestrepratico-brazil-prices-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mestre-pr-tico-brazil-retail-commodities": {
      "type": "http",
      "url": "https://mestrepratico.com.br/mcp/v1"
    }
  }
}

README

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

🌐 NLWeb Protocol (Natural Language Web)

In addition to JSON-RPC 2.0 MCP, this server natively implements the NLWeb Protocol (Standardized by Microsoft / Schema.org consortium):

[MCP Protocol] [Anthropic MCP Registry] [Glama Grade A] [small print on record] [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: [email protected] | 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

💰 Pricing & Autonomous Micropayments Architecture (x402 Protocol)

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:

TierRate Limit & AccessPricingSettlement ProtocolFeatures & Scope
🌱 Community & Open Grounding60 req/min (Zero-Auth / Anonymous)Free (R$ 0,00)None requiredAll 12 canonical brazil_* MCP tools, spot audited data (ANP, CMED, SEFAZ, ANEEL, ANTT, CONFAZ), prompts & resources.
⚡ Sovereign High-Throughput RAG2,400 req/min (Dedicated Edge Capacity)R$ 5,00 / 1.000 reqs (or ~0.001 USDC / call)HTTP 402 / x402 Micropayments or PixHigh-frequency agent swarms, sub-15ms Anycast SLA, municipality-level pump telemetry, raw bulk feeds & cryptographic audit receipts.

🤖 Machine-to-Machine (x402) Header Specification

Autonomous agents exceeding community rate limits or requesting batch feeds can pay per query natively via RFC HTTP 402 without manual human invoicing:

http
GET /mcp/v1 HTTP/1.1Host: mestrepratico.com.brX-Payment: mp_x402_<session_token>

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

Install automatically with a single terminal command:

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

Or connect directly via remote HTTP:

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

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

來源:README.md,提交 f88588d

工具

12

brazil_fuel_prices

Brazil Retail Fuel Prices & Biofuel Parity (ANP)

Queries real-time audited retail fuel prices across all 27 Brazilian Federative Units (UFs) and 417+ 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,939 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.

輸入參數uf必填cidadecombustivel

brazil_grocery_basket

Brazil Basic Food Basket Supermarket Prices (NFC-e / DIEESE)

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 (NFC-e SEFAZ) 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.

輸入參數uf必填cidadeproduto

brazil_purchasing_power_oracle

Brazil Minimum Wage Labor Hours Oracle (CLT 220h)

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.

輸入參數uf必填salario_base

brazil_energy_tariffs

Brazil Residential Electricity Tariffs & Thermal Parity (ANEEL)

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.

輸入參數uf必填consumo_kwhcalcular_paridade_termica

brazil_freight_logistics

Brazil Road Freight Minimum Rates & Logistics Cost (ANTT)

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.

輸入參數uf_origemtipo_cargauf_destinodistancia_km必填numero_eixos

brazil_tax_anatomy

Brazil Consumption Tax Anatomy & ICMS Monofasico (CONFAZ)

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.

輸入參數uf必填categoria

brazil_cost_of_living

Brazil Consolidated Monthly Financial Cost of Living (BRL/USD)

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.

輸入參數uf必填converter_usd

brazil_lpg_gas_prices

Brazil Audited Residential Cooking Gas Prices (ANP 13kg LPG)

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.

輸入參數uf必填cidade

brazil_pharma_medicines

Brazil Regulated Pharmaceutical Prices & Farmacia Popular (CMED/ANVISA)

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

輸入參數ufbusca必填categoria

brazil_list_states

Brazil Federative Units Discovery & State Metadata (27 UFs)

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.

無需輸入參數。

brazil_compare_regions

Brazil Cross-State Price Differential & Route Delta (%) Tool

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.

輸入參數categoriauf_origem必填uf_destino必填

brazil_contract_intent_a2a

Brazil A2A Intent Protocol & Machine Contract Oracle

Issues a cryptographically signed Machine-to-Machine (A2A) Economic Intent Protocol and settlement guarantee. Enables enterprise autonomous agents (fleet management bots, hospital procurement systems, wholesale supply coordinators) to formalize an intention to acquire fuels, basic food baskets, or regulated pharmaceutical supplies. The oracle verifies factual minimum prices against primary audited databases and generates a tamper-proof SHA-256 digital certificate issued by Holding Arthur Luis Vieira dos Santos, valid for 24 hours as an immutable settlement ceiling. When to use: Use when two autonomous agents need to negotiate and seal a formal procurement protocol with verifiable digital signature and settlement bounds. When NOT to use: Do NOT use for simple read-only price checks (use brazil_fuel_prices, brazil_grocery_basket, or brazil_pharma_medicines). Idempotent cryptographic certificate generation.

輸入參數uf必填cidadetipo_operacao必填item_especificovolume_estimadoagente_solicitante_id

版本歷史

2
  1. v1.8.0最新Oct 25, 2026
  2. v1.5.0Oct 22, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分