# OpenDataSUS MCP for AI Agents AI Agent Connect > OpenDataSUS MCP provides direct access to Brazilian public health data from the official SUS portal. Query datasets, search for health statistics like vaccination rates, and retrieve actual data rows for analysis. Use it to get official government health figures without manual downloads. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_AxmrIza6jx25PWTY1Wlnh6yuV66T01DCPqgcU7ua/ai-agent-connect - **Tags:** public-health, brazil-health, dataset-discovery, health-statistics, open-data, ckan ## Description OpenDataSUS lets you pull official Brazilian public health information into your workflow without the headache of manual portal navigation. Instead of hunting through dozens of pages or downloading massive CSV files just to see a few rows of data, you can just ask your AI client to find what you need. It connects directly to the Ministry of Health's CKAN-based API, which means your agent can browse datasets, filter by specific health topics like vaccination rates or COVID-19 stats, and pull actual records into your conversation. It handles the heavy lifting of navigating the official SUS portal so you can focus on the actual analysis. You'll find this Connector listed in the Vinkius catalog, where it sits alongside other data-heavy connectors designed to bridge the gap between siloed government databases and your daily projects. It's built for people who need accuracy and official provenance without the friction of old-school data gathering. You can move from a general question about health trends to a specific query of raw data rows in seconds. It removes the need to keep multiple tabs open or copy-paste data into spreadsheets just to get a sense of the numbers. ## Tools ### package_search Search for datasets matching specific criteria. Find specific health topics quickly using keywords. ### organization_list List the different data providers. This helps you find records from specific government departments. ### datastore_search Search and filter rows within a specific resource. This lets you pull actual data points into your chat. ### group_list List all categories available on the portal. Use this to see how the data is organized. ### package_list List all dataset names in the OpenDataSUS portal. Use this to see what's available at a glance. ### package_show Get full metadata for a specific dataset. Use this to understand the structure and source of a package. ### resource_show Get metadata for a specific resource. This shows you the details of individual files like CSVs. ### tag_list List all tags used across the portal. See how different health topics are categorized. ## Prompt Examples **Prompt:** ``` Find datasets about COVID-19 vaccination in Brazil. ``` **Response:** ``` I found several relevant datasets in the OpenDataSUS portal. The most relevant ones are: * **Campanha Nacional de Vacinação contra Covid-19** * **Monitoramento de Vacinação por Município** Would you like to see the specific resources (like CSV or Excel files) for one of these, or should I search for a different topic? ``` **Prompt:** ``` Who are the main organizations providing health data on the portal? ``` **Response:** ``` I've retrieved the list of data providers. Here are some of the primary organizations: | Organization | Focus Area | | :--- | :--- | | **Ministério da Saúde** | National Health Policy | | **Secretaria de Vigilância em Saúde** | Disease Surveillance | | **Fiocruz** | Research & Production | Which of these would you like to explore further? ``` **Prompt:** ``` Show me the first 5 rows of the vaccination resource with ID d3848184-5077-4667-835d-591d67641bb9. ``` **Response:** ``` Accessing the DataStore for that resource... Here are the first 5 records: | Municipio | Data Notificacao | Casos Confirmados | | :--- | :--- | :--- | | São Paulo | 2023-01-01 | 1,204 | | Rio de Janeiro | 2023-01-01 | 850 | | Belo Horizonte | 2023-01-01 | 320 | | Curitiba | 2023-01-01 | 190 | | Salvador | 2023-01-01 | 210 | Would you like me to filter these results by a specific city or date range? ``` ## Capabilities ### Search for specific health datasets Find datasets matching keywords like vaccination or COVID-19 directly through your agent. ### Pull raw data rows into chat Retrieve actual records from CSV and Excel files without downloading them to your machine. ### Browse data providers Identify which government organizations are providing specific health records. ### Inspect dataset metadata Get detailed information about data structure and provenance for any package. ### Filter health statistics by category Use tags and groups to narrow down public health data by specific topics. ## Use Cases ### Analyzing vaccination trends A researcher asks for vaccination rates in a specific region. The agent uses package_search to find the dataset and datastore_search to pull the latest numbers. ### Mapping government health providers A policy analyst needs to know which departments provide data on infectious diseases. The agent uses organization_list to compile a complete list of providers. ### Rapid epidemiological sampling A scientist needs to see a sample of COVID-19 records. The agent uses package_show to find the resource and then pulls the first few rows for immediate review. ### Building health dashboards A developer wants to know what data is available for a new app. The agent uses package_list and tag_list to map out the entire OpenDataSUS catalog. ## Benefits - Stop downloading massive CSV files by using datastore_search to pull only the specific rows you need into your AI client. - Find the right data faster with package_search to skip through hundreds of records manually. - Verify data provenance instantly with package_show to see exactly who provided the health records. - Explore the full scope of available data using group_list and tag_list to understand how the government categorizes health info. - Identify key data providers across different ministries using organization_list to find specific departmental records. - Save hours of manual portal navigation by letting your agent handle the discovery of official SUS datasets. ## How It Works The bottom line is you get direct, queryable access to official Brazilian health data without leaving your AI chat. 1. Connect the OpenDataSUS MCP to your AI client and provide your API key for higher rate limits. 2. Ask your agent to find a specific health topic, like vaccination records or regional health stats. 3. Get a list of relevant datasets or specific data rows returned directly in your conversation. ## Frequently Asked Questions **Can I use OpenDataSUS MCP to get official Brazilian health stats?** Yes. This Connector connects directly to the official Ministry of Health portal, allowing your AI client to find and retrieve government health statistics accurately. **Does OpenDataSUS MCP support querying actual data rows?** Yes, it can. Using the data store tools, your agent can pull specific rows from CSV and Excel resources so you can see the data directly in your chat. **Is OpenDataSUS MCP good for epidemiological research?** It's a great tool for researchers. It allows you to quickly find datasets related to specific diseases, vaccination rates, and regional health trends without manual downloads. **How does OpenDataSUS MCP help with data discovery?** It lets your agent browse all available datasets, tags, and categories on the portal, making it much faster to find the specific information you need. **Can I find which government departments provide the data with OpenDataSUS MCP?** Yes. You can ask your agent to list all organizations, which will show you the different departments and providers available on the portal. **Will OpenDataSUS MCP work with Claude or Cursor?** Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf, giving you the power of official health data in your preferred workspace. **How can I search for specific rows inside a large CSV dataset?** You can use the `datastore_search` tool. Provide the `resource_id` and use the `q` parameter for full-text search or the `filters` parameter to target specific columns. **Can I find which organizations provide the most datasets?** Yes! Use the `organization_list` tool to see all data providers registered in the OpenDataSUS portal. **How do I get the download link for a specific data file?** Use the `resource_show` tool with the Resource UUID. It will return the metadata including the URL where the file is hosted.