# Cuiabá Transparency MCP > Cuiabá Transparency MCP lets you query real-time municipal public data directly through your AI client. Need to check city spending, revenue streams, or personnel records? This tool provides access to the full scope of Cuiabá's financial commitments, including expenditures, local tax collection reports, and current public contracts, all without manual scraping. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** municipal-data, fiscal-transparency, public-records, data-query, open-data, administrative-records ## Description This connector links your AI agent directly to the official Cuiabá Transparency Portal. You can talk to it like you're talking to a city accountant; ask about specific fiscal years or department budgets. It pulls together information on everything from local taxes collected (revenue) to commitments made on public works (contracts). Your agent processes this data so you don't have to navigate complex government websites or deal with confusing database exports. If you're working with structured, time-sensitive civic records, connecting via Vinkius makes it easy for your AI client to access the entire catalog of municipal tools in one place. ## Tools ### list_budget Retrieves structured information about the city's overall municipal budget plan. ### list_contracts Lists all active public tenders and existing contracts managed by Cuiabá. ### list_expenses Generates detailed lists of municipal expenditures, showing payments and commitments made. ### list_personnel Provides data on city employees, including their current department and salary information. ### list_revenues Tracks the amount of money collected by the municipality from local taxes and transfers. ## Prompt Examples **Prompt:** ``` List the municipal expenses for Cuiabá in January 2023. ``` **Response:** ``` I've retrieved the expenditure data for January 2023. There are several records including health services and infrastructure maintenance. Would you like to see the top 5 largest payments? ``` **Prompt:** ``` Show me the revenue collection for Cuiabá for the year 2023. ``` **Response:** ``` The revenue data for 2023 shows significant collections from IPTU and ISS, as well as federal transfers. I can break this down by month if you'd like. ``` **Prompt:** ``` Get the list of public servants and their positions in Cuiabá for the current month. ``` **Response:** ``` I'm accessing the personnel records... I've found the list of active servants, including their departments and roles. Would you like to filter by a specific department like Education or Health? ``` ## Capabilities ### Track Spending and Commitments It lists detailed municipal expenditures, tracking everything from initial commitments (empenhos) through final payments. ### Analyze Revenue Sources You can monitor how the city collects money, including specific local taxes and federal fund transfers. ### Audit Public Personnel Data The system pulls records detailing public servants' roles, departments, and salary information. ### Review Official Contracts It provides a list of active municipal tenders and signed contracts for oversight purposes. ### Examine Budget Planning Laws You can query fundamental planning instruments like the LOA, LDO, and PPA to understand budget law changes. ## Use Cases ### Auditing Departmental Overspending A researcher notices that the Education department's spending seems high. They prompt their agent: 'Compare payments in `list_expenses` to the allocated funds from `list_budget` for 2024.' The MCP returns a precise report detailing where the overruns occurred. ### Tracking Local Tax Performance A local politician needs proof of tax collection. They ask: 'Show me revenue from IPTU compared to last year's budget.' Using `list_revenues` and `list_budget` gives them the exact numbers they need for a press conference. ### Investigating Contract Redundancies A journalist suspects multiple departments are paying for the same service. They run `list_contracts` and cross-reference the results with specific payments from `list_expenses` to find duplicate spending records. ### Understanding Labor Costs A data analyst wants to know if personnel costs are outpacing revenue growth. They combine `list_personnel` output with `list_revenues` to build a comprehensive fiscal ratio model. ## Benefits - Instead of manually cross-referencing spending reports and contract lists, you ask your agent to compare `list_expenses` against `list_contracts`. It flags potential overlaps or missed commitments automatically. - You can instantly get salary data and department structures using `list_personnel`, letting you track the cost of city employees without visiting HR portals. - Monitoring budget laws used to require reading dense PDFs. Now, querying with `list_budget` gives you a concise overview of LOA or LDO rules for any fiscal period. - It connects your queries on how much money came in (`list_revenues`) directly with the actual commitments made via `list_expenses`, building a clear picture of financial health. - You can audit the full lifecycle of public funds, from when they are budgeted using `list_budget` to when they are finally paid out through `list_expenses`. ## How It Works The bottom line is: you talk to your agent, it talks to the city database, and you get a direct answer. 1. Subscribe to this MCP and enter your Transparency API Key. 2. Your AI client uses natural language prompts to request specific data (e.g., 'Show expenses for Q1 2023'). 3. The tool executes the necessary query against the municipal records and returns structured, clean data to your chat interface. ## Frequently Asked Questions **How do I use `list_personnel` to find out how much city staff costs?** The MCP provides department, role, and salary details via `list_personnel`. You can then ask your agent to calculate the total labor cost for a specific time period or department. **Can I use `list_contracts` to see if an expense was paid?** No, `list_contracts` only lists the tender and agreement details. You must combine this with `list_expenses` so your agent can check if payments were actually made against that contract. **What is the difference between `list_budget` and `list_revenues`?** `list_budget` shows what the city *planned* to spend or collect. `list_revenues` shows what they *actually* collected from sources like local taxes during a given time. **If I run `list_expenses`, does it include personnel costs?** It lists general expenditures, but for detailed salary and department breakdowns, you need to use the specialized data provided by `list_personnel` tool instead. Use both tools together for a full picture. **If I run `list_contracts` and get an error, what should I check first?** The error usually points to your authentication. First, verify that you entered the correct Transparency API Key in Vinkius. If the key is valid, try phrasing your request differently. **How do I filter by a specific date range when using `list_expenses`?** You must specify the exact fiscal year and time frame in your prompt. For example, asking for 'Q3 2023' will limit results to that period only. **What format does the data from `list_revenues` come back in?** The raw output is structured JSON, which means your AI client can read it immediately. You can then prompt it to summarize or convert the entire dataset into a readable table. **If I try to pull too many records using `list_personnel`, will there be limits?** Yes, rate limiting applies if you query too frequently. If you hit an error, wait a minute before re-attempting the request or break your data pull into several smaller chunks. **Can I filter expenses by a specific month and year?** Yes. You can use the `list_expenses` tool and provide the `exercicio` (year) and `mes` (month) parameters to get precise data for that period. **Is it possible to see the salaries of public servants in Cuiabá?** Yes, the `list_personnel` tool retrieves data on public servants, including their positions and remuneration details as provided by the transparency portal. **How can I check active municipal contracts?** Use the `list_contracts` tool. It allows you to query public tenders, bids, and active contracts for a specific fiscal year.