# ANP Resellers MCP

> ANP Resellers MCP accesses official Brazilian data on fuel and LPG distributors. Query for authorized gas stations and cooking gas providers using specific location filters or a CNPJ number, all through your agent.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** anp, brazil, fuel-resellers, lpg-data, energy-sector

## Description

This connector lets you query the ANP database to find verified information on energy resellers across Brazil. You can ask natural language questions like, 'Which gas stations are in São Paulo that service diesel?' The system handles the complex filtering against official records for both automotive fuels and cooking gas providers. It's a direct link to regulatory data, so what you get back is authoritative. When you connect this MCP via Vinkius, your AI client routes all location and verification queries through one single source of truth, letting you map out regional coverage without leaving the chat window.

## Tools

### list_combustivel_resellers
Lists authorized automotive fuel resellers using filters for CNPJ, state (UF), and municipality.

### list_glp_resellers
Lists authorized LPG (cooking gas) distributors using filters for CNPJ, state (UF), and municipality.

## Prompt Examples

**Prompt:** 
```
List all automotive fuel resellers in the city of 'São Paulo', SP.
```

**Response:** 
```
I've retrieved the list of authorized fuel resellers in São Paulo (SP). There are multiple entries; would you like to see the first page of results or filter by a specific CNPJ?
```

**Prompt:** 
```
Find LPG (cooking gas) resellers in the state of Rio de Janeiro (RJ).
```

**Response:** 
```
Searching for GLP resellers in RJ... I found several authorized distributors. You can further narrow this down by municipality if needed.
```

**Prompt:** 
```
Check the status of the reseller with CNPJ 00000000000191.
```

**Response:** 
```
Querying ANP for CNPJ 00000000000191... I have found the registration details. The reseller is currently listed as authorized for automotive fuel sales.
```

## Capabilities

### Locate Automotive Fuel Stations
Find gas stations based on state, municipality, or a specific provider's CNPJ.

### Map Cooking Gas Distributors
Identify authorized LPG (cooking gas) distributors nationwide using location filters.

### Verify Provider Credentials
Check the current registration status of a fuel or gas reseller against official government records.

## Use Cases

### Determining Market Penetration
A market analyst needs to know how many authorized fuel providers exist across Paraná (PR). They ask their agent to list all automotive fuel resellers in PR, receiving a filtered list instantly for competitive analysis.

### Route Safety Verification
A fleet manager is planning a long-haul route and needs to confirm that every planned stop has an authorized LPG distributor. They run the agent with location filters to find all necessary GLP resellers, eliminating guesswork.

### Auditing Specific Vendors
A compliance officer receives a suspicious vendor ID (CNPJ). They query the MCP to check the reseller's status using `list_combustivel_resellers`, instantly confirming if the provider is still legally authorized for fuel sales.

## Benefits

- Compliance checks are instant. Instead of navigating complex government sites, you simply ask to verify a provider's status, ensuring the reseller is legal and active for automotive fuels.
- Comprehensive coverage mapping. You can easily list all resellers within an entire state or city by using filters that apply to both fuel types, giving you immediate insight into regional density.
- Saves time on cross-checking data. Because this MCP handles two distinct categories—automotive fuel and LPG—in one place, your agent doesn't need multiple API calls.
- Data accuracy is built in. You pull information straight from the ANP database, meaning you're working with official government records for compliance purposes.
- Use specific filters to narrow down results. Whether you only care about a single CNPJ or want all listings in a municipality, the filtering options keep your data clean and precise.

## How It Works

The bottom line is, you get real-time, filtered data on Brazil's energy supply chain directly in your agent's response.

1. Subscribe to this MCP and provide your ANP API Access Key (if required).
2. Ask your agent to search for providers, specifying the type of fuel or gas needed.
3. The system returns a structured list of authorized resellers that match all criteria you provided.

## Frequently Asked Questions

**How do I check if a provider is authorized for gas using list_glp_resellers?**
You can find out by running a query with the necessary location filters or providing the specific CNPJ. This tool checks against official records to confirm their status as an LPG distributor.

**Can I use list_combustivel_resellers for general fuel info?**
Yes, this tool focuses on automotive fuels. You can filter by state or municipality to see all authorized gas stations and diesel providers in that area.

**What if the provider offers both services? Which tool do I use?**
You don't have to choose. Your agent can query for both types of resellers, using `list_combustivel_resellers` and `list_glp_resellers`, to get a combined picture.

**Does the ANP Resellers MCP use real-time data?**
Yes. The MCP connects directly to the official regulatory source, ensuring you're working with current information on authorized resellers and their status.

**When using `list_combustivel_resellers`, what criteria can I use to narrow down my search?**
You can filter results by CNPJ, state (UF), or municipality. These filters let you pinpoint exact locations or regional groups of fuel providers quickly.

**If I have a specific CNPJ, how do I check if it is authorized for both LPG and automotive fuel?**
You need to run both `list_combustivel_resellers` and `list_glp_resellers` separately using the same CNPJ. This confirms its status in each distinct category.

**Is an ANP API Access Key required before I can use any of these MCP tools?**
Yes, you must provide your specific ANP API Access Key when setting up the connection to the MCP. This key authorizes your agent to query the official database.

**What kind of data does `list_glp_resellers` return regarding a distributor's status?**
The tool returns detailed registration information, confirming whether the entity is currently recognized and authorized by ANP. This verifies their legal standing nationwide.

**Can I search for a specific gas station using its CNPJ?**
Yes! Use the `list_combustivel_resellers` tool and provide the `cnpj` parameter. The agent will return the registration details and authorization status for that specific tax ID.

**How do I list all cooking gas resellers in a specific city?**
Use the `list_glp_resellers` tool and specify the `municipio` and `uf` (state abbreviation). This will return a list of all authorized LPG providers in that location.

**Does the tool support pagination for large result sets?**
Yes. Both `list_combustivel_resellers` and `list_glp_resellers` include a `numeropagina` parameter, allowing you to navigate through multiple pages of data.