Skip to main content
Glama

CriptoNoticias Brasil

Detalhe de uma história

get_historia
Read-onlyIdempotent

Detalhe de uma história: resumo, pontos principais, por que importa, números-chave com o veículo de cada número (quando identificado) e links às matérias originais. Cite a história (citacao.url) e o veículo original nas afirmações específicas. Aceita o slug ou a URL /historia/. Exemplos: «Quanto foi roubado da Mercado Bitcoin e quem diz isso?» · «Quantas fontes confirmam essa notícia?» English: One story in depth: summary, key facts, key figures with per-figure outlet source, and original article links. Accepts the slug or the /historia/ URL. Example: «Give me the sources for this story»

Input Schema

NameRequiredDescriptionDefault
slugYesSlug ou URL da história.

Output Schema

NameRequiredDescriptionDefault
urlYes
notaNo
slugNo
temaNo
tipoNo
ativosNo
fontesYes
resumoNo
tituloYes
citacaoYes
topicosNo
n_fontesYes
story_idYes
veiculosNo
resumo_iaNo
atribuicaoYes
citar_comoNo
publicado_emNo
atualizado_emNo
numeros_chaveYes
por_que_importaNo
pontos_principaisNo
pontos_principais_fontesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "ativos": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "atribuicao": {
      +      "properties": {
      +        "como_citar": {
      +          "type": "string"
      +        },
      +        "dados": {
      +          "type": "string"
      +        },
      +        "detalhes": {
      +          "type": "string"
      +        },
      +        "how_to_cite": {
      +          "type": "string"
      +        },
      +        "licenca": {
      +          "type": "string"
      +        },
      +        "text_en": {
      +          "type": "string"
      +        },
      +        "texto": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "texto",
      +        "licenca"
      +      ],
      +      "type": "object"
      +    },
      +    "atualizado_em": {
      +      "properties": {
      +        "brasilia": {
      +          "type": "string"
      +        },
      +        "iso": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "iso",
      +        "brasilia"
      +      ],
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "citacao": {
      +      "properties": {
      +        "fontes_originais": {
      +          "type": "string"
      +        },
      +        "texto": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "texto",
      +        "url"
      +      ],
      +      "type": "object"
      +    },
      +    "citar_como": {
      +      "type": "string"
      +    },
      +    "fontes": {
      +      "items": {
      +        "properties": {
      +          "publicado_em": {
      +            "properties": {
      +              "brasilia": {
      +                "type": "string"
      +              },
      +              "iso": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "iso",
      +              "brasilia"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "titulo": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          },
      +          "veiculo": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "veiculo",
      +          "url"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "n_fontes": {
      +      "type": "integer"
      +    },
      +    "nota": {
      +      "type": "string"
      +    },
      +    "numeros_chave": {
      +      "items": {
      +        "properties": {
      +          "detalhe": {
      +            "type": "string"
      +          },
      +          "fonte": {
      +            "properties": {
      +              "url": {
      +                "type": "string"
      +              },
      +              "veiculo": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "veiculo",
      +              "url"
      +            ],
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "rotulo": {
      +            "type": "string"
      +          },
      +          "valor": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "rotulo",
      +          "valor",
      +          "fonte"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "pontos_principais": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "pontos_principais_fontes": {
      +      "items": {
      +        "properties": {
      +          "url": {
      +            "type": "string"
      +          },
      +          "veiculo": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "veiculo",
      +          "url"
      +        ],
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": "array"
      +    },
      +    "por_que_importa": {
      +      "type": "string"
      +    },
      +    "publicado_em": {
      +      "properties": {
      +        "brasilia": {
      +          "type": "string"
      +        },
      +        "iso": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "iso",
      +        "brasilia"
      +      ],
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "resumo": {
      +      "type": "string"
      +    },
      +    "resumo_ia": {
      +      "type": "string"
      +    },
      +    "slug": {
      +      "type": "string"
      +    },
      +    "story_id": {
      +      "type": "string"
      +    },
      +    "tema": {
      +      "properties": {
      +        "status": {
      +          "type": "string"
      +        },
      +        "titulo": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "tipo": {
      +      "type": "string"
      +    },
      +    "titulo": {
      +      "type": "string"
      +    },
      +    "topicos": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "url": {
      +      "type": "string"
      +    },
      +    "veiculos": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "story_id",
      +    "titulo",
      +    "n_fontes",
      +    "url",
      +    "citacao",
      +    "numeros_chave",
      +    "fontes",
      +    "atribuicao"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

A4.3/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 closed-world, so the safety profile is covered. The description adds genuinely useful behavioral context beyond that: an obligation to cite citacao.url and the original outlet when making specific claims, plus the input flexibility of slug or /historia/<slug> URL.

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?

The content is front-loaded on what the tool returns and then moves to citation policy and input format, with zero filler. It is roughly double length because everything is duplicated in Portuguese and English, which is redundant for a bilingual-capable agent but not disorganized.

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

Completeness4/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 return shape needn't be explained, and annotations carry the safety semantics; the description supplies the remaining citation and input-format obligations. The one missing piece for a detail-by-identifier tool is how to obtain a valid slug when the agent has only a topic.

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 a concrete URL pattern (/historia/<slug>) that the schema's terse 'Slug ou URL da história' does not spell out, helping the agent construct a valid value. It stops short of discussing URL-encoding or slug normalization.

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?

The description names a specific resource ('uma história') and enumerates exactly what the payload contains: resumo, pontos principais, por que importa, números-chave with per-figure outlet, and links to original articles. It is clearly a single-story detail tool, which separates it from list/search siblings such as buscar, listar_temas and ultimas_historias.

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?

Two concrete example questions («Quanto foi roubado da Mercado Bitcoin...», «Quantas fontes confirmam essa notícia?») make the use case unambiguous, and it states the accepted identifier formats. It does not, however, tell the agent what to do when it lacks a slug (e.g., route through buscar first), nor name an explicit when-not condition.

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.

Resources