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

Senado BR — Brazilian Federal Senate Open Data

by SidneyBissoli
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Requerimentos de CPI

senado_requerimentos_cpi
Read-onlyIdempotent

Lists requests (requerimentos) for an active Brazilian Senate CPI by acronym, with zero-based pagination to page through raw records and detect the end of results.

Instructions

Lista requerimentos de uma CPI (Comissão Parlamentar de Inquérito) em atividade, pela siglaCpi, com paginação por pagina (índice baseado em 0, definido pelo upstream). Retorna { siglaCpi, pagina, count, requerimentos }, onde requerimentos é a lista de registros brutos da página (campos conforme a API: tipicamente número, data, ementa, autor e situação do requerimento). count é o tamanho da página; uma página além do total retorna count 0 — use isso para saber que as páginas acabaram. Descubra as siglas via senado_listar_comissoes com tipo=cpi. Limitação conhecida: o endpoint upstream costuma responder vazio mesmo para CPIs em atividade, e não há fonte alternativa limpa na API; nesses casos o retorno traz count 0 e um campo aviso explicando — não interprete lista vazia como certeza de que a CPI não possui requerimentos.

Input Schema

NameRequiredDescriptionDefault
paginaNoPágina da lista (padrão: 0)
siglaCpiYesSigla da CPI (ex: CPIVD, CPIPED)

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. Changed3 schema fields changedv3.3.3
    • removedInput schema / additionalProperties
      Removed value: -false
    • addedInput schema / properties / pagina / maximum
      Added value: +9007199254740991
    • changedOutput schema / additionalProperties
      Previous value: -trueNew value: +{}
  6. First observedv3.3.1

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, non-destructive and open-world behavior, and the description adds substantial context beyond that: 0-based pagination, the exact response shape, the end-of-pages signal, and a known upstream limitation where empty results may be false negatives with an `aviso` field. That last point is exactly the kind of caveat annotations cannot carry.

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

Conciseness4/5

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

Front-loads action, parameters and return shape, then closes with the critical limitation. Slightly dense, but every sentence — including the limitation and the `count` 0 semantics — carries decision-relevant information.

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?

With an output schema present, the description still usefully documents the envelope, the `aviso` failure mode and pagination boundaries. Together with the discovery pointer, an agent has everything needed to call it and interpret empty results 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 adds real meaning: `pagina` is explicitly 0-based and upstream-defined, and `siglaCpi` has a documented discovery path. It goes beyond restating the schema.

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 requerimentos de uma CPI em atividade') scoped by `siglaCpi`, and names the sibling tool (`senado_listar_comissoes` with `tipo=cpi`) used to discover the required identifier. An agent can distinguish it immediately from the commissions-listing siblings.

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

Usage Guidelines4/5

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

Gives a concrete workflow: obtain `siglaCpi` via `senado_listar_comissoes` with `tipo=cpi`, then page through with `pagina`, and treats `count` 0 as end-of-pages. It stops short of explicit when-not-to-use conditions, but the alternative for discovery is named.

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