# STF Dados Abertos MCP for AI Agents AI Agent Connect > STF Dados Abertos MCP gives your AI agent direct access to the Brazilian Supreme Federal Court's open data portal. Instead of clicking through endless government pages, you can ask your agent to find specific datasets, pull metadata, or run queries on official transparency records like court decisions and personnel costs. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_AC7RGbZPStvfzluvZP0epIDDD0fpQpJMogqCxxpe/ai-agent-connect - **Tags:** brazil-law, legal-transparency, stf, open-data, judicial-data ## Description Getting your hands on official Brazilian judicial data usually means navigating a maze of government portals and manually filtering through massive CSV files. This Connector changes that by letting your AI agent do the heavy lifting for you. You can ask it to find specific datasets about court spending, look up the organizations responsible for maintaining certain records, or pull out specific details from a data package without ever leaving your chat window. If you're looking for a way to pull high-quality transparency data into your own projects, Vinkius makes it easy to get this connected. You just point your agent at the STF portal, and suddenly you have a conversational interface for one of the country's most important open data sources. It's perfect for when you need to move fast and don't want to spend your afternoon copy-pasting from a web browser. Instead of wrestling with broken links or confusing navigation, you can just tell your agent what you want to know. It handles the queries, pulls the metadata, and brings the information directly to you. It's a massive time saver for anyone who needs to stay on top of Brazilian court transparency without the headache of manual data collection. ## Tools ### get_package Fetch specific details for a dataset. Use this to see what's included in a particular data package. ### list_packages List all available datasets in the STF Dados Abertos portal. This is the starting point for finding any specific data you need. ### search_packages Search for datasets using keywords. Use this to find specific topics like court spending or personnel costs. ### get_group Get details about a specific group of court data. This helps you understand how the court categorizes its information. ### get_organization Pull details on the specific organizations that manage court data. This lets you see who is responsible for different datasets. ### get_resource Get the metadata for a specific file or data link. This tells you the structure of a specific resource within a larger dataset. ### list_groups List all the different groups available in the STF portal. Use this to get a high-level view of the data categories. ### list_organizations List all the organizations that maintain open data. This helps you map out the court's internal data structure. ### search_datastore Query the DataStore for specific information. This lets you pull specific records without downloading huge files. ## Prompt Examples **Prompt:** ``` List all available datasets in the STF Dados Abertos portal. ``` **Response:** ``` I've retrieved the list of datasets. Notable packages include **Processos Eletrônicos**, **Gastos com Pessoal**, and **Decisões**. Which one would you like to explore further? ``` **Prompt:** ``` Search for datasets related to 'votações'. ``` **Response:** ``` Searching... I found 3 datasets matching 'votações'. The most relevant is **Votações em Plenário**. Would you like to see the available resources for this package? ``` **Prompt:** ``` Get the details and resources for the dataset 'folha-de-pagamento'. ``` **Response:** ``` Fetching details for 'folha-de-pagamento'... This dataset contains **12 resources** (CSV and JSON formats) and is maintained by the **Secretaria de Gestão Estratégica**. Do you want to inspect a specific resource ID? ``` ## Capabilities ### Find specific datasets Ask your agent to locate specific records like court spending or personnel costs. ### Pull metadata for data links Get details on file formats and links without leaving your chat. ### Run SQL-like queries on records Extract specific data points from large datasets without downloading the whole file. ### Browse court organizations Identify which court departments are responsible for specific data types. ### Inspect update frequencies Check how often a dataset is updated to ensure your information is current. ## Use Cases ### Finding court spending records A journalist needs to find all court spending records for a report. They ask the agent to find 'votações' data, and it uses search_packages to find the correct dataset immediately. ### Building a payroll dashboard A developer is building a dashboard for court personnel costs. They use search_datastore to pull specific payroll records without having to download and clean massive files. ### Analyzing judicial decisions A legal researcher wants to see all datasets related to judicial decisions. They use list_groups to see how the court categorizes information and find the right topics quickly. ### Verifying data provenance An analyst needs to verify which court department maintains a specific set of records. They use list_organizations and get_organization to confirm the data source and owner. ## Benefits - Skip the manual portal navigation by using list_packages to see everything at once. This saves you from clicking through endless menus to find the right data. - Pull specific data points instantly with search_datastore instead of downloading massive CSVs. This lets you grab only the rows you need for your analysis. - Identify data owners quickly using list_organizations to know exactly where your data comes from. This is crucial for verifying the source of court records. - Understand data structure before you start by using get_resource to check file formats and links. This prevents you from trying to open incompatible files. - Keep your research current by using get_package to check the latest update frequencies and metadata. You can stay on top of the most recent court data. ## How It Works The bottom line is you get a direct line to official Brazilian court transparency data without the manual browsing. 1. Subscribe to this Connector in the Vinkius catalog. 2. Add your STF API key to your configuration if you need higher access limits. 3. Ask your agent to find Brazilian court data or specific datasets. ## Frequently Asked Questions **Can I use STF Dados Abertos to find Brazilian court spending?** Yes, you can ask your agent to search for specific spending datasets or query the DataStore for records. **Does the STF Dados Abertos MCP support searching for court decisions?** Yes, it allows you to search for packages related to judicial decisions and list the available resources. **How can I get specific payroll data from the STF?** You can ask your agent to search for the 'folha-de-pagamento' package and then query the DataStore for specific records. **Can I see which organization manages the open data?** Yes, the Connector lets you list and get details for all organizations that maintain the court's transparency data. **Is this Connector good for legal researchers?** It is specifically built for researchers who need to find and analyze official court datasets without manual portal navigation. **Does it help with data provenance?** Yes, it provides access to metadata for packages and organizations so you can see the update frequency and source of the data. **Can I perform SQL-like queries on the court's data files?** Yes! If a resource is integrated into the DataStore, you can use the `search_datastore` tool with the Resource ID to query the data within the file directly. **How do I find datasets related to a specific legal topic?** Use the `search_packages` tool. Simply provide a search term (e.g., 'processos' or 'votação') and the agent will return all matching datasets from the portal. **Is it possible to list all organizations that publish data on the STF portal?** Absolutely. Use the `list_organizations` tool to see all departments and entities, or `get_organization` to see details and datasets owned by a specific one.