How to Use the Focus Logística MCP in LlamaIndex

Q: How does LlamaIndex index data from Focus Logística?

Your LlamaIndex agent calls downloadxml to fetch the raw Focus Logística XML payload. It then parses the nodes and indexes the structured tax data into your LlamaIndex vector store, making it searchable via natural language.

Q: Can I use LlamaIndex to check active manifests on Focus Logística?

Yes, your LlamaIndex agent uses consultmdfe to retrieve the current state of any Focus Logística manifest. It inserts this real-time status into the LlamaIndex query context to answer user questions with absolute accuracy.

Q: How do I handle emission failures in Focus Logística with LlamaIndex?

When emitcte fails, the tool returns the specific Focus Logística validation error. Your LlamaIndex agent reads this error, matches it against your indexed tax rules, and suggests the exact correction needed.

Q: Can I limit which Focus Logística tools the LlamaIndex agent can access?

Yes, use the allowedtools filter during LlamaIndex setup to restrict access to Focus Logística. You can grant access to status checks like consultcte while blocking destructive actions like cancelcte.

Index Focus Logística XMLs into LlamaIndex vector stores to query live CT-e and MDF-e statuses with zero hallucinations.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Focus Logística MCP to LlamaIndex

Create your Vinkius account to connect Focus Logística to LlamaIndex and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Focus Logística with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query Live Freight Status with LlamaIndex RAG

The `consult_cte` and `consult_mdfe` tools feed live Brazilian tax document statuses directly into your LlamaIndex query engine. Your LlamaIndex agent runs real-time checks against Focus Logística instead of relying on outdated local databases. The retrieved Focus Logística status maps directly to your LlamaIndex vector index. This guarantees that your LlamaIndex retrieval-augmented generation apps answer shipping queries using actual, live government data.

Index XML Tax Payloads for Semantic Search

The `download_xml` tool downloads the official government-signed XML files for any CT-e or MDF-e into your LlamaIndex pipeline. Your LlamaIndex pipeline parses these Focus Logística files and indexes them into your vector database automatically. LlamaIndex users can run natural language queries over complex Focus Logística tax documents. They get answers grounded in the actual Focus Logística XML structure without writing custom SQL queries.

Execute Document Actions via MCP Server Tools

The `emit_cte` and `emit_mdfe` tools allow your LlamaIndex function agents to generate Focus Logística tax documents during conversational interactions. When a LlamaIndex agent identifies a complete shipping order in your index, it calls the emission tool. This MCP integration turns your LlamaIndex search index into an active execution engine. Your LlamaIndex agent goes from answering questions about logistics to issuing the actual Focus Logística transport manifests.

Setup guide

Set up Focus Logística MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all Focus Logística MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to Focus Logística tools.",
)
response = await agent.run("List recent Focus Logística data")

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Focus NFe. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Focus Logística now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Focus Logística MCP in LlamaIndex

Your LlamaIndex agent calls `download_xml` to fetch the raw Focus Logística XML payload. It then parses the nodes and indexes the structured tax data into your LlamaIndex vector store, making it searchable via natural language.

Yes, your LlamaIndex agent uses `consult_mdfe` to retrieve the current state of any Focus Logística manifest. It inserts this real-time status into the LlamaIndex query context to answer user questions with absolute accuracy.

When `emit_cte` fails, the tool returns the specific Focus Logística validation error. Your LlamaIndex agent reads this error, matches it against your indexed tax rules, and suggests the exact correction needed.

Yes, use the `allowed_tools` filter during LlamaIndex setup to restrict access to Focus Logística. You can grant access to status checks like `consult_cte` while blocking destructive actions like `cancel_cte`.

It doesn't store them. This MCP Server runs in an ephemeral, zero-trust sandbox where your CT-e and MDF-e tax data are processed entirely in memory during LlamaIndex query executions.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript