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 分