CDF Finance

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.

Input Schema

TableJSON Schema

Name	Required	Description
`cost`	No	Custo/valor investido. Default: igual a value (sem ganho/perda registrado se omitido)
`name`	Yes	Nome do investimento
`type`	Yes	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
`color`	No	Cor associada ao investimento na UI (ex: hex '#RRGGBB')
`value`	Yes	Valor de mercado atual do investimento
`shares`	No	Quantidade de cotas/ações compradas, se aplicável
`ticker`	No	Código do ativo na bolsa/exchange (ex: PETR4). Convertido para maiúsculas
`exchange`	No	Bolsa/exchange onde o ativo é negociado
`description`	No	Descrição livre do investimento
`acquisitionDate`	No	Data de aquisição (ISO). Default: agora

Output Schema

TableJSON Schema

Name	Required	Description
`id`	No
`cost`	No
`name`	No
`type`	No	Tipo do ativo — ex: stocks, crypto, real-estate-house
`color`	No
`value`	No
`shares`	No
`ticker`	No
`userId`	No
`exchange`	No
`createdAt`	No
`updatedAt`	No
`description`	No
`acquisitionDate`	No

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

Changed10 schema fields changedSep 1, 2026

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"

First observedSep 1, 2026

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.

All CDF Finance tools Inspect

Try in Browser

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.7/5.0

Disambiguation3/5

The tools are individually well-described and many cross-reference their closest neighbors, but the set contains several easily confused clusters: create_transaction/confirm_new_transaction, update_equity/add_equity_valuation, the invoice tools (current_invoice, next_invoice, list_pending_invoices, get_invoice), and the many analytics/projection tools. The descriptions help a careful reader, but with 81 tools an agent is likely to misselect among these overlapping surfaces.

Naming Consistency3/5

CRUD operations consistently use create_/list_/update_/delete_ plus a resource noun, and all names are snake_case. However, there is a large second group of noun-phrase analytics tools (cashflow_forecast, spending_projection, categories_insights, transport_routine) plus one-off verbs such as can_afford, pay_invoice, and validate_current_invoices, so the naming convention is mixed even though it remains readable.

Tool Count1/5

81 tools is far beyond the practical MCP tool surface and exceeds the rubric's 50+ extreme-mismatch threshold. Even if each tool maps to a real finance endpoint, the volume overwhelms an agent's context window and makes selection much harder.

Completeness4/5

The server covers the finance lifecycle extensively: accounts, cards, invoices, transactions, recurring rules, budgets, goals, debts, equities, categories, tags, cost centers, profile, projections, and insights all have working read/write paths. Minor gaps remain, such as no update/delete for tags and no direct update/delete for system-generated invoices, but agents can usually work around these.

Criar investimento

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

TDQS

Resources