O cliente inicia o fluxo via /oauth/authorize, faz login e consente com os produtos desejados. O Authorization Server emite um authorization code que é trocado por tokens em /oauth/token. O access token (JWT Bearer) é enviado em cada chamada ao /mcp. O refresh token renova o access token sem novo login enquanto estiver dentro do prazo.
Prompts são instruções de alto nível autoradas no backoffice. Eles não aparecem na lista de tools:
o cliente os descobre via prompts/list e os usa via prompts/get sobre /mcp.
No Claude Code aparecem como slash commands (/mcp__<servidor>__<nome>);
em clientes com seletor de prompt (Claude Desktop / claude.ai) aparecem no menu de prompts do servidor.
diagnosticar_acesso
Diagnostica problemas de OAuth, consentimento e pacote requerido.
Ajude a diagnosticar erro de acesso no MCP. Verifique token OAuth, consentimento de produto, requiredPackages, cfid e mensagens de erro. Sugira passos observaveis e evite expor dados sensiveis.
| Argumento | Descrição | Obrigatório |
|---|---|---|
erro | Erro ou sintoma observado no cliente MCP. | sim |
resumir_resultado
Resume respostas grandes de tools preservando campos importantes.
Receba ou peca o resultado de uma tool e gere resumo curto. Preserve IDs, datas, status, erros e proximas acoes. Se o resultado for grande, proponha filtros antes de nova chamada para economizar tokens.
| Argumento | Descrição | Obrigatório |
|---|---|---|
resultado | Resultado de tool ou trecho a resumir. | sim |
explicar_limites
Explica limites operacionais e de seguranca do MCP Valemobi.
Explique os limites do MCP usando resources quando disponiveis: autenticacao, consentimento, tools destrutivas, dados sensiveis, rate limit e economia de tokens. Nao invente permissao ou endpoint ausente.
roteiro_primeiro_uso
Guia curto para o primeiro uso Valemobi.
Leia valemobi://mcp/onboarding e valemobi://mcp/service-catalog. Monte um roteiro em ate 6 passos para o usuario comecar. Nao mencione resources/list, prompts/list, nomes de tools ou termos tecnicos; traduza capacidades em saldo, gastos, patrimonio, metas, graficos e carteira. So sugira consultas de leitura quando houver objetivo, produto e permissao claros.
mapear_fluxo_produto
Mapeia um fluxo de produto para resources, prompts e tools.
Para um produto ou jornada, organize quais resources explicam contexto, quais prompts guiam o usuario e quais tools executam APIs. Priorize fluxo incremental e baixo consumo de tokens.
| Argumento | Descrição | Obrigatório |
|---|---|---|
produto | Produto ou jornada que sera mapeada. | sim |
explorar_capacidades
Lista capacidades disponiveis sem carregar contexto excessivo.
Ajude o usuario a descobrir capacidades do MCP com baixo consumo de tokens. Comece pelos resources valemobi://mcp/onboarding e valemobi://mcp/service-catalog, depois agrupe prompts e tools por objetivo.
escolher_tool
Ajuda a escolher uma tool MCP segura para um objetivo.
Leia valemobi://mcp/tool-guidelines. Dado um objetivo do usuario, compare as tools disponiveis pelo nome, descricao, produto, readOnlyHint e destructiveHint. Recomende no maximo tres opcoes e explique quais parametros confirmar antes de chamar a API.
| Argumento | Descrição | Obrigatório |
|---|---|---|
objetivo | Objetivo do usuario ou tarefa a resolver. | sim |
montar_chamada_api
Monta uma chamada de API MCP com parametros claros.
Leia valemobi://mcp/tool-guidelines e valemobi://mcp/token-policy. Converta o objetivo do usuario em uma chamada MCP. Antes de executar, confirme produto, permissao, schema de entrada e campos obrigatorios. Se faltar contexto, leia resources relevantes em vez de listar tudo.
| Argumento | Descrição | Obrigatório |
|---|---|---|
objetivo | Objetivo de negocio da chamada. | sim |
me_comece_aqui
Guia o primeiro uso do Minhas Economias com baixo consumo de contexto.
Leia valemobi://mcp/minhas-economias/comece-aqui, valemobi://mcp/minhas-economias/jornadas e valemobi://mcp/minhas-economias/seguranca. Entenda o objetivo do usuario e responda em ate 5 passos, citando caminhos de saldo, gastos e patrimonio quando o usuario pedir capacidades gerais, sempre priorizando consultas de leitura. Se a capacidade necessaria nao estiver disponivel neste atendimento, explique que nao consegue consultar ou salvar essa informacao por aqui agora, nao simule dados e ofereca planejamento ou preparacao segura.
| Argumento | Descrição | Obrigatório |
|---|---|---|
objetivo | Objetivo inicial do usuario, quando ja estiver claro. | não |
tm_fundos_descoberta
Guia a descoberta inicial de fundos no TradeMap por nome, CNPJ, classe, gestora e instituicao.
Voce esta ajudando um investidor a descobrir fundos no TradeMap. Use perguntas simples para obter filtro quando faltar criterio. Priorize busca por nome, CNPJ, classe, gestora ou instituicao. Explique filtros usados, limites dos dados e proximos passos. Nao recomende compra.
tm_fundos_analise
Orienta analise individual de fundo com rentabilidade, cotas, carteira, documentos e drawdown.
Analise o fundo informado com base apenas nos dados retornados pelas tools. Combine cadastro, rentabilidade, cotas, carteira, documentos e drawdown quando disponiveis. Separe fatos de inferencias. Mostre pontos fortes, riscos, dados faltantes e proximos passos. Nao recomende compra ou venda.
tm_renda_fixa_orientacao
Orienta pesquisa e comparacao de renda fixa no TradeMap.
Oriente o investidor em renda fixa usando ranking, busca, detalhe, custodia e simulacao quando disponiveis. Compare indexador, taxa, vencimento, emissor, liquidez, investimento minimo e risco. Trate simulacoes como cenarios, nao promessa de rentabilidade. Mascare identificadores sensiveis em custodia.
me_resumo_financeiro
Monta um resumo financeiro seguro com saldo, gastos, fluxo, patrimonio e dividas.
Leia valemobi://mcp/minhas-economias/jornadas, valemobi://mcp/minhas-economias/comece-aqui, valemobi://mcp/minhas-economias/patrimonio e valemobi://mcp/minhas-economias/seguranca. Confirme ou assuma periodo declarado. Use a menor combinacao de consultas read-only para saldo, gastos, entradas, saidas, patrimonio e dividas. Responda com premissas, lacunas e no maximo tres proximos passos. Se a capacidade necessaria nao estiver disponivel neste atendimento, explique que nao consegue consultar ou salvar essa informacao por aqui agora, nao simule dados e ofereca planejamento ou preparacao segura.
| Argumento | Descrição | Obrigatório |
|---|---|---|
periodo | Periodo desejado, como hoje, mes atual, 30d ou intervalo. | não |
nivel_detalhe | resumo ou detalhado. | não |
me_gastos_e_categorias
Analisa gastos por periodo, categoria, tag e membro sem listar dados demais.
Leia valemobi://mcp/minhas-economias/jornadas, valemobi://mcp/minhas-economias/gastos e valemobi://mcp/minhas-economias/seguranca. Confirme periodo. Comece por resumo/agregado; use transacoes detalhadas somente se necessario. Responda com top itens, valor total, premissas e uma conclusao curta. Para possibilidade de compra, trate como estimativa e cite lacunas. Se a capacidade necessaria nao estiver disponivel neste atendimento, explique que nao consegue consultar ou salvar essa informacao por aqui agora, nao simule dados e ofereca planejamento ou preparacao segura.
| Argumento | Descrição | Obrigatório |
|---|---|---|
periodo | Periodo de analise. Se ausente, usar mes atual declarando premissa. | não |
categoria | Categoria, tag ou membro para filtrar. | não |
valor_planejado | Valor de uma compra ou gasto planejado. | não |
me_patrimonio_e_dividas
Explica patrimonio, bens, investimentos, saldos e dividas com premissas.
Leia valemobi://mcp/minhas-economias/jornadas, valemobi://mcp/minhas-economias/patrimonio e valemobi://mcp/minhas-economias/seguranca. Priorize composicao/resumo quando existir. Separe saldos, bens, investimentos e dividas. Nao de recomendacao financeira personalizada; informe dados, premissas e lacunas. Se a capacidade necessaria nao estiver disponivel neste atendimento, explique que nao consegue consultar ou salvar essa informacao por aqui agora, nao simule dados e ofereca planejamento ou preparacao segura.
| Argumento | Descrição | Obrigatório |
|---|---|---|
periodo | Data ou periodo de referencia. | não |
foco | patrimonio, dividas, investimentos, bens ou composicao. | não |
me_metas_e_planejamento
Planeja metas e possibilidade de compra sem prometer persistencia inexistente.
Leia valemobi://mcp/minhas-economias/jornadas, valemobi://mcp/minhas-economias/metas, valemobi://mcp/minhas-economias/gastos e valemobi://mcp/minhas-economias/seguranca. Confirme objetivo, valor e prazo. Use saldo, gastos recentes, dividas e faturas disponiveis para estimar contribuicao mensal, folga, premissas e risco. Se ainda nao houver acao disponivel para salvar metas, diga que consegue planejar a meta na conversa, mas nao salvar no produto. Se a capacidade necessaria nao estiver disponivel neste atendimento, explique que nao consegue consultar ou salvar essa informacao por aqui agora, nao simule dados e ofereca planejamento ou preparacao segura.
| Argumento | Descrição | Obrigatório |
|---|---|---|
objetivo | Objetivo financeiro ou compra planejada. | sim |
valor | Valor alvo ou valor da compra. | não |
prazo | Prazo desejado. | não |
me_lancamento_com_confirmacao
Prepara criacao, edicao ou exclusao no Minhas Economias com confirmacao.
Leia valemobi://mcp/minhas-economias/jornadas, valemobi://mcp/minhas-economias/seguranca e valemobi://mcp/acao-segura. Para criar, editar ou excluir transacao, primeiro monte um resumo com acao, valor, data, conta/cartao, categoria, descricao e impacto. Se faltar identificador ou houver ambiguidade, localize candidatos e peca escolha. So execute apos confirmacao explicita. Se a capacidade necessaria nao estiver disponivel neste atendimento, explique que nao consegue consultar ou salvar essa informacao por aqui agora, nao simule dados e ofereca planejamento ou preparacao segura.
| Argumento | Descrição | Obrigatório |
|---|---|---|
acao | criar, editar ou excluir. | sim |
valor | Valor envolvido, quando aplicavel. | não |
data | Data do lancamento. | não |
descricao | Descricao ou texto usado para localizar o item. | não |
id_transacao | Identificador da transacao quando conhecido. | não |
tm_comece_aqui
Guia o uso inicial do TradeMap para investidores.
Leia valemobi://mcp/trademap/comece-aqui. Identifique se o usuario quer carteira, mercado, grafico ou analise de ativo. Priorize contexto read-only e deixe claro que respostas sao informativas.
tm_fundos_comparacao
Orienta comparacao simetrica de fundos com metricas e riscos.
Use apenas os recursos e ferramentas MCP autorizados para atender ao pedido. Se a ferramenta adequada nao estiver disponivel, informe a indisponibilidade sem sugerir detalhes internos.
tm_ordens_consulta
Orienta consulta somente leitura de corretoras e ordens no TradeMap.
Consulte ordens somente em modo leitura. Nunca envie, altere ou cancele ordem. Use periodo explicito e consulte corretoras quando a pergunta nao informar corretora. Agrupe por status, corretora, ativo e data quando fizer sentido. Se houver erro de tool, explique o erro sem inventar ordens.
tm_renda_variavel_analise_ativo
Orienta analise informativa de ativo de renda variavel no TradeMap.
Analise o ativo com dados cadastrais, demonstrativos, eventos, setor, pares e indicadores disponiveis. Separe dados retornados pelas tools de inferencias. Explique riscos, qualidade dos dados e lacunas. Nao diga comprar, vender ou manter como recomendacao final.
rt_ordens_consulta
Orienta consulta read-only de ordens Rocket usando apenas RT_Ordens_Corretoras e RT_Ordens_Paginadas.
Use primeiro o resource valemobi://mcp/rocket/ordens/consulta. Em contexto Rocket, nunca use Ordens_Corretoras nem Ordens_Paginadas; use somente RT_Ordens_Corretoras e RT_Ordens_Paginadas. Liste corretoras com RT_Ordens_Corretoras e consulte RT_Ordens_Paginadas para cada corretora no periodo pedido. Para ano corrente em 2026, use 20260101 como inicio e a data atual como fim. Considere apenas ordens executadas ou parcialmente executadas, pagine com limite defensavel, nao peca corretora ou data antes de tentar descobrir pelas tools, nao crie/altere/cancele ordens e mascare identificadores sensiveis.
rt_performance_consulta
Orienta consulta read-only do relatório de performance Rocket com identidade derivada da sessão e volume controlado.
Antes da consulta, leia valemobi://mcp/rocket/performance. Consulte o relatório Rocket somente em modo leitura para o período {{periodo}}, modalidade {{modalidade}}, ativo {{ativo}} e uso de taxas {{com_taxas}}. Nunca solicite nem envie account ou id_investor. Se a corretora não estiver clara, use RT_Ordens_Corretoras quando disponível e peça escolha se houver mais de uma opção; então chame RT_Performance_Relatorio com filtros explícitos, page=0 e size=25. Explique os filtros e as métricas, diferencie resposta vazia de indisponibilidade, masque identificadores sem utilidade, informe antes de buscar muitas páginas e não recomende comprar, vender ou operar.
| Argumento | Descrição | Obrigatório |
|---|---|---|
periodo | Data inicial e final desejadas. | sim |
modalidade | CONSOLIDATED, DAY_TRADE ou SWING_TRADE. | sim |
ativo | TOTAL ou ticker específico. | não |
com_taxas | true para incluir taxas; false para visão sem taxas. | sim |
rt_cotacao_preco
Orienta cotacao Rocket e encaminha pedidos de grafico exclusivamente para o grafico MCP RocketTrader.
Para pedidos de preco ou cotacao sem grafico, use o resource valemobi://mcp/rocket/cotacao-preco e a tool RT_CotacaoHistoricoPreco. Se o usuario pedir grafico, candle, abrir na tela ou visualizar WINFUT ou outro ativo, nao use RT_CotacaoHistoricoPreco diretamente: chame primeiro abrir_grafico_candle_ao_vivo e mostre somente a UI RocketTrader/TradeMap devolvida pela propria tool. Nunca use TradingView, site externo, iframe de terceiros, biblioteca de grafico ou grafico montado manualmente. Para suporte e resistencia no grafico aberto, use editar_grafico_candle_ao_vivo na mesma session_ref com action=apply_study e study.type=support_resistance; nao reabra o grafico nem consulte o historico novamente. Para cotacao simples de ativo conhecido, use cd_stock, id_exchange=1, group_method=MINUTE, group_factor=1, limit pequeno e direction=desc; use vl_close do candle mais recente. Se a tool falhar ou vier vazia, informe indisponibilidade. Last_price de ordens so pode aparecer como fallback sinalizado, nunca como cotacao primaria. Nao execute ordens.
tm_grafico_e_analise
Abre o grafico oficial RocketTrader/TradeMap via MCP Apps e aplica analises no mesmo painel.
Use apenas os recursos e ferramentas MCP autorizados para atender ao pedido. Se a ferramenta adequada nao estiver disponivel, informe a indisponibilidade sem sugerir detalhes internos.
criar_grafico_historico
Abre grafico historico oficial RocketTrader/TradeMap pela tool MCP nativa, sem TradingView ou renderizador externo.
Use apenas os recursos e ferramentas MCP autorizados para atender ao pedido. Se a ferramenta adequada nao estiver disponivel, informe a indisponibilidade sem sugerir detalhes internos.
| Argumento | Descrição | Obrigatório |
|---|---|---|
objetivo | Objetivo do grafico que o usuario quer criar. | sim |
produto | Produto ou contexto dos dados, como TradeMap, MinhasEconomias ou Rocket. | não |
periodo | Intervalo historico desejado, por exemplo 30d, 6m, 2025-01-01 a 2025-12-31. | não |
agrupamento | Granularidade dos dados, como diario, semanal, mensal ou intraday. | não |
indicadores | Indicadores solicitados, separados por virgula. | não |
desenhos | Desenhos ou overlays solicitados, separados por virgula. | não |
Resources são documentos curtos lidos via resources/list e resources/read.
Use-os para orientar o cliente antes de carregar schemas grandes ou executar tools.
Nenhum resource publicado.