Skip to main content
Glama

Criar investimento

create_equity

Cria um ativo de investimento (Equity) e, no mesmo statement atômico, registra sua primeira avaliação (EquityValuation) com value/cost/data informados — equivalente a criar o ativo e já chamar add_equity_valuation uma vez. Dispara recálculo best-effort de projeções e insights em background.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "<name>",
      "type": "<type>",
      "value": "<value>"
    },
    "name": "create_equity"
  }
}

Input Schema

NameRequiredDescriptionDefault
costNoCusto/valor investido. Default: igual a value (sem ganho/perda registrado se omitido)
nameYesNome do investimento
typeYesTipo do ativo — ex: stocks, crypto, real-estate-house, real-estate-apt, vehicle-car, business, cash, jewelry, art. Usado para agrupar a alocação em investments_workspace
colorNoCor associada ao investimento na UI (ex: hex '#RRGGBB')
valueYesValor de mercado atual do investimento
sharesNoQuantidade de cotas/ações compradas, se aplicável
tickerNoCódigo do ativo na bolsa/exchange (ex: PETR4). Convertido para maiúsculas
exchangeNoBolsa/exchange onde o ativo é negociado
descriptionNoDescrição livre do investimento
acquisitionDateNoData de aquisição (ISO). Default: agora

Output Schema

NameRequiredDescriptionDefault
idNo
costNo
nameNo
typeNoTipo do ativo — ex: stocks, crypto, real-estate-house
colorNo
valueNo
sharesNo
tickerNo
userIdNo
exchangeNo
createdAtNo
updatedAtNo
descriptionNo
acquisitionDateNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • addedInput schema / properties / acquisitionDate
      Added value: +{
      +  "description": "Data de aquisição (ISO). Default: agora",
      +  "type": "string"
      +}
    • addedInput schema / properties / color
      Added value: +{
      +  "description": "Cor associada ao investimento na UI (ex: hex '#RRGGBB')",
      +  "type": "string"
      +}
    • addedInput schema / properties / cost / description
      Added value: +"Custo/valor investido. Default: igual a value (sem ganho/perda registrado se omitido)"
    • addedInput schema / properties / description
      Added value: +{
      +  "description": "Descrição livre do investimento",
      +  "type": "string"
      +}
    • addedInput schema / properties / exchange / description
      Added value: +"Bolsa/exchange onde o ativo é negociado"
    • addedInput schema / properties / name / description
      Added value: +"Nome do investimento"
    • addedInput schema / properties / shares
      Added value: +{
      +  "description": "Quantidade de cotas/ações compradas, se aplicável",
      +  "type": "number"
      +}
    • addedInput schema / properties / ticker / description
      Added value: +"Código do ativo na bolsa/exchange (ex: PETR4). Convertido para maiúsculas"
    • changedInput schema / properties / type / description
      Previous value: -"Ex: STOCK, FUND, CRYPTO, REAL_ESTATE"New value: +"Tipo do ativo — ex: stocks, crypto, real-estate-house, real-estate-apt, vehicle-car, business, cash, jewelry, art. Usado para agrupar a alocação em investments_workspace"
    • addedInput schema / properties / value / description
      Added value: +"Valor de mercado atual do investimento"
  2. First observed

TDQS

A4.5/5.0
Behavior5/5

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

As annotations são todas negativas/falsas e não informam os comportamentos relevantes. A descrição adiciona contexto valioso: atomicidade da operação, criação simultânea da primeira EquityValuation com value/cost/data e recálculo best-effort em background. Não há contradição com as annotations.

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?

Duas frases objetivas: a primeira entrega a função central e a atomicidade; a segunda adiciona o efeito assíncrono. Não há palavras redundantes nem informações desnecessárias. A estrutura é front-loaded e eficiente.

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?

Com 10 parâmetros, schema 100% coberto, output schema presente e annotations fornecidas, a descrição cobre os comportamentos não óbvios: operação atômica, primeira avaliação e recálculo em background. A não idempotência é sinalizada por idempotentHint=false, então não é uma lacuna. Nada essencial falta para o agente invocar corretamente.

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 cobre 100% dos 10 parâmetros com descrições próprias, então o baseline é 3. A descrição apenas menciona que value/cost/data alimentam a primeira avaliação, sem acrescentar detalhes além do schema. Ela não compensa nem contradiz as definições paramétricas já existentes.

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 é específica: cria um ativo de investimento (Equity), registra a primeira avaliação (EquityValuation) no mesmo statement atômico e dispara recálculo em background. Isso a distingue claramente de add_equity_valuation, update_equity e list_equities. Não há ambiguidade sobre o recurso ou a ação.

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?

A descrição posiciona a ferramenta em relação a add_equity_valuation: criar o ativo e já chamar add_equity_valuation uma vez é equivalente a este tool. Isso indica que avaliações subsequentes devem usar add_equity_valuation, mas não há uma regra explícita de quando não usar. A orientação é clara, porém implícita.

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.