Skip to main content
Glama
Senado BR — Brazilian Federal Senate Open Data

Senado BR — Brazilian Federal Senate Open Data

Listar comissões

senado_listar_comissoes
Read-onlyIdempotent

List active Brazilian Federal Senate committees and filter by type (permanent, temporary, CPI, mixed) to retrieve their sigla, name, and code for committee lookup and meeting queries.

Instructions

Lista comissões (colegiados) ativas do Senado, com filtros por tipo (permanente, temporaria, cpi, mista) e ativa. Retorna { count, comissoes }, cada item com codigo, sigla, nome, tipo, casa e ativa. O endpoint só traz comissões ativas, logo ativa=false resulta em lista vazia. Use para descobrir a sigla exigida por senado_obter_comissao e senado_reunioes_comissao.

Input Schema

NameRequiredDescriptionDefault
tipoNoTipo: permanente, temporaria, cpi, mista
ativaNoApenas comissões ativas

Output Schema

NameRequiredDescriptionDefault
provenanceYesBloco de proveniência do portfólio (projeção concise): source, source_url, data_vintage, retrieved_at (horário de Brasília), citation, license, revision e retrieval; field_sources só quando a resposta funde recortes, derived e derivation_note só nos modos de estatísticas. retrieval é o diagnóstico da ida à origem nesta chamada — requisições, tentativas com retentativas, anomalias superadas (timeout, network, rate_limited, http_5xx, http_4xx, malformed_body) e unstable (true quando algo precisou ser repetido) —, ou null quando não foi medido. Lista de blocos quando a chamada consulta várias fontes (índice do search).
attributionYesURLs de origem dos dados (as source_url distintas dos blocos de proveniência, incluindo as de field_sources), para linkar a citação

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv3.23.0
    • addedOutput schema / properties / attribution / description
      Added value: +"URLs de origem dos dados (as source_url distintas dos blocos de proveniência, incluindo as de field_sources), para linkar a citação"
    • addedOutput schema / properties / provenance / description
      Added value: +"Bloco de proveniência do portfólio (projeção concise): source, source_url, data_vintage, retrieved_at (horário de Brasília), citation, license, revision e retrieval; field_sources só quando a resposta funde recortes, derived e derivation_note só nos modos de estatísticas. retrieval é o diagnóstico da ida à origem nesta chamada — requisições, tentativas com retentativas, anomalias superadas (timeout, network, rate_limited, http_5xx, http_4xx, malformed_body) e unstable (true quando algo precisou ser repetido) —, ou null quando não foi medido. Lista de blocos quando a chamada consulta várias fontes (índice do search)."
  2. Changed1 schema field changedv3.18.4
    • changedOutput schema / properties / provenance / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "citation": {
      -        "type": "string"
      -      },
      -      "data_vintage": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "field_sources": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "data_vintage": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "dataset_id": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "fields": {
      -              "items": {
      -                "type": "string"
      -              },
      -              "minItems": 1,
      -              "type": "array"
      -            },
      -            "retrieved_at": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "served_from_cache": {
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "source_url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "fields",
      -            "source_url",
      -            "dataset_id",
      -            "data_vintage",
      -            "retrieved_at"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "license": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "retrieval": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "anomalies": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "count": {
      -                      "maximum": 9007199254740991,
      -                      "minimum": 1,
      -                      "type": "integer"
      -                    },
      -                    "kind": {
      -                      "enum": [
      -                        "timeout",
      -                        "network",
      -                        "http_4xx",
      -                        "http_5xx",
      -                        "rate_limited",
      -                        "malformed_body"
      -                      ],
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "kind",
      -                    "count"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": "array"
      -              },
      -              "attempts": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "requests": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "unstable": {
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "requests",
      -              "attempts",
      -              "anomalies",
      -              "unstable"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "retrieved_at": {
      -        "type": "string"
      -      },
      -      "source": {
      -        "type": "string"
      -      },
      -      "source_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "source",
      -      "source_url",
      -      "data_vintage",
      -      "retrieved_at",
      -      "retrieval",
      -      "citation",
      -      "license"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "citation": {
      -          "type": "string"
      -        },
      -        "data_vintage": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "field_sources": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "data_vintage": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "dataset_id": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "fields": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "minItems": 1,
      -                "type": "array"
      -              },
      -              "retrieved_at": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "served_from_cache": {
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "source_url": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "fields",
      -              "source_url",
      -              "dataset_id",
      -              "data_vintage",
      -              "retrieved_at"
      -            ],
      -            "type": "object"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "license": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "retrieval": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "anomalies": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "count": {
      -                        "maximum": 9007199254740991,
      -                        "minimum": 1,
      -                        "type": "integer"
      -                      },
      -                      "kind": {
      -                        "enum": [
      -                          "timeout",
      -                          "network",
      -                          "http_4xx",
      -                          "http_5xx",
      -                          "rate_limited",
      -                          "malformed_body"
      -                        ],
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "kind",
      -                      "count"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "attempts": {
      -                  "maximum": 9007199254740991,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "requests": {
      -                  "maximum": 9007199254740991,
      -                  "minimum": 1,
      -                  "type": "integer"
      -                },
      -                "unstable": {
      -                  "type": "boolean"
      -                }
      -              },
      -              "required": [
      -                "requests",
      -                "attempts",
      -                "anomalies",
      -                "unstable"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "retrieved_at": {
      -          "type": "string"
      -        },
      -        "source": {
      -          "type": "string"
      -        },
      -        "source_url": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "source",
      -        "source_url",
      -        "data_vintage",
      -        "retrieved_at",
      -        "retrieval",
      -        "citation",
      -        "license"
      -      ],
      -      "type": "object"
      -    },
      -    "minItems": 1,
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "citation": {
      +        "type": "string"
      +      },
      +      "data_vintage": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "derivation_note": {
      +        "type": "string"
      +      },
      +      "derived": {
      +        "type": "boolean"
      +      },
      +      "field_sources": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "data_vintage": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "dataset_id": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fields": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "retrieved_at": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "served_from_cache": {
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "source_url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "fields",
      +            "source_url",
      +            "dataset_id",
      +            "data_vintage",
      +            "retrieved_at"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "license": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "notices": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "retrieval": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "anomalies": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "count": {
      +                      "maximum": 9007199254740991,
      +                      "minimum": 1,
      +                      "type": "integer"
      +                    },
      +                    "kind": {
      +                      "enum": [
      +                        "timeout",
      +                        "network",
      +                        "http_4xx",
      +                        "http_5xx",
      +                        "rate_limited",
      +                        "malformed_body"
      +                      ],
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "kind",
      +                    "count"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "attempts": {
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "requests": {
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "unstable": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "requests",
      +              "attempts",
      +              "anomalies",
      +              "unstable"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "retrieved_at": {
      +        "type": "string"
      +      },
      +      "revision": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "note": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "status": {
      +            "enum": [
      +              "current",
      +              "provisional",
      +              "final"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "status",
      +          "note"
      +        ],
      +        "type": "object"
      +      },
      +      "source": {
      +        "type": "string"
      +      },
      +      "source_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "source",
      +      "source_url",
      +      "data_vintage",
      +      "retrieved_at",
      +      "retrieval",
      +      "citation",
      +      "license"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "citation": {
      +          "type": "string"
      +        },
      +        "data_vintage": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "derivation_note": {
      +          "type": "string"
      +        },
      +        "derived": {
      +          "type": "boolean"
      +        },
      +        "field_sources": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "data_vintage": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "dataset_id": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "fields": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "retrieved_at": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "served_from_cache": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "source_url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "fields",
      +              "source_url",
      +              "dataset_id",
      +              "data_vintage",
      +              "retrieved_at"
      +            ],
      +            "type": "object"
      +          },
      +          "minItems": 1,
      +          "type": "array"
      +        },
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "notices": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "minItems": 1,
      +          "type": "array"
      +        },
      +        "retrieval": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "anomalies": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "count": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": 1,
      +                        "type": "integer"
      +                      },
      +                      "kind": {
      +                        "enum": [
      +                          "timeout",
      +                          "network",
      +                          "http_4xx",
      +                          "http_5xx",
      +                          "rate_limited",
      +                          "malformed_body"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "count"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "attempts": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "requests": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "unstable": {
      +                  "type": "boolean"
      +                }
      +              },
      +              "required": [
      +                "requests",
      +                "attempts",
      +                "anomalies",
      +                "unstable"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "retrieved_at": {
      +          "type": "string"
      +        },
      +        "revision": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "note": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "status": {
      +              "enum": [
      +                "current",
      +                "provisional",
      +                "final"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "note"
      +          ],
      +          "type": "object"
      +        },
      +        "source": {
      +          "type": "string"
      +        },
      +        "source_url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "source",
      +        "source_url",
      +        "data_vintage",
      +        "retrieved_at",
      +        "retrieval",
      +        "citation",
      +        "license"
      +      ],
      +      "type": "object"
      +    },
      +    "minItems": 1,
      +    "type": "array"
      +  }
      +]
  3. Changed3 schema fields changedv3.15.2
    • addedOutput schema / properties / attribution
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / provenance
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "citation": {
      +          "type": "string"
      +        },
      +        "data_vintage": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "field_sources": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "data_vintage": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "dataset_id": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "fields": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "retrieved_at": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "served_from_cache": {
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "source_url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "fields",
      +              "source_url",
      +              "dataset_id",
      +              "data_vintage",
      +              "retrieved_at"
      +            ],
      +            "type": "object"
      +          },
      +          "minItems": 1,
      +          "type": "array"
      +        },
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "retrieval": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "anomalies": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "count": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": 1,
      +                        "type": "integer"
      +                      },
      +                      "kind": {
      +                        "enum": [
      +                          "timeout",
      +                          "network",
      +                          "http_4xx",
      +                          "http_5xx",
      +                          "rate_limited",
      +                          "malformed_body"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "count"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "attempts": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "requests": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "unstable": {
      +                  "type": "boolean"
      +                }
      +              },
      +              "required": [
      +                "requests",
      +                "attempts",
      +                "anomalies",
      +                "unstable"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "retrieved_at": {
      +          "type": "string"
      +        },
      +        "source": {
      +          "type": "string"
      +        },
      +        "source_url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "source",
      +        "source_url",
      +        "data_vintage",
      +        "retrieved_at",
      +        "retrieval",
      +        "citation",
      +        "license"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "citation": {
      +            "type": "string"
      +          },
      +          "data_vintage": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "field_sources": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "data_vintage": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "dataset_id": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "fields": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "minItems": 1,
      +                  "type": "array"
      +                },
      +                "retrieved_at": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "served_from_cache": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "source_url": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "fields",
      +                "source_url",
      +                "dataset_id",
      +                "data_vintage",
      +                "retrieved_at"
      +              ],
      +              "type": "object"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "license": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "retrieval": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "anomalies": {
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "count": {
      +                          "maximum": 9007199254740991,
      +                          "minimum": 1,
      +                          "type": "integer"
      +                        },
      +                        "kind": {
      +                          "enum": [
      +                            "timeout",
      +                            "network",
      +                            "http_4xx",
      +                            "http_5xx",
      +                            "rate_limited",
      +                            "malformed_body"
      +                          ],
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "kind",
      +                        "count"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "attempts": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "requests": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "unstable": {
      +                    "type": "boolean"
      +                  }
      +                },
      +                "required": [
      +                  "requests",
      +                  "attempts",
      +                  "anomalies",
      +                  "unstable"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "retrieved_at": {
      +            "type": "string"
      +          },
      +          "source": {
      +            "type": "string"
      +          },
      +          "source_url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "source",
      +          "source_url",
      +          "data_vintage",
      +          "retrieved_at",
      +          "retrieval",
      +          "citation",
      +          "license"
      +        ],
      +        "type": "object"
      +      },
      +      "minItems": 1,
      +      "type": "array"
      +    }
      +  ]
      +}
    • addedOutput schema / required
      Added value: +[
      +  "provenance",
      +  "attribution"
      +]
  4. Changed3 schema fields changedv3.9.0
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedInput schema / additionalProperties
      Added value: +false
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  5. Changed2 schema fields changedv3.3.3
    • removedInput schema / additionalProperties
      Removed value: -false
    • changedOutput schema / additionalProperties
      Previous value: -trueNew value: +{}
  6. First observedv3.3.1

TDQS

A4.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive and openWorld, so the safety profile is covered. The description still adds real behavioral context beyond that: the endpoint only returns active commissions, making `ativa=false` a guaranteed empty result, and it names the returned fields. It stops short of pagination/rate-limit detail, which keeps it at 4 rather than 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences: what it lists and filters, what it returns, then the usage routing and the empty-result caveat. Nothing is padded and the routing hint is placed where an agent deciding between tools will read it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values needn't be spelled out (the description does it anyway as a light aid), and annotations carry the safety profile. Between annotations, schema, and the description's cross-references and empty-list warning, an agent has everything needed to call this correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description goes past the schema's bare 'Apenas comissões ativas' by explaining the consequence of `ativa=false` and enumerating the `tipo` enum values in context. That is genuine semantic value the schema doesn't convey.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Lista comissões (colegiados) ativas do Senado') plus the supported filters, and implicitly distinguishes itself from the singular sibling senado_obter_comissao by being the listing tool that feeds it. An agent knows immediately what this returns and at what granularity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly says to use it to discover the `sigla` required by `senado_obter_comissao` and `senado_reunioes_comissao`, naming the two downstream alternatives and the condition that selects them. It also flags the negative case (`ativa=false` yields an empty list), so an agent won't waste a call.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools