# Preço do Gás AI Agent Connect

> Preço do Gás MCP gives your AI agent direct access to Brazil's largest network of gas resellers. You can pull live price snapshots, check if a specific CEP has delivery coverage, track existing orders via phone number, and browse the latest industry news. It handles all the geocoding and backend authentication so your agent just gets the data it needs to answer consumer questions.

## Overview
- **Category:** energy-utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_wKJ39F8E0zMnAnzjudLfRVWdwWYtJW6bLcCkvoku/ai-agent-connect
- **Tags:** gas, cooking-gas, glp, brazil, preco-do-gas, gas-price-lookup, delivery, resellers

## Description

You can now give your AI agent the ability to navigate the Brazilian cooking gas market. This MCP connects to the Preço do Gás network, which links consumers to major brands like Ultragaz and Supergasbrás. Instead of you manually searching websites, your agent can query specific addresses or postal codes to find the cheapest, fastest, or highest-rated gas delivery options available right now. 

Because gas prices in Brazil fluctuate based on your neighborhood, the specific product (like 13kg cylinders or 45kg commercial tanks), and active local campaigns, this MCP provides timestamped snapshots. Every response includes a pt-BR summary designed for your agent to read or relay directly to a user. It also includes market statistics like average prices and how many resellers are currently open in a given area. Whether you are checking if a specific CEP is in a delivery zone or tracking a recent order, the data is pulled directly from the official reseller index.

## Tools

### list_gas_products
This tool lists all available gas products in the reseller catalog, such as 13kg cooking gas and 20kg water refills. It provides the specific product codes needed for price searches.

### list_gas_news
This tool pulls the latest articles from the Preço do Gás blog. You can filter by categories like Vale Gás, safety, or delivery regions.

### lookup_cep
This tool checks if a specific Brazilian postal code is within the reseller delivery network. It uses the official provider index to confirm coverage.

### search_gas_prices
This tool compares gas prices for a specific Brazilian address or CEP. It returns a live snapshot including prices, delivery windows, ratings, and a pt-BR summary.

### track_gas_order
This tool checks the status of a gas order using a registered Brazilian phone number. It returns a status summary and a link to the order details.

## Prompt Examples

**Prompt:** 
```
How much does a 13kg cooking gas cost near Rua Augusta 500, São Paulo - SP?
```

**Response:** 
```
The cheapest reseller delivering to Rua Augusta 500 offers Gás de Cozinha 13kg at R$ 116.90 (Supergasbrás, delivery in 60-90 min, open now). 3 more options are available from R$ 117.99. Snapshot taken 14:32.
```

**Prompt:** 
```
Find the fastest gas delivery at CEP 30110-000 (Belo Horizonte) and show the top rated resellers.
```

**Response:** 
```
For CEP 30110-000 the fastest option is a reseller delivering in 10-40 minutes; sorted by rating, Servgás (4.7) and Ultragaz (4.7) lead.
```

**Prompt:** 
```
Track my gas order placed with phone 11987654321.
```

**Response:** 
```
An order is registered for 11987654321. You can open its details at the returned order link.
```

## Capabilities

### Real-time Price Comparison
Your agent compares prices, delivery times, and ratings from multiple resellers at once.

### Automated Geocoding
The MCP converts text addresses into coordinates to find the correct delivery zone automatically.

### Delivery Coverage Verification
Your agent can confirm if a specific CEP is serviced by the reseller network.

### Order Tracking
The agent can check the status of a gas delivery using only a phone number.

### Market Intelligence
Your agent accesses price statistics like minimum, maximum, and average local prices.

## Use Cases

### Household Management
An agent finds the cheapest 13kg gas cylinder for a specific home address.

### Business Logistics
A commercial user checks prices for 45kg or 20kg cylinders for their business.

### Order Support
A support agent tracks a customer's gas delivery status using their phone number.

### Regional Monitoring
An agent monitors the official blog for news regarding Vale Gás or new delivery regions.

## Benefits

- Eliminates manual searching by pulling data from Brazil's largest gas network.
- Provides ready-to-use pt-BR summaries for direct communication with users.
- Handles all authentication and geocoding internally without user intervention.
- Delivers timestamped data to ensure price accuracy in a volatile market.

## How It Works

Connecting to this MCP gives your agent immediate access to the Preço do Gás API.

1. Connect your MCP-compatible client to Vinkius.
2. Provide an address or CEP to your agent.
3. The MCP geocodes the location and queries the reseller network.
4. Your agent receives a structured response with prices, ratings, and a pt-BR summary.

## Frequently Asked Questions

**How do I check the gas price near my address?**
Use `search_gas_prices` with your address, e.g. "Avenida Paulista 1000, São Paulo - SP". The tool geocodes the address itself (no coordinates needed) and returns resellers sorted by lowest price by default, with highlights for the cheapest, fastest and top-rated options. The response includes a ready-to-read `answer` summary plus `priceStats` (min/max/average and how many resellers are open now).

**Do I need an API key or credentials?**
No. The reseller API authenticates with a public JWT served by the site's own /jwt.php endpoint, refreshed automatically on each call. Geocoding uses free, keyless providers with failback (Nominatim → ArcGIS → bare CEP).

**Are the prices fixed?**
No — gas prices vary by neighbourhood, brand, product, payment method and active campaigns, and change over time. Each `search_gas_prices` call returns a timestamped snapshot with a note about that variability.

**Can I track an order I placed through the app?**
Yes. `track_gas_order` accepts the Brazilian phone number (DDD + number) used to place the order and reports whether it is registered, with the detail-page link when it is.

**Does a CEP have gas delivery coverage?**
Use `lookup_cep` with the postal code. It answers from the provider's own address index (the coordinates used to define delivery areas), returning street, neighbourhood, city and UF. If found, running `search_gas_prices` on that CEP shows the live resellers that serve it.
