How to Use the MAPA (Agricultura) MCP in VS Code Copilot

Q: Can VS Code Copilot search MAPA (Agricultura) for specific crop data?

It does. The agent executes searchpackages based on your chat prompt. It returns the exact dataset IDs you need to build your integration.

Give your entire engineering team access to Brazilian agricultural data inside VS Code Copilot with this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MAPA (Agricultura) MCP to VS Code Copilot

Create your Vinkius account to connect MAPA (Agricultura) to VS Code Copilot 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 MAPA (Agricultura) with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query MAPA Data as a Team via MCP Server

Your AI client triggers `search_packages` to find relevant Brazilian agricultural records directly from your editor. When a developer asks about crop yield formats, Copilot hits the live API instead of hallucinating a response. The whole team gets accurate, real-world context for their data pipelines. Drilling down into specific publishers is handled by `list_organizations` and `get_organization`. The agent retrieves the exact department details for any dataset. This ensures your team correctly attributes the government sources in your application.

Validate Data Structures Instantly

The `get_package` tool grabs the full metadata payload through the MCP connection. Copilot reads this payload to understand the exact fields and update frequencies. You can build reliable cron jobs knowing exactly how the upstream data behaves. Getting the resource-level details requires the `get_resource` command. The AI checks the file format and URL before you write the download script. That prevents your team from building integrations for deprecated or unsupported file types.

Explore Official Data Taxonomies

Running `list_groups` pulls the official thematic collections from the government portal. Copilot uses these groups to help you structure your database tables logically. You mirror the official organization without manually copying it. For finer details, `list_tags` retrieves the complete list of searchable keywords. Your agent can use these tags to write validation rules for user inputs. It keeps your internal search features aligned with the official Brazilian terminology.

Setup guide

Set up MAPA (Agricultura) MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the MAPA (Agricultura) MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the MAPA (Agricultura) tools listed. Try asking: "List my recent MAPA (Agricultura) transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "mapa-agricultura-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 MAPA (Agricultura). 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 MAPA (Agricultura) 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 MAPA (Agricultura) MCP in VS Code Copilot

Add the server details to a .vscode/mcp.json file in your repository. Commit that file to version control. Anyone who pulls the repo gets immediate access to the tools.

It does. The agent executes search_packages based on your chat prompt. It returns the exact dataset IDs you need to build your integration.

Yes. You need version 1.96 or higher to use the shared configuration files. Older versions do not support the workspace-level tool loading.

Developers stop switching contexts to read external API docs. Copilot pulls the live metadata right into the chat window. You write the parsing logic using the actual data structures the government provides.

The extension only transmits the specific IDs and search terms needed to fetch public datasets. Your proprietary workspace files are never uploaded to the foreign API. Vinkius manages the connection through an ephemeral, zero-trust sandbox that drops all state after the request completes.

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