backtest_portfolio
ChatGPTSimulate a static-weight portfolio over history: growth curve, CAGR, annualized volatility, max drawdown, number of rebalances, and each component in isolation. Supports no rebalancing, calendar rebalancing (monthly/quarterly/semiannual/annual) or band rebalancing (rebalance when any weight drifts beyond the threshold). Series are aligned on their common dates; per-allocation currency conversion is applied before simulating. Units: multiple is a growth factor (168 = 168x), cagr and vol_aa are decimal fractions (0.15 = 15%), max_drawdown is a percentage (-27.7 = -27.7%, same convention as get_drawdown). For a FIDC class whose series are separate investments one refused allocation fails the whole backtest (FUND SERIES REQUIRED) and lists the series — ask the user which one they hold; see get_quotes. An allocation on a class of any other fund type with more than one quoted series simulates with the oldest series and adds a text item FUND SERIES NOTICE per fund — confirm the series with the user before presenting. Cost: 25 credits per call.
compare_assets
ChatGPTCompare 2 to 10 assets in a SINGLE call over the SAME date window. Returns performance statistics (cumulative returns, sharpe, volatility, sortino per timeframe, best/worst month) and the drawdown summary for EVERY asset. Omit start_date/end_date to use the maximum available history. For two assets pass identifier_a/identifier_b (renders an interactive comparison card in clients that support MCP Apps); for 3+ pass identifiers[]. Prefer this over separate get_asset_stats/get_drawdown calls whenever the user asks to compare or rank named assets. For a FIDC class whose series are separate investments the refused leg comes back in failed[] (reason starting with FUND SERIES REQUIRED, series listed) while the other assets answer — ask the user which one they hold; see get_quotes. A leg on a class of any other fund type with more than one quoted series answers with the oldest series and adds a text item FUND SERIES NOTICE for that leg — confirm the series with the user before presenting. Cost: 25 credits per call.
get_asset_info
ChatGPTGet detailed information about a specific asset by its identifier (e.g. "petr4:b3", "some-fund:fi"). Cost: 1 credits per call.
get_asset_stats
ChatGPTGet performance statistics for a specific asset: cumulative returns, sharpe, volatility, sortino and other ratios across standard timeframes (3m/6m/12m/24m/36m/48m/60m/ytd/mtd/begin), plus best/worst monthly return and positive/negative month counts. Does NOT return drawdown — for drawdown use get_drawdown. The "begin"/since-inception timeframe and the monthly extremes may be limited by the plan history depth — do not assume they span the asset full history. For a FIDC class whose series are separate investments this tool refuses (FUND SERIES REQUIRED) and lists the series — ask the user which one they hold; see get_quotes. A class of any other fund type with more than one quoted series answers with the oldest series and a second text item FUND SERIES NOTICE — confirm the series with the user before presenting. Cost: 5 credits per call.
get_available_wallets
ChatGPTGet available wallet months/years for a fund. Cost: 1 credits per call.
get_drawdown
ChatGPTGet the underwater (running drawdown) series for an asset. Each point is the percentage distance from the running peak inside the requested range — zero when the asset is at a new high in the range, negative otherwise. max_drawdown is relative to the requested range (the peak resets at start_date); summary.all_time_max_drawdown comes back in ANY window, and all_time_is_full_history says whether it covers the full history. The summary also echoes range_start, range_end and is_full_history. The series is daily up to 5 years of data and monthly beyond (each month keeps its WORST point, so the trough is never hidden); the summary is always computed on the daily series, and summary.recovery_date says when the asset first got back to the peak after the trough (null if it has not). When aggregated, the last point is the trough of that period, not the latest reading — use summary.current_drawdown and range_end for the current state. For a FIDC class whose series are separate investments this tool refuses (FUND SERIES REQUIRED) and lists the series — ask the user which one they hold; see get_quotes. A class of any other fund type with more than one quoted series answers with the oldest series and a second text item FUND SERIES NOTICE — confirm the series with the user before presenting. Cost: 5 credits per call.
get_fund_class_subclass
ChatGPTGet CVM class and subclass classification for a fund. Cost: 1 credits per call.
get_quotes
ChatGPTGet historical quotes/prices for a specific asset. Returns time series data. For funds, the series automatically stitches master class, legacy 555 history, and any RCVM 175 continuation subclass. With the class identifier (the CNPJ), when the class has no series of its own: if exactly one series has quotes it is served and named in nicename; for a FIDC with more than one quoted series the tool refuses (isError starting with FUND SERIES REQUIRED) and lists the series in the error, because the senior and subordinated tranches are different investments — ask the user which series they hold, call again with that series identifier, never pick. Funds of any other type (FI, FII, FIP, FIAGRO...) are not refused: they answer with the oldest series, named in nicename, and when more than one series has quotes the response carries a second text item starting with FUND SERIES NOTICE — confirm with the user which series they hold before presenting the numbers. Whatever you get, report the nicename you got back. IMPORTANT: the default series is ADJUSTED (reinvests dividends, amortization and interest), which is right for measuring return and WRONG as the price someone paid. If you are looking up a price to record a buy or sell, pass adjusted: false. Cost: 1 credits per call.
get_rolling_windows
ChatGPTAnnualized return for EVERY rolling window of N years across the asset history — the "film" instead of the "photo": answers "what if I had entered at any other date?". Returns a summary (window count, share of negative windows, win rate vs benchmark, last losing window) plus the window series in compact parallel arrays. All returns are decimal fractions (0.10 = 10% a.a.). The output series is sampled at month ends regardless of step; step only changes how many windows feed the summary. For a FIDC class whose series are separate investments this tool refuses (asset or benchmark) (FUND SERIES REQUIRED) and lists the series — ask the user which one they hold; see get_quotes. A class of any other fund type with more than one quoted series (asset or benchmark) answers with the oldest series and a text item FUND SERIES NOTICE per fund — confirm the series with the user before presenting. Cost: 10 credits per call.
get_wallet_detail
ChatGPTGet detailed wallet composition for a fund in a specific month/year. Cost: 10 credits per call.
list_fund_structure
ChatGPTList the classes and series (subclasses) of a fund, paginated. USE THIS when a fund comes back with has_quotes: false, or before calling get_quotes on a FIDC: a fund is often split into series that are DIFFERENT investments — senior 1..N and the subordinated tranche, which absorbs first loss and does not follow the senior return. Accepts the CNPJ identifier or any series identifier of the same fund. Each row says whether it has its own quote series (has_quotes), so you can tell which identifier is worth passing to get_quotes. The response carries fund_type (FIDC, FI, FII, FIP, FIAGRO...). When the fund is a FIDC and more than one series has quotes, ASK the user which one they hold — do not pick for them. The quote/stats tools refuse the class identifier of a FIDC in that case (FUND SERIES REQUIRED) and embed this same list in the refusal, so calling this tool first avoids spending an expensive call to find that out. Funds of any other type keep answering by the class CNPJ, with the series served named in nicename, and with a second text item FUND SERIES NOTICE when more than one series has quotes — confirm the series with the user before presenting. Cost: 1 credits per call.
portfolio_add_custom_asset_incomes
ChatGPTLança proventos em um ativo personalizado do usuário. Aceita 1 a 100 lançamentos por chamada. type: RENDIMENTO para tudo que é renda (dividendo, JCP, aluguel de FII, juros, cupom) ou AMORTIZACAO para devolução de principal — a amortização, além de pagar em dinheiro, DESCONTA o valor do patrimônio do ativo a partir do pagamento; use RENDIMENTO quando o principal não muda. payment_date futura = provento provisionado (a receber). last_date_prior é a data-com, o último dia em que quem tinha o papel ganhou direito ao provento, e é OBRIGATÓRIA quando payment_date é futura: sem ela o sistema não tem como saber qual posição tem direito, e o provento não aparece em lugar nenhum — nem como provisionado. Se o relatório não trouxer a data-com, PERGUNTE ao usuário; não invente e não repita a data de pagamento. Passe portfolio_ref_ids das carteiras que têm o ativo: o MCP reconsolida cada uma. Provento igual a um que o ativo já tem (mesma data, data-com, tipo e valor) não é duplicado, e a resposta diz quantos já existiam. Mandar a mesma data com outro valor cria um SEGUNDO provento, que soma com o primeiro: para corrigir o valor de um provento lançado, use portfolio_update_custom_asset_income; para apagar, portfolio_delete_custom_asset_income (o income_id vem de portfolio_get_custom_asset).
portfolio_add_custom_asset_quotes
ChatGPTGrava cotas num ativo personalizado MANUAL que já existe: é assim que se mantém em dia a cota mensal de COE, debênture, FIDC e afins. NUNCA recrie o ativo para atualizar cota; use esta tool. Aceita 1 a 2.000 cotas por chamada, uma por data (YYYY-MM-DD), com o valor por unidade na moeda do ativo. on_conflict="replace" (padrão) substitui a cota de uma data que já existe e mantém as outras; repetir a mesma chamada não duplica nada. on_conflict="error" recusa a chamada inteira, sem gravar nada, se alguma data já tiver cota. Só ativo MANUAL: em ativo DYNAMIC (indexado) ou de mercado a cota vem do índice e não aceita cota manual. Passe portfolio_ref_ids das carteiras que têm o ativo: o MCP reconsolida cada uma. A resposta traz inserted (datas novas), replaced (datas que já tinham cota e foram substituídas) e total (cotas do ativo depois da gravação).
portfolio_consolidate
ChatGPTDispara o recálculo (consolidação) da carteira. Assíncrono e idempotente. Carteira sem transação elegível (aprovada, sem pendência de revisão, com data válida) responde que não há o que consolidar — não é erro do serviço.
portfolio_count_issues
ChatGPTRetorna a contagem de pendências por carteira. Requer conta Pro com time.
portfolio_create_custom_asset
ChatGPTRENDA FIXA COMUM NÃO ENTRA AQUI. CDB, LCI, LCA, LC, LF, RDB, CRI, CRA e afins são cadastrados como ativo de renda fixa em portfolio_create_transaction, no formato ":user_rfs" — ali o sistema calcula a cotação sozinho a partir do índice e do vencimento. Use ativo personalizado para renda fixa APENAS quando o papel paga provento em dinheiro ao longo da vida (juros semestrais, amortização), porque só ativo personalizado aceita provento lançado à mão (portfolio_add_custom_asset_incomes). Na dúvida, PERGUNTE ao usuário se o papel paga provento: se não paga, use :user_rfs. ANTES DE CRIAR, procure com portfolio_list_custom_assets: o mesmo papel (COE, CRI/CRA, debênture) costuma pertencer a vários clientes, e o asset_identifier existente pode ser reutilizado em outra carteira, evitando manter várias séries de cotas do mesmo papel. Reaproveite só item com search_match "contains", ou um "similar" que o usuário confirmou ser o mesmo ativo (série, vencimento): "similar" é só parecido e pode ser outro papel. Se o papel também é de outros clientes, PERGUNTE ao usuário se quer compartilhá-lo com o time (shared: true) — compartilhar expõe o nome do ativo aos demais membros, então nunca marque sozinho. Cria um ativo personalizado (custom asset) do usuário para usar em transações do consolidador. quote_type=MANUAL: informe currency (BRL/USD/EUR) e manual_quotes [{date,value}]. Para incluir cotas depois, use portfolio_add_custom_asset_quotes (não recrie o ativo). quote_type=DYNAMIC (indexado): informe index_type (CDI_PERCENT, CDI_PLUS, PRE, IPCA_PLUS, IGPM_PLUS, DOLAR_PLUS, IBOV_PLUS, SP500_BRL_PLUS), rate (110 = 110% CDI; 2 = CDI+2 — taxa está no relatório de movimentações da XP, não no de posições, campos Index / IndexPercentage / Tax), sub_category (LF, LIG, CRI, CRA ou OUTRO, e mesmo esses só se o papel pagar provento em dinheiro — CDB, LCI, LCA, LC e RDB são recusados aqui e vão em :user_rfs), start_date e start_value — a moeda vem do índice. Retorna asset_identifier pronto para create_transaction.
portfolio_create_portfolio
ChatGPTCria uma nova carteira e retorna o portfolio_ref_id para usar nas outras tools. ANTES de criar, PERGUNTE ao usuário: é a carteira PESSOAL dele (PRIME) ou vai na conta Pro/time (PRO)? PRIME: cada usuário só pode ter UMA — se ele já tiver, use a existente. PRO: fica no time. Confirme o nome e o tipo antes de executar.
portfolio_create_transaction
ChatGPTCria uma OU MAIS transações na carteira (array de 1 a 100). Retorna created/failed e, se houver falhas, quais falharam por índice (errors: [{index, message}]). Tipos: BUY, SELL, CUSTODY_TRANSFER, COME_COTAS, TAX_CHARGE. Resolva o ativo com resolve_asset antes — EXCETO renda fixa privada (CDB, LCI, LCA, LC, LF, RDB, CRI, CRA), que não se busca: monte o identificador :user_rfs direto. RENDA FIXA (CDB, LCI, LCA, LC, LF, RDB, CRI, CRA) ENTRA POR AQUI, não como ativo personalizado: o sistema calcula a cotação a partir do índice e do vencimento. Só recorra a ativo personalizado se o papel pagar provento em dinheiro (juros semestrais, amortização), que :user_rfs não registra. Renda fixa (:user_rfs) codifica os metadados no asset_identifier no formato "{percent}|{indexador}|{spread}|{subclasse}|{issuer_id}|{vencimento}:user_rfs" (ex.: 100|cdi|+0|CDB|248|20320201:user_rfs); indexadores: cdi, pre, ipca, igp-m, dolar, ibov, sp500-brl. O IDENTIFICADOR É A IDENTIDADE DO PAPEL: dois lançamentos com a mesma taxa, indexador, subclasse, emissor e vencimento são O MESMO ativo e somam saldo. Busque o emissor real com portfolio_list_issuers antes de usar "OUTROS" — é o emissor que separa papéis parecidos. Em :user_rfs, quantity é o VALOR em reais e price é 1 (o MCP recusa outro price). Ativo personalizado (:custom-asset): crie ANTES com portfolio_create_custom_asset e use o asset_identifier retornado (id UUID) — nunca invente o identificador. PREÇO: sempre que possível, envie price. Se o extrato/planilha do usuário já traz o preço unitário, use-o. Se não traz, PERGUNTE ao usuário: (a) ele informa o preço, (b) você busca a cotação no MCP de dados da Mais Retorno e confirma com ele — nesse caso chame get_quotes com adjusted: false, porque a série padrão é a AJUSTADA, que reinveste provento, amortização e juros e NÃO é o preço que a pessoa pagou; a diferença é grande e cresce com a idade da compra (PETR4 em 01/06/2015: R$ 3,13 ajustada contra R$ 12,37 negociada; a debênture ELET32 em 29/09/2023: R$ 759,13 contra R$ 1.053,20, e é a negociada que a ANBIMA publica) — ou (c) ele prefere que o consolidador busque sozinho. Omitir price é o último caso: o consolidador consulta a cotação de cada ativo/data durante a gravação, o que deixa o lote mais lento e sujeito a falha por tempo. A resposta traz needs_review/issue_flags se ficar pendência — ofereça corrigir com update_transaction/resolve_issues ou desfazer com delete_transaction. A resposta também traz, por linha gravada, institution_name e (renda fixa) issuer_name já resolvidos, com um resumo na primeira linha: CONFIRA contra o extrato antes de lançar o resto. Nome diferente do extrato = id errado; corrija com update_transaction.
portfolio_delete_custom_asset
ChatGPTExclui um ativo personalizado MANUAL ou DYNAMIC que não tem lançamento em nenhuma carteira do time: o cadastro é desativado e sai da listagem (se foi engano, o suporte da Mais Retorno reativa). Ativo de mercado (MARKET) não se exclui por aqui. Antes de excluir, confere o uso: se o ativo tiver lançamento em qualquer carteira do time, recusa sem excluir nada e diz em quais das suas carteiras ele está, com a quantidade de lançamentos, e quantas carteiras de outros membros do time o usam. Nunca apaga lançamento nem posição. Para liberar a exclusão, troque o ativo nesses lançamentos (portfolio_update_transaction) ou apague-os, e tente de novo. Use para limpar ativo duplicado ou criado por engano; veja antes o uso com portfolio_get_custom_asset. Informe o asset_identifier ({uuid}:custom-asset). Confirme com o usuário antes de excluir.
portfolio_delete_custom_asset_income
ChatGPTApaga UM provento lançado num ativo personalizado, pelo income_id que vem em incomes de portfolio_get_custom_asset. Apaga só esta linha, nunca a série inteira, mesmo quando o provento faz parte de uma série (in_series true). Use para tirar provento lançado em duplicidade ou por engano; para corrigir valor ou data, prefira portfolio_update_custom_asset_income. Passe portfolio_ref_ids das carteiras que têm o ativo: o MCP reconsolida cada uma. Confirme com o usuário antes de apagar.
portfolio_delete_transaction
ChatGPTExclui UMA transação pelo ID. Não é possível excluir todas de uma vez.
portfolio_explain_term
ChatGPTExplica em linguagem simples um termo de investimentos (ex.: dividend yield, sharpe, come-cotas, volatilidade, beta). Use quando o usuário não conhecer um termo que apareceu.
portfolio_get_asset_stats
ChatGPTVolatilidade, sharpe, cagr, beta etc. por ativo da carteira, todas as janelas. Sem "assets", devolve até limit ativos (padrão 20, teto 50) e lista os demais em omitted_assets — chame de novo com assets=<essa lista>. Valores em fração decimal (0.12 = 12%), mesma escala do portfolio_get_portfolio_stats. profitability e cagr aqui são o "retorno de mercado do ativo" na janela inteira, não o retorno do cliente: o retorno do cliente por ativo vem de portfolio_get_attribution.
portfolio_get_attribution
ChatGPTRetorno e contribuição de CADA ATIVO em um período (mês, trimestre, ano, qualquer janela): posição inicial e final, movimentação, proventos, ganho em R$, o retorno do ativo em DUAS medidas com nome e a contribuição para o retorno oficial da carteira (contribution). "Rentabilidade no período" (twr): como o ativo performou enquanto o cliente o teve, independente de quanto e quando ele investiu. "Retorno sobre o investido" (return_on_invested): ganho sobre o custo da posição que ainda está em carteira (o ganho realizado em venda parcial fica fora); null em posição aberta significa sem base de cálculo, nunca zero. Em ativo encerrado (is_closed true) vem null porque não sobra posição: use return_brl, o ganho em R$, e não diga "sem base de cálculo". Diga ao cliente qual das duas está mostrando. As contribuições somam o retorno oficial. É DAQUI que sai "quais ativos decidiram o mês": NUNCA monte isso na mão com o peso atual da carteira e a variação de preço — o peso de hoje não é o peso do período e o resultado sai errado. Valores em fração decimal (0.0723 = 7,23%). Quando gross_up_active for true, official_return_gross e os campos *_gross (twr_gross, return_on_invested_gross, contribution_gross) são a versão bruta de imposto que o cliente vê na tela; diga qual das duas está mostrando. indicators traz o CDI e o IPCA do mesmo período para comparar. O cálculo roda no servidor e pode levar alguns segundos; a tool espera por você.
portfolio_get_composition
ChatGPTComposição da carteira por tipo/instituição/estratégia/ativo.
portfolio_get_connected_account
ChatGPTMostra em qual conta da Mais Retorno este conector está conectado (e-mail e nome) e quais planos ela tem: carteiras (pro, prime, suporte ou sem_plano) e dados de mercado. Use quando uma ferramenta recusar por falta de plano, quando o usuário perguntar em qual conta está ou quando as carteiras que aparecem não forem as que ele esperava. Não consome créditos.
portfolio_get_consolidation_status
ChatGPTStatus do job de consolidação da carteira, com a idade do job (current_job_age_minutes) e um status_hint que separa: na fila (espere), rodando (espere), provavelmente travado (mais de 15 min sem terminar; o recuperador automático reagenda), última tentativa sem nada a consolidar (last_job traz o motivo) e pronto para ler. "provavelmente em espera de 30 min após falha" e "só consolida a partir do próximo dia útil" são situações em que esperar não resolve. Leia o status_hint antes de decidir se espera ou se mostra números.
portfolio_get_custom_asset
ChatGPTLê um ativo personalizado pelo asset_identifier ({uuid}:custom-asset, vindo de portfolio_list_custom_assets). Só lê, não altera nada. Devolve o cadastro (nome, ticker, classe, moeda, tipo de cota, vencimento, se é compartilhado no time e a data da última cota) e as cotas gravadas. Use para conferir o que foi gravado e para ver a série antes de corrigir ou completar cotas com portfolio_add_custom_asset_quotes. Para corrigir nome, classe ou vencimento, use portfolio_update_custom_asset. get_quotes não aceita ativo :custom-asset: a cota de ativo personalizado se lê aqui. As cotas vêm da mais recente para a mais antiga, paginadas por quotes_limit (padrão 100, máx. 2.000) e quotes_offset (padrão 0); quotes_total diz quantas existem. Ativo DYNAMIC (indexado) não tem cota manual: a cota vem do índice. Traz também os proventos lançados (incomes: income_id, payment_date, type, value, last_date_prior e in_series, que diz se o provento faz parte de uma série recorrente), do mais recente para o mais antigo, paginados por incomes_limit (padrão 100, máx. 1.000) e incomes_offset (padrão 0); incomes_total diz quantos existem. value é o valor bruto, antes de imposto. Para corrigir um provento, use portfolio_update_custom_asset_income com o income_id; para apagar, portfolio_delete_custom_asset_income. Ativo excluído vem com deleted: true e um hint: não grave cota, provento ou lançamento nele; o uso não é consultado. Traz também o uso (include_usage, padrão true; passe false ao paginar cotas): as carteiras que o usuário administra e que têm lançamento do ativo, com a quantidade de lançamentos e a posição (OPEN aberta, ZEROED zerada), e em other_portfolios só a contagem das carteiras de outros membros do time. Veja o uso antes de excluir o ativo com portfolio_delete_custom_asset, que só exclui ativo sem lançamento; o portfolio_ref_id de cada carteira listada serve em portfolio_ref_ids de portfolio_add_custom_asset_quotes. Só quem pode excluir o ativo vê o uso: para os demais, ou se o serviço de carteiras falhar, usage.available vem false com o motivo, e o cadastro e as cotas vêm normalmente.
portfolio_get_income
ChatGPTDividendos e proventos da carteira. status: paid=recebidos, provisioned=provisionados (a receber), upcoming=data com próxima. Omitido = todos. period: monthly | yearly agrega por período; omitido = série completa sem agregação.
portfolio_get_income_by_asset
ChatGPTProventos acumulados por ativo com DY e YoC. period: 12/24/48 meses, mtd (mês corrente) ou ytd (ano corrente).
portfolio_get_income_by_year
ChatGPTGrade de proventos ano→mês, com total e média por ano. yield: dy (dividend yield, sobre o saldo) ou yoc (yield on cost, sobre o custo inicial).
portfolio_get_income_grouped
ChatGPTProventos agregados por período (monthly/quarterly/semiannual/annual), opcionalmente agrupados por tipo de ativo ou por ativo. Retorna também total e DY (12 meses).
portfolio_get_networth
ChatGPTPatrimônio atual e resumo da carteira (patrimônio, aportes, custo, retorno). Por padrão NÃO traz a série diária (pode ter milhares de pontos e estourar o contexto) — passe include_series=true só se realmente precisar dela; para gráficos use portfolio_get_networth_history com granularidade.
portfolio_get_networth_history
ChatGPTSérie de patrimônio por período. daily exige month (YYYY-MM); monthly aceita year; end_date corta o fim.
portfolio_get_portfolio
ChatGPTDados básicos da carteira e filhos de grupo.
portfolio_get_portfolio_stats
ChatGPTMétricas de risco/retorno no nível da carteira (sharpe, sortino, treynor, volatilidade, beta, tracking error, jensen alpha, melhor/pior mês) por janela de tempo (last_3_months … last_60_months, ytd, mtd, begin). Retorna todas as janelas de uma vez. Ao apresentar, explique os termos em linguagem simples (use portfolio_explain_term se precisar).
portfolio_get_preferences
ChatGPTLê as preferências de cálculo da carteira (gross_up, gross_up_mode, come_cotas). Cada chave vem anotada com "source": "team" (herdada da configuração do time) ou "custom" (definida nesta carteira). Quando a origem é "team", ela PREVALECE — a configuração do time vence a da carteira. Chame antes de portfolio_update_preferences para mostrar o valor atual ao usuário.
portfolio_get_returns
ChatGPTRentabilidade da carteira. granularity: monthly (padrão, compacto) | yearly | daily (série ponto a ponto, longa — só se precisar).
portfolio_list_brokers
ChatGPTLista corretoras/custodiantes (id + nome). O id daqui é o institution_id da transação: quem CUSTODIA o ativo. NÃO serve como issuer_id do :user_rfs — são numerações diferentes do mesmo cadastro (Banco Master é 254 aqui e 253 como emissor); para o emissor use portfolio_list_issuers. Nunca chute o número pelo nome: busque aqui. Use "search" para achar uma pelo nome (são centenas). Máx. 100 por vez (padrão 50).
portfolio_list_custom_assets
ChatGPTLista os ativos personalizados do usuário (os dele + os compartilhados no time). Consulte SEMPRE antes de criar um novo: o asset_identifier retornado pode ser reusado em outra carteira sua, então o mesmo papel não precisa ser recriado por cliente. Use apenas identificadores que vieram desta lista. "search" filtra por trecho do nome ou do ticker, sem diferenciar maiúsculas e acentos; consulte antes de criar um ativo novo para não duplicar. Com search, cada item traz search_match: "contains" (o nome ou o ticker contém o termo) ou "similar" (só parecido, tolerância a erro de digitação). Antes de reaproveitar um "similar", confirme com o usuário que é o mesmo ativo (série, vencimento). Retorna id, asset_identifier, nome, classe, moeda e tipo de cota. Para cotas e uso de um ativo, use portfolio_get_custom_asset. Para corrigir nome, classe ou vencimento, use portfolio_update_custom_asset; para excluir um ativo sem lançamentos, portfolio_delete_custom_asset.
portfolio_list_issuers
ChatGPTLista os emissores de renda fixa (id + nome) para preencher o issuer_id do asset_identifier ":user_rfs". PROCURE o emissor real antes de recorrer a "OUTROS": o emissor faz parte da identidade do papel, então dois papéis com a mesma taxa, subclasse e vencimento lançados sob "OUTROS" viram O MESMO ativo e se misturam. O id daqui é o issuer_id que vai DENTRO do identificador :user_rfs: quem EMITIU o papel. NÃO serve como institution_id da transação — são numerações diferentes do mesmo cadastro (Banco Voiter é 254 aqui e 255 como corretora); para o custodiante use portfolio_list_brokers. Use "search" pelo nome (são centenas). Máx. 100 por vez (padrão 50).
portfolio_list_issues
ChatGPTLista as pendências/inconsistências das carteiras, agrupadas por tipo. Cada grupo traz issue_type, match_key (use como match_criteria em resolve_issues), severity, count, suggested_actions e sample_transactions. Filtre por carteira com portfolio_ref_ids.
portfolio_list_my_portfolios
ChatGPTLista as carteiras que você pode acessar (próprias, do time e compartilhadas). Use "search" para filtrar pelo nome quando houver muitas. Retorna no máximo 100 por vez (padrão 50) com total e um aviso se houver mais.
portfolio_list_transactions
ChatGPTLista transações da carteira com filtros. Use needs_review=true ou has_issues=true para achar pendências. Por padrão só retorna aprovadas (is_approved). Limite máximo 200.
portfolio_resolve_asset
ChatGPTBusca LITERAL por ticker/código/CNPJ (não é semântica: "Petrobras debênture" não resolve — use "petr26"). Retorna o identificador exato (ex.: petr4:b3, 33000167000101:fi) para create_transaction. RENDA FIXA PRIVADA (CDB, LCI, LCA, LC, LF, RDB, CRI, CRA) NÃO SE BUSCA: não está no catálogo e vai direto em portfolio_create_transaction com identificador :user_rfs — não chame esta tool para ela. Classes SEM cobertura de resolução: COE, CRA/CRI sem o código :sec, fundos por código interno (use o CNPJ). Para essas, crie com custom-asset. Se vier vazio, NÃO é erro de busca em toda vez — pode ser classe não coberta; não fique tentando variações do nome. Prefixo de tipo — DEB, FII, ETF, BDR — é removido automaticamente da consulta.
portfolio_resolve_issues
ChatGPTGRAVA na carteira: reescreve as transações de um grupo de pendências em lote (corretora, ativo, preço, quantidade ou data) ou marca o grupo como ignorado. Depois da chamada as pendências somem de list_issues e patrimônio, retornos e composição da carteira são recalculados com os dados novos; não há como desfazer em lote. Passe o issue_type e o match_criteria vindos de list_issues. Para corrigir, informe corrections (institution_id | asset_identifier | price_local | reference_quantity | date). Para ignorar, use status=IGNORED sem corrections. Confirme com o usuário antes de executar. Requer conta Pro com time.
portfolio_update_custom_asset
ChatGPTEdita o cadastro de um ativo personalizado: nome, classe e vencimento. Informe o asset_identifier ({uuid}:custom-asset, vindo de portfolio_list_custom_assets) e ao menos um dos três campos; o que não for enviado não muda. due_date: null apaga o vencimento. Mudar o vencimento recalcula os resgates derivados dele, e as carteiras reconsolidam sozinhas. Ticker, moeda, tipo de cota e compartilhamento não mudam por aqui, nem a classe para "Renda Fixa" (exige a subclasse, só pelo app); cotas se gravam com portfolio_add_custom_asset_quotes. Use para corrigir o cadastro em vez de criar um ativo novo. Confirme a mudança com o usuário antes de gravar.
portfolio_update_custom_asset_income
ChatGPTCorrige UM provento já lançado num ativo personalizado, pelo income_id que vem em incomes de portfolio_get_custom_asset. Envie só o que muda, pelo menos um campo; o que não for enviado fica como está. Mesmos campos e tipos de portfolio_add_custom_asset_incomes: value, payment_date, type (RENDIMENTO ou AMORTIZACAO) e last_date_prior (a data-com). Altera só esta linha, mesmo quando o provento faz parte de uma série (in_series true). Use para corrigir valor ou data em vez de lançar de novo: lançar a mesma data com outro valor cria um segundo provento, que soma com o primeiro. Passe portfolio_ref_ids das carteiras que têm o ativo: o MCP reconsolida cada uma. Confirme a mudança com o usuário antes de gravar.
portfolio_update_preferences
ChatGPTAltera preferências de cálculo da carteira: gross_up, gross_up_mode (fixed/regressive) e come_cotas. Informe ao menos uma. LEIA com portfolio_get_preferences antes de gravar e explique o efeito ao usuário em uma frase — se a origem for "team", a mudança pode não ter efeito. come_cotas: false APAGA os lançamentos de come-cotas criados pelo sistema; confirme com o usuário antes de enviar. Mudança de gross_up reconsolida sozinha; come_cotas não — chame portfolio_consolidate depois.
portfolio_update_transaction
ChatGPTEdita campos de uma transação existente (ex.: corrigir ativo ou instituição de uma pendência).
search_assets
ChatGPTSearch for financial assets by name, ticker, or CNPJ. Returns matching assets with their identifiers. Free.