Skip to main content
Glama

Dados Abertos Senado BR MCP

Vetos presidenciais

senado_vetos
Read-onlyIdempotent

Lista vetos presidenciais em apreciação pelo Congresso Nacional, por ano ou por status de tramitação. Retorna { count, total, aviso?, vetos }, com cada veto trazendo codigo, identificacao, ementa, emTramitacao, materiaVetada, tipo (total/parcial), assunto e dataLimiteVotacao (prazo de sobrestamento de pauta). limite controla o corte (padrão 100; aviso indica truncagem). Informe ano OU status (tramitando/antes-rcn/encerrados). Para o resultado da votação de um veto use senado_resultado_veto.

Input Schema

NameRequiredDescriptionDefault
anoNoVetos do ano informado
limiteNoMáximo de resultados (padrão: 100)
statusNotramitando = pós-RCN 1/2013 em tramitação (padrão); antes-rcn = anteriores à RCN; encerrados = tramitação encerrada

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 changed
    • 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 changed
    • 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. Changed1 schema field changed
    • changedOutput schema / properties / provenance / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "citation": {
      -        "type": "string"
      -      },
      -      "data_vintage": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "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"
      -          ]
      -        },
      -        "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"
      +        ]
      +      },
      +      "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"
      +  }
      +]
  4. Changed3 schema fields changed
    • 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"
      +          ]
      +        },
      +        "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"
      +            ]
      +          },
      +          "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"
      +]
  5. Changed1 schema field changed
    • addedInput schema / additionalProperties
      Added value: +false
  6. Changed2 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  7. Changed2 schema fields changed
    • removedInput schema / additionalProperties
      Removed value: -false
    • changedOutput schema / additionalProperties
      Previous value: -trueNew value: +{}
  8. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": true,
      +  "properties": {},
      +  "type": "object"
      +}
  9. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Goes beyond the read-only/idempotent annotations by disclosing the truncation behavior: `limite` cuts results and the optional `aviso` field signals that truncation occurred, with a default of 100. That is the kind of operational trait annotations cannot express. It still does not say what `count` vs `total` mean semantically, which would have completed the picture.

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-loaded with purpose, then scope, then return shape, then the routing hint — a sensible ordering with no filler sentences. The dense backtick field list is informative rather than wasteful, though the single unbroken paragraph is heavier than it needs to be.

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?

Covers purpose, filters, return fields, defaults, truncation signal, and the sibling handoff, which is everything an agent needs to call this three-optional-parameter read tool correctly. The existing output schema covers return typing, so nothing material is missing.

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; the description earns above that by tying `limite` to truncation and the `aviso` flag, and by glossing `dataLimiteVotacao` as the pauta-overstay deadline. The ano/status mutual-exclusivity hint is also added information. The only gap is that `count` vs `total` is left uninterpreted.

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 vetos presidenciais") plus the scope ("em apreciação pelo Congresso Nacional") and the two supported filters. It also names the sibling it is not (senado_resultado_veto), so an agent can separate it from the surrounding Senate tools without opening any schema.

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?

Explicitly says to inform `ano` OR `status`, which is a genuine usage constraint not encoded in the schema, and routes vote-result lookups to `senado_resultado_veto`. It gives clear context and one named alternative but stops short of stating exclusions (e.g., vetos tied to a specific matéria handled by `senado_obter_materia`).

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.