Referência das ferramentas do MCP Pro
O conector da Rica Pro mostra 169 ferramentas. Hoje, 91 funcionam: 58 consultas e 33 alterações. As outras 78 aparecem no Claude ou no ChatGPT, mas respondem executada: false. Nos pedidos, não é preciso citar nomes de ferramentas. Os nomes servem para conferir o que o aplicativo usou.
Toda ferramenta exige assinatura ativa da Rica Pro. As ferramentas de cliente pedem o identificador do cliente (clienteUsuarioId) devolvido por listar_clientes.
Consultas (clientes:read)
Carteira
| Ferramenta | O que devolve |
|---|---|
listar_clientes | Clientes da carteira, com nome, e-mail mascarado e pessoas. |
obter_cliente | Um cliente da carteira. |
listar_estruturas_planejador | Estruturas dos clientes da carteira. |
obter_sessao_cliente | Resumo do cliente escolhido. |
Estrutura do cliente
| Ferramenta | O que devolve |
|---|---|
listar_pessoas_cliente | Pessoas da estrutura. |
listar_projetos_cliente | Projetos. |
listar_contas_cliente | Contas. |
listar_cartoes_cliente | Cartões de crédito. |
listar_categorias_cliente | Categorias. |
listar_conceitos_categoria_cliente | Conceitos de uma categoria. |
obter_uso_taxonomia_cliente | Quantidade, limite e saldo de categorias e caixas. |
listar_caixas_cliente | Caixas e categorias relacionadas. |
listar_lancamentos_cliente | Lançamentos do mais recente ao mais antigo, 200 por padrão e até 500, com filtro por pessoa, projeto, conta ou categoria. Sem filtro de data. Traz a versão usada nas edições. |
listar_investimentos_cliente | Investimentos manuais e importados, sem o conteúdo bruto da fonte. |
listar_objetivos_cliente | Objetivos, financeiros ou não. |
listar_realizacoes_cliente | Realizações, com resultado e processo. |
listar_metas_cliente | Metas. Nas de hábito, vezes por ciclo, nota e sequência. |
listar_ciclos_cliente | Ciclos das metas financeiras. |
listar_projecoes_cliente | Projeções patrimoniais. |
listar_documentos_cliente | Dados de cadastro dos documentos, sem o arquivo. |
listar_anexos_cliente | Dados de cadastro dos anexos, sem senha e sem link. |
listar_openfinance_cliente | Conexões Open Finance, sem tokens. |
listar_b3_cliente | Autorizações B3, com documento mascarado. |
listar_agentes_cliente | Agentes do cliente com texto, pessoas e acontecimentos, sem histórico. |
listar_lembretes_cliente | Lembretes do cliente. |
Análises
| Ferramenta | O que devolve |
|---|---|
analisar_fluxo_caixa_cliente | Totais mensais de entradas, saídas e outros tipos. |
analisar_categorizacao_cliente | Totais por categoria. |
analisar_distribuicao_cliente | Saldo por caixa: entradas, investimentos e provisões somam; saídas descontam; circulares ficam fora. |
analisar_patrimonio_cliente | Retrato do patrimônio consolidado. |
analisar_protecao_renda_cliente | O mesmo retrato de analisar_patrimonio_cliente. |
listar_previdencia_social_cliente | Análises previdenciárias cadastradas. |
obter_matriz_previdenciaria_cliente, analisar_cnis_cliente, analisar_restituicao_cliente, analisar_otimizacao_prolabore_cliente | A mesma lista de listar_previdencia_social_cliente. Não refazem cálculos. |
Consultoria
| Ferramenta | O que devolve |
|---|---|
listar_contatos_consultoria | Contatos. |
listar_pipeline_consultoria | Contatos e atendimentos do pipeline. |
listar_atendimentos_consultoria | Atendimentos dos agentes de Marketplace. |
listar_agentes_consultoria | Agentes ligados à sua conta. |
listar_lembretes_consultoria | Seus lembretes. |
Conta e catálogos
| Ferramenta | O que devolve |
|---|---|
obter_conta_planejador | Dados da sua conta profissional. |
listar_assinaturas_planejador | Assinaturas, sem dados de pagamento. |
obter_configuracao_usuario_planejador | Preferências. |
obter_aparencia_planejador | O mesmo de obter_configuracao_usuario_planejador. |
listar_catalogo_categorias_planejador | Categorias do catálogo. |
listar_conceitos_categoria_catalogo_planejador | Conceitos de uma categoria do catálogo. |
listar_catalogo_caixas_planejador | Caixas do catálogo. |
listar_catalogo_templates_planejador | Templates. |
listar_tipos_planejador | Tipos configurados. |
Marketplace e Office
| Ferramenta | O que devolve |
|---|---|
listar_lojas_planejador | Lojas. |
listar_ofertas_planejador | Ofertas com valor, situação e validade. |
listar_paginas_loja_planejador | Páginas e seções das lojas. |
listar_linhas_virtuais_planejador | Linhas virtuais, com número mascarado. |
listar_contas_whatsapp_planejador | Contas WhatsApp Business. |
listar_chats_atendimento_planejador | O mesmo de listar_atendimentos_consultoria. |
listar_afiliados_office | Vínculos de afiliados. |
listar_filiadas_office | A mesma lista de listar_afiliados_office. |
obter_indicadores_atividade_office | Usuários, ativos em 30 dias, clientes, afiliados e filiadas. Só para o responsável pelo Office. |
Alterações (clientes:write)
As ferramentas marcadas com “sim” na coluna Confirmação exigem confirmar: true.
Lançamentos do cliente
| Ferramenta | O que faz | Confirmação |
|---|---|---|
criar_lancamento_cliente | Cria lançamento com conta, nome, valor e tipo. Aceita parcelas (2 a 48) e recorrência. | não |
atualizar_lancamento_cliente | Muda só os campos enviados. Usa a versão para evitar sobrescrever outra mudança. | não |
remover_lancamento_cliente | Remove só o lançamento indicado. | sim |
Objetivos, realizações e metas do cliente
| Ferramenta | O que faz | Confirmação |
|---|---|---|
criar_objetivo_cliente | Cria objetivo financeiro ou não financeiro. | não |
atualizar_objetivo_cliente | Muda nome, descrição e pessoas. | não |
remover_objetivo_cliente | Remove com realizações, metas e marcações. | sim |
criar_realizacao_cliente | Cria resultado e processo num objetivo. | não |
atualizar_realizacao_cliente | Muda resultado ou processo. | não |
remover_realizacao_cliente | Remove com as metas do processo. | sim |
criar_meta_cliente | Cria meta financeira (valor e caixas) ou de hábito (vezes por ciclo). | não |
atualizar_meta_cliente | Muda a meta; na financeira, refaz os ciclos. | não |
remover_meta_cliente | Remove com ciclos, avisos ou marcações. | sim |
Taxonomia do cliente
| Ferramenta | O que faz | Confirmação |
|---|---|---|
criar_categoria_cliente | Cria categoria. | não |
atualizar_categoria_cliente | Muda nome, cor e conceitos. | não |
remover_categoria_cliente | Remove e desfaz ligações com lançamentos, caixas e agentes. | sim |
criar_conceito_categoria_cliente | Cria conceito numa categoria. | não |
atualizar_conceito_categoria_cliente | Muda um conceito. | não |
remover_conceito_categoria_cliente | Remove um conceito. | sim |
criar_caixa_cliente | Cria caixa com categorias do cliente. | não |
atualizar_caixa_cliente | Muda a caixa e as categorias dela. | não |
remover_caixa_cliente | Remove e desfaz ligações com metas e investimentos manuais. | sim |
Catálogo da consultoria
| Ferramenta | O que faz | Confirmação |
|---|---|---|
criar_categoria_catalogo_planejador | Cria categoria no catálogo. | não |
atualizar_categoria_catalogo_planejador | Muda categoria do catálogo. | não |
remover_categoria_catalogo_planejador | Remove e tira das caixas do catálogo. | sim |
criar_conceito_categoria_catalogo_planejador | Cria conceito. | não |
atualizar_conceito_categoria_catalogo_planejador | Muda conceito. | não |
remover_conceito_categoria_catalogo_planejador | Remove conceito. | sim |
criar_caixa_catalogo_planejador | Cria caixa com categorias do catálogo. | não |
atualizar_caixa_catalogo_planejador | Muda a caixa e as categorias dela. | não |
remover_caixa_catalogo_planejador | Remove e tira dos templates. | sim |
criar_template_catalogo_planejador | Cria template com caixas do catálogo. | não |
atualizar_template_catalogo_planejador | Muda o template e as caixas dele. | não |
remover_template_catalogo_planejador | Remove o template. | sim |
Ainda não disponíveis
Estas ferramentas respondem executada: false com o motivo. Faça a ação na Rica Pro.
Ver as 78 ferramentas que ainda não executam
Do cliente (28): criar_, atualizar_ e remover_ com pessoa_cliente, projeto_cliente, conta_cliente, cartao_cliente, investimento_cliente, projecao_cliente, documento_cliente e anexo_cliente; gerar_link_openfinance_cliente, remover_openfinance_cliente, configurar_link_b3_cliente e sincronizar_b3_cliente.
Da consultoria (48): criar_, atualizar_ e remover_ com contato_consultoria, convite_consultoria, mensagem_consultoria, atendimento_consultoria, agente_consultoria, feedback_consultoria, lembrete_consultoria, loja_planejador, oferta_planejador, pagina_loja_planejador, secao_pagina_loja_planejador, linha_virtual_planejador, conta_whatsapp_planejador e agente_atendimento_planejador; reiniciar_catalogo_categorias_planejador, reiniciar_catalogo_caixas_planejador, reiniciar_catalogo_templates_planejador, criar_upload_sas_planejador, criar_cobranca_planejador e enviar_mensagem_whatsapp_planejador.
Fontes de mercado (2): consultar_bcb e consultar_anbima.
Se o aplicativo disser que fez uma dessas ações, peça para mostrar a resposta da ferramenta. Com executada: false, nada mudou.
Formato das respostas e erros
As respostas trazem tipo e dados. Erros de validação voltam com codigo e mensagem, sem gravar parte da mudança. Os códigos de taxonomia estão em categorias, conceitos, caixas e templates e os de lançamentos em lançamentos, objetivos e metas.