How to Use the CVM Dados Abertos MCP in Vercel AI SDK

Q: How can my Vercel AI SDK app search for company information on CVM Dados Abertos?

Your agent can use the searchdatasets tool. Just pass it a text query with the company's name, and it will return a list of matching datasets from the CVM portal.

Q: Can I list all available datasets from CVM Dados Abertos with the Vercel AI SDK?

Yes, you can. The listdatasets tool returns all datasets available on the portal. You can also use listgroups to see how they are categorized.

Q: What's the best way to get metadata for a specific dataset from CVM Dados Abertos in my Vercel AI SDK app?

Once you have a dataset ID, use the getdataset tool. It provides all the metadata, including a description and information about its resources.

Stream Brazilian market data live into your Vercel AI SDK app. Your UI updates as the data arrives.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CVM Dados Abertos MCP to Vercel AI SDK

Create your Vinkius account to connect CVM Dados Abertos to Vercel AI SDK 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 CVM Dados Abertos with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Market Data Search

This MCP Server gives your agent the `search_datasets` tool. Your users can ask for financial data in plain English, and your Next.js or React app will show results as they stream in from the CVM portal. Forget loading spinners. Your UI components populate in real-time. This means a user can ask to find ESG investment funds and then watch the list build itself on the screen. It creates a much more interactive and responsive experience than a typical API call.

Explore CVM's Data Catalog with the Vercel AI SDK

Let your users browse the entire Brazilian capital markets data catalog. With the `list_datasets`, `list_groups`, and `list_organizations` tools, your agent can build a dynamic data explorer on the fly. You don't need to hardcode any categories or endpoints. Your agent can ask "what investment fund data is available?" and get back a structured list of groups like "Fundos de Investimento". It's a straightforward way to give your app discovery features without maintaining a separate index of the CVM portal.

Get Full Context on Any Dataset

This MCP connection isn't just a search tool. Once your agent finds a relevant dataset using `search_datasets`, it can use `get_dataset` and `get_resource` to pull the complete metadata. This includes documentation, column descriptions, and update frequency. Your Vercel AI SDK app can then display this information right in the UI. It gives your users everything they need to understand the data they're looking at, streamed directly into the browser. It closes the loop from discovery to understanding.

Setup guide

Set up CVM Dados Abertos MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all CVM Dados Abertos tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent CVM Dados Abertos transactions",
});

console.log(text);
await mcpClient.close();

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 CVM 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 CVM 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 CVM Dados Abertos MCP in Vercel AI SDK

Your agent can use the `search_datasets` tool. Just pass it a text query with the company's name, and it will return a list of matching datasets from the CVM portal.

Yes, you can. The `list_datasets` tool returns all datasets available on the portal. You can also use `list_groups` to see how they are categorized.

Once you have a dataset ID, use the `get_dataset` tool. It provides all the metadata, including a description and information about its resources.

You get access to public data from Brazil's CVM Open Data portal. This includes information on investment funds, publicly traded companies, and various financial reports.

This server only interacts with public Brazilian capital markets data. Your connection is secured, and every request runs in a private, ephemeral Vinkius sandbox. Nothing from your session is stored or shared.

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