How to Use the Acre Dados Abertos MCP in Mastra AI

Q: How do I register the Acre Dados Abertos tools in my Mastra AI agent?

Create a new MCPClient pointing to the Vinkius URL. You can register the tools from this MCP Server directly by calling mcpClient.listTools() and spreading those tools into your Mastra agent definition.

Q: Can I use Mastra AI workflows to schedule regular Acre Dados Abertos updates?

Yes. You can design a Mastra workflow that runs listpackages daily, compares the output to your local database, and alerts you when new public datasets are published.

Q: Can I require manual approval before downloading large resources?

Yes. Use Mastra's requireToolApproval middleware on the getresource tool. The agent will halt and wait for human confirmation before fetching the file metadata.

Build automated workflows around Acre state public data using Mastra AI agents with built-in retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Acre Dados Abertos MCP to Mastra AI

Create your Vinkius account to connect Acre Dados Abertos to Mastra AI 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 Acre Dados Abertos with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient workflows with Mastra AI

The `list_packages` tool pulls the complete list of datasets from the Acre portal to fuel your automated Mastra workflows. If the state registry experiences temporary downtime, Mastra's built-in exponential backoff retries the request automatically. You instantiate the MCP Server connection using `new MCPClient` and spread the tools directly into your agent's toolset. This allows your background tasks to monitor updates without manual intervention or custom error-handling code.

Run approved datastore searches inside your agents

The `search_datastore` tool queries tabular records within Acre's public databases based on Mastra's conditional branching logic. You can configure the agent to pause and request human approval via `requireToolApproval` before executing large queries that consume token quotas. Once approved, the agent filters the records and passes them to downstream workflow steps. This ensures your automated data pipelines only process validated, high-value public records.

Route Acre data using this MCP Server

The `list_groups` tool retrieves the thematic classifications of Acre's open data to direct your agent's search path. Your workflow can branch based on whether a dataset belongs to environmental, financial, or educational groups. The agent then uses `get_group` to fetch details and retrieve corresponding datasets. Mastra handles the transport over SSE or Streamable HTTP automatically, requiring zero transport configuration from you.

Setup guide

Set up Acre Dados Abertos MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Acre Dados Abertos tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "acre-dados-abertos-mcp-client",
  servers: {
    "acre-dados-abertos-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Acre Dados Abertos Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Acre Dados Abertos tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Acre Dados Abertos transactions"
);
console.log(result.text);

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 Acre Dados Abertos. 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 Acre Dados Abertos 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 Acre Dados Abertos MCP in Mastra AI

Create a `new MCPClient` pointing to the Vinkius URL. You can register the tools from this MCP Server directly by calling `mcpClient.listTools()` and spreading those tools into your Mastra agent definition.

Yes. You can design a Mastra workflow that runs `list_packages` daily, compares the output to your local database, and alerts you when new public datasets are published.

Mastra's workflow engine features automatic retries with exponential backoff. If the server or the underlying CKAN API returns a rate limit error, the workflow pauses and retries.

Yes. Use Mastra's `requireToolApproval` middleware on the `get_resource` tool. The agent will halt and wait for human confirmation before fetching the file metadata.

All queries run through an ephemeral, zero-trust MCP sandbox on Vinkius. Only public Brazilian government metadata and open tabular records are processed, secured by your single endpoint token.

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