# Focus Logística MCP for AI Agents AI Agent Connect

> Focus Logística lets you issue CT-e and MDF-e documents, manage cargo manifests, and download XMLs for Brazilian transport operations directly through your AI agent. It connects to the Focus NFe API to handle freight documentation without you having to jump between different portals.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_jG9IjurhKBZJDMmtctu5hI36vp0WS2KFicXl7EM5/ai-agent-connect
- **Tags:** transport-invoicing, cargo-manifests, fiscal-compliance, brazil-tax, logistics-automation

## Description

Focus Logística lets you manage Brazilian cargo transport documentation directly through your AI agent. You can issue transport invoices and cargo manifests, close manifests, and grab XML files without ever opening a separate portal. Instead of copy-pasting freight details, selecting modalities, and waiting for authorizations, you just tell your agent what to do. It handles the heavy lifting of the logistics platform so you can stay focused on moving freight.

By connecting this through the Vinkius catalog, you turn a tedious manual chore into a background task. You can handle the entire lifecycle of a shipment's paperwork—from the initial invoice to the final manifest closure—using nothing but natural conversation. If you need to check if a document is authorized or if you need to cancel an invoice with a specific justification, your agent does it in seconds.

This is a game changer for high-volume freight operations. Whether you're issuing a transport invoice for a road shipment or grouping multiple documents into a cargo manifest, your agent ensures the data is handled correctly every time. It takes the friction out of Brazilian logistics compliance, allowing you to manage complex transport manifests and retrieve XML files for your accounting team without the usual manual headache. You get to move cargo while your agent handles the paperwork, ensuring your documentation is always accurate and up to date.

## Tools

### consult_cte
View the status and authorization details of a specific CT-e. Get updates without opening a browser.

### consult_mdfe
Check the current status and authorization of an MDF-e. This helps you track cargo progress instantly.

### emit_mdfe
Create a new Manifesto de Carga (MDF-e) to group multiple transport invoices. This simplifies multi-stop routes.

### close_mdfe
Mark an MDF-e as finished or closed after a delivery is complete. Use this to keep your manifests current.

### download_xml
Download the XML for a CT-e or MDF-e for your records or accounting. This keeps your files organized.

### cancel_cte
Cancel a CT-e with the valid justification required by regulations. Use this to correct documentation errors.

### emit_cte
Emit a Conhecimento de Transporte (CT-e) for various transport modalities. This handles your transport invoicing.

## Prompt Examples

**Prompt:** 
```
Emit a CT-e for a freight of R$1,200.00 from SP to RJ.
```

**Response:** 
```
### Transport Invoice Issued

| Document Type | Reference | Status |
| :--- | :--- | :--- |
| **CT-e** | CTE-001 | **Authorized** |

**Details:**
- **Origin:** São Paulo (SP)
- **Destination:** Rio de Janeiro (RJ)
- **Value:** R$ 1,200.00

The transport invoice has been successfully emitted and authorized.
```

**Prompt:** 
```
Close the MDF-e reference MDF-001.
```

**Response:** 
```
### Manifest Updated

**Reference:** MDF-001
**Action:** Finished / Encerrado
**Status:** Successfully closed.

The cargo manifest for MDF-001 has been marked as finished in the system.
```

**Prompt:** 
```
Download the XML for CT-e reference CTE-001.
```

**Response:** 
```
### File Downloaded

- **Document:** CT-e CTE-001
- **File Type:** .xml
- **Status:** Ready for download.

I've retrieved the XML for CT-e CTE-001. You can now access it for your accounting records.
```

## Capabilities

### Issue transport invoices
Generate CT-e documents for road, air, rail, or waterway transport via chat.

### Create cargo manifests
Group multiple transport invoices into a single MDF-e manifest.

### Check authorization status
Get real-time updates on the status of your CT-e and MDF-e documents.

### Mark manifests as finished
Close out cargo manifests as soon as the delivery is confirmed.

### Cancel transport invoices
Cancel existing CT-e documents with the required justifications.

### Retrieve XML files
Download XML files for any CT-e or MDF-e for your accounting records.

## Use Cases

### Issuing a transport invoice for a specific route
A logistics manager asks their agent to issue a CT-e for a R$1,200.00 freight from SP to RJ. The agent uses `emit_cte` and returns the authorization status.

### Grouping multiple invoices into a manifest
A freight company owner needs to group three invoices. They ask their agent to create an MDF-e, and the agent uses `emit_mdfe` to group them.

### Retrieving files for tax compliance
An accountant asks to get all the XMLs for yesterday's shipments. The agent uses `download_xml` to pull the files for the accounting folder.

### Closing out finished deliveries
A dispatcher tells their agent to mark manifest MDF-001 as finished. The agent uses `close_mdfe` to update the status immediately.

## Benefits

- Stop manual data entry by using `emit_cte` to generate transport invoices through a simple chat.
- Group multiple invoices into a single manifest using `emit_mdfe` to save time on complex routes.
- Get instant status updates on your shipments by using `consult_cte` and `consult_mdfe` without opening a browser.
- Automate your end-of-day tasks by using `close_mdfe` to mark deliveries as finished immediately.
- Simplify tax compliance by using `download_xml` to grab all necessary files for your accounting team.
- Reduce errors in documentation by using `cancel_cte` to handle corrections with clear justifications.

## How It Works

The bottom line is you handle the logistics while your agent handles the paperwork.

1. Subscribe to Focus Logística on the Vinkius catalog.
2. Enter your Focus NFe API Token and Base URL in the configuration.
3. Start asking your AI client to issue, cancel, or check transport documents.

## Frequently Asked Questions

**Can Focus Logística help me issue CT-e documents?**
Yes, it handles the issuance of CT-e documents for all transport modalities, including road, air, rail, and waterway.

**Does Focus Logística support MDF-e creation?**
Yes, it can create cargo manifests (MDF-e) to group multiple transport invoices into a single document.

**How do I get my XML files for accounting?**
You can simply ask your agent to download the XML for any specific CT-e or MDF-e, and it will retrieve the file for your records.

**Can I cancel an existing transport invoice?**
Yes, you can use your agent to cancel a CT-e with the required justification directly through this Connector.

**How does this help with Brazilian transport compliance?**
It automates the issuance and status checking of mandatory transport documents like CT-e and MDF-e, reducing the risk of manual errors.

**What transport modalities are supported for CT-e?**
CT-e supports all modalities: road (rodoviário), air (aéreo), rail (ferroviário), waterway (aquaviário), pipeline (dutoviário) and multimodal.

**When should I close an MDF-e?**
You should close the MDF-e after the delivery is completed. Use the close_mdfe action to mark it as finished.

**Can I cancel an authorized CT-e?**
Yes, as long as it hasn't been used for transport yet. Use cancel_cte with a valid justification reason.

**What documents are required to generate an MDF-e?**
You need the related NFe (for own cargo) or CTe (for third-party cargo) references, as well as the vehicle's license plate and the driver's CPF.