mcp-camara

Lists available endpoints for the Brazilian Chamber of Deputies API.

This is the primary discovery tool to understand the API's capabilities. It returns a list of all available operations, including the path, method, and description for each.

Use the path and method from an endpoint in this list to either fetch its detailed parameter schema with the get_endpoint_schema tool or to execute it with the call_endpoint tool.

Returns: APIResponse: An APIResponse object containing a list of EndpointSummary objects.

Retrieves the detailed schema for a single API endpoint.

Use this tool to understand exactly how to call a specific endpoint, including its required and optional parameters.

The path and method must be a valid combination obtained from the list_api_endpoints tool.

Args: path (str): The endpoint path (e.g., '/deputados/{id}'). method (str): The endpoint method (e.g., 'GET').

Returns: APIResponse: An APIResponse object containing the Endpoint schema on success, or an error message.

Calls a specific endpoint of the Brazilian Chamber of Deputies API.

This is the final tool in the workflow, used to retrieve the actual data. The path and method must be a valid combination obtained from the list_api_endpoints tool.

The params dictionary must contain all required parameters for the chosen endpoint, as defined by the get_endpoint_schema tool. Both path parameters and query parameters are passed together in this single dictionary.

Args: path (str): The endpoint path (e.g., '/deputados/{id}'). method (str): The HTTP method (e.g., 'GET'). params (dict[str, Any]): A dictionary of parameters for the endpoint.

Returns: APIResponse: An APIResponse object containing the requested data on success, or an error message.

Retrieves a list of deputies by name.

This is a helper tool that abstracts the process of querying for a deputy by name.

Args: name (str): The name of the deputy to search for.

Returns: APIResponse: An APIResponse object containing a list of deputies on success, or an error message.

Gets the expenses for a single deputy, specified by name or ID.

This tool finds a deputy by their name or ID. You must provide either name or id. If name is used and multiple deputies are found, it will return an error asking for a more specific name or an ID. Optional year and month parameters can be used to filter expenses.

Args: name (str | None): The full or partial name of the deputy. id (int | None): The unique ID of the deputy. year (int | None): The year to filter expenses by. month (int | None): The month to filter expenses by.

Returns: APIResponse: An APIResponse object containing the deputy's expense data on success, or an error message.

Retrieves a list of bills (proposições) by a specific author.

This is a helper tool that abstracts the process of querying bills for a deputy.

Args: deputy_id (int): The ID of the deputy authoring the bill. years (list[str] | None): One or more years for when bills were presented. If set to None, the current year is used. Defaults to None.

Returns: APIResponse: An APIResponse object containing a list of bills on success, or an error message.