Skip to main content
Glama

music360_get_press_release

Consulta uma notícia/press release do tenant atual usando somente public_uid.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYespublic_uid da notícia. Não use ID numérico interno.
response_profileNoPerfil de resposta. Listagens usam summary por padrão; sensitive exige admin.
sensitive_access_purposeNoFinalidade operacional obrigatória quando response_profile=sensitive ou include_sensitive_details=true.
include_sensitive_detailsNoRetorna detalhes sensíveis mínimos quando autorizado por escopo admin. Padrão: false.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYesDados completos do registro.
successYesIndica se a operacao foi bem-sucedida.
entity_idYespublic_uid do registro encontrado.
entity_typeYesTipo da entidade consultada.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / include_sensitive_details
      Added value: +{
      +  "description": "Retorna detalhes sensíveis mínimos quando autorizado por escopo admin. Padrão: false.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / response_profile
      Added value: +{
      +  "description": "Perfil de resposta. Listagens usam summary por padrão; sensitive exige admin.",
      +  "enum": [
      +    "summary",
      +    "standard",
      +    "sensitive"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / sensitive_access_purpose
      Added value: +{
      +  "description": "Finalidade operacional obrigatória quando response_profile=sensitive ou include_sensitive_details=true.",
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "data": {
      +      "description": "Dados completos do registro.",
      +      "type": "object"
      +    },
      +    "entity_id": {
      +      "description": "public_uid do registro encontrado.",
      +      "type": "string"
      +    },
      +    "entity_type": {
      +      "description": "Tipo da entidade consultada.",
      +      "type": "string"
      +    },
      +    "success": {
      +      "description": "Indica se a operacao foi bem-sucedida.",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "success",
      +    "entity_type",
      +    "entity_id",
      +    "data"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

B3.3/5.0
Behavior2/5

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

Não há anotações, então a descrição deveria ser mais transparente. Ela apenas afirma que é uma consulta, sem detalhar efeitos colaterais, requisitos de permissão, tratamento de erros ou comportamento com dados sensíveis. Falta contexto sobre o que acontece quando o public_uid não existe ou quando perfis sensíveis são solicitados.

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

Conciseness5/5

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

Frase única, direta e sem ruído, transmitindo o propósito essencial de forma eficiente. Estrutura ideal para uma ferramenta simples.

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

Completeness3/5

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

A descrição cobre o caso básico, mas não aborda as opções sensíveis (response_profile=sensitive, include_sensitive_details) nem o fluxo de acesso administrativo, que ficam subentendidos no schema. A presença de output schema reduz a necessidade de detalhar retornos, mas a parte de autorização sensível poderia ser antecipada na descrição.

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

Parameters3/5

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

O schema já cobre 100% dos parâmetros com descrições detalhadas, então a barra de valor é baixa. A descrição reforça o uso exclusivo do public_uid, mas não acrescenta significado além do que o schema já fornece.

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?

A descrição identifica claramente a ação (consultar), o recurso (notícia/press release) e o identificador (public_uid). Isso a distingue do sibling music360_list_press_release, que é para listagem, tornando o propósito inequívoco.

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

Usage Guidelines2/5

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

A descrição não oferece orientação explícita sobre quando usar este tool em vez de alternativas como list_press_release, nem menciona cenários em que não deve ser usado. A menção de 'usando somente public_uid' dá uma pista, mas sem contexto de seleção.

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