Koko Credit card assistant

Servidor MCP para acessar os fluxos de trabalho de cartão de crédito da Koko, permitindo pesquisar, comparar e otimizar cartões de crédito.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP KoKo Finance

Um servidor MCP hospedado para aconselhamento de cartões de crédito com IA. Pesquise mais de 100 cartões de crédito dos EUA, compare opções lado a lado, analise a saúde do portfólio e receba recomendações personalizadas — tudo por meio do Model Context Protocol.

URL do servidor: https://kokofinance.net/mcp/

Nenhuma chave de API necessária. Nenhuma instalação local necessária. Basta conectar seu cliente MCP.

Configuração rápida

Claude Desktop

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "koko-finance": {
      "type": "http",
      "url": "https://kokofinance.net/mcp/"
    }
  }
}

Claude Code

claude mcp add koko-finance --transport http https://kokofinance.net/mcp/

Ou copie o .mcp.json deste repositório para o seu projeto.

Cursor

Vá para Configurações > MCP e adicione um novo servidor:

Nome: koko-finance
Tipo: HTTP
URL: https://kokofinance.net/mcp/

Cline / Windsurf

Adicione ao seu arquivo de configurações MCP:

{
  "mcpServers": {
    "koko-finance": {
      "type": "http",
      "url": "https://kokofinance.net/mcp/"
    }
  }
}

Ferramentas (14)

Ferramenta	Descrição
`search_credit_cards`	Pesquisa em linguagem natural em mais de 100 cartões de crédito dos EUA. Filtros opcionais: `card_type`, `issuer`, `max_annual_fee`, `credit_tier`
`compare_cards`	Comparação lado a lado de 2 a 3 cartões com taxas, recompensas, valor líquido e ponto de equilíbrio. Opcional: `credit_tier`, `primary_goal`, `issuer_preferences` (<100ms)
`get_card_details`	Detalhes completos de um cartão específico (taxas, recompensas, benefícios)
`calculate_card_value`	Análise de ponto de equilíbrio da anuidade com valor no primeiro ano e valor contínuo
`optimize_portfolio`	Pontuação de saúde do portfólio, veredictos por cartão MANTER/OTIMIZAR/CANCELAR. Opcional: `point_balances`, `benefit_selections`, `credit_tier`, `primary_goal`, `issuer_preferences`, `analysis_type`, `cancel_threshold`, `keep_threshold` (<100ms)
`recommend_card_for_category`	Melhor cartão para usar em uma categoria de gastos específica, classificado por valor de recompensa. Opcional: `spending`, `credit_tier`, `primary_goal`, `issuer_preferences` (<100ms)
`check_card_renewal`	Você deve renovar este cartão? Veredicto + opções de downgrade/substituição. Opcional: `benefit_selections`, `acquired_date`, `credit_tier`, `primary_goal`, `renewal_cancel_threshold`, `renewal_keep_threshold`
`create_mcp_session`	Rastreamento de sessão para conversas com múltiplas consultas
`which_card_at_merchant`	Melhor cartão do seu portfólio em um comerciante específico. Detecta automaticamente a categoria de gastos (ex.: Starbucks → alimentação) e classifica por valor de recompensa
`check_merchant_benefits`	Verifica se algum cartão tem créditos em um comerciante (ex.: Saks → crédito de US$ 100 do Amex Platinum). Inclui recomendação de ganho
`get_card_benefits`	Todos os créditos/benefícios de um cartão com valor, frequência, programação e condições
`get_card_terms`	Dados do Schumer Box — APR de compra, APR de penalidade, taxas de atraso, taxas de adiantamento em dinheiro, APR promocional, período de carência
`get_card_changes`	Registro de auditoria de alterações nos dados do cartão (atualizações de taxas, alterações de benefícios) com filtro por data. Opcional: filtro `field`
`get_program_trends`	Histórico de avaliação do programa de pontos — alterações no CPP e na proporção de parceiros de transferência ao longo do tempo

Parâmetros de personalização

Várias ferramentas aceitam parâmetros opcionais que melhoram a relevância dos resultados. Todos são opcionais — quando omitidos, o servidor usa padrões sensatos (ex.: média nacional de gastos, sem viés de emissor).

`credit_tier`

Faixa de pontuação de crédito que afeta a elegibilidade do cartão e a probabilidade de aprovação.

Valor	Significado
`"excellent"`	750+
`"good"`	700-749
`"fair"`	650-699
`"poor"`	Abaixo de 650

Usado por: search_credit_cards, compare_cards, optimize_portfolio, recommend_card_for_category, check_card_renewal

`primary_goal`

O principal objetivo do usuário para sua estratégia de cartão de crédito.

Valor	Significado
`"maximize_rewards"`	Obter o máximo de pontos/cashback dos gastos do dia a dia
`"minimize_fees"`	Manter as anuidades baixas enquanto preserva o valor
`"build_credit"`	Estabelecer ou melhorar a pontuação de crédito
`"travel_perks"`	Priorizar acesso a salas VIP, créditos de viagem e parceiros de transferência
`"simplicity"`	Preferir menos cartões com estruturas de recompensa simples

Usado por: compare_cards, optimize_portfolio, recommend_card_for_category, check_card_renewal

`issuer_preferences`

Uma lista de objetos de preferência de emissor que expressam afinidade ou aversão a emissores de cartão específicos. Cada entrada tem um nome issuer e um weight que multiplica a pontuação de classificação do cartão — 1.0 é neutro (o padrão para qualquer emissor não listado), valores acima de 1.0 aumentam, valores abaixo de 1.0 diminuem. Faixa válida é de 0.1 a 3.0.

[
  {"issuer": "Chase", "weight": 1.5},
  {"issuer": "American Express", "weight": 1.2},
  {"issuer": "Capital One", "weight": 0.3}
]

Usado por: compare_cards, optimize_portfolio, recommend_card_for_category

`spending`

Um dicionário de valores mensais de gastos por categoria, usado para calcular valores de recompensa personalizados em vez das médias nacionais.

{"dining": 500, "groceries": 800, "travel": 300, "gas": 150, "general": 2000}

Usado por: compare_cards, optimize_portfolio, recommend_card_for_category, check_card_renewal, calculate_card_value

`cancel_threshold` / `keep_threshold`

Substitui os limites padrão de valor líquido (em dólares) para veredictos MANTER/OTIMIZAR/CANCELAR.

cancel_threshold — Cartões abaixo deste → CANCELAR (padrão: -200)
keep_threshold — Cartões acima deste → MANTER (padrão: 100)

Usado por: optimize_portfolio

`renewal_cancel_threshold` / `renewal_keep_threshold`

Mesmo conceito aplicado à decisão de renovação de um único cartão.

Usado por: check_card_renewal

`acquired_date`

Data em que o usuário adquiriu o cartão (YYYY-MM-DD). Informa a análise de renovação baseada no tempo de posse.

Usado por: check_card_renewal

Metadados de resposta

As ferramentas de cálculo incluem campos de metadados nas respostas:

spending_source — "user_provided" ou "national_averages". Indica se os cálculos usaram gastos fornecidos pelo usuário ou médias nacionais do BLS.
data_source — Indica de onde os dados do cartão foram obtidos (ex.: "koko_db").
rewards_by_category — Detalhamento de recompensas por categoria incluído nas ferramentas de comparação, portfólio e valor.
points_program_key / portal_cpp — Identificador do programa de pontos e avaliação em centavos por ponto do portal, incluídos em todos os dados do cartão.

Prompts (5)

Iniciadores de conversa pré-construídos que guiam a IA por fluxos de trabalho estruturados:

Prompt	Descrição	Parâmetros
`portfolio-review`	Análise completa do portfólio com pontuação de saúde e veredictos	`card_names`, `monthly_spending` (opcional)
`which-card`	Encontre o melhor cartão para uma compra específica	`card_names`, `category`, `amount` (opcional)
`new-card-finder`	Pesquise um novo cartão que corresponda aos seus critérios	`spending_focus`, `annual_fee_limit` (opcional), `credit_score` (opcional)
`renewal-check`	Percorra uma decisão de renovação de cartão passo a passo	`card_name`, `annual_fee` (opcional)
`card-risk-assessment`	Analise o perfil de risco de um cartão — exposição à APR, gatilhos de penalidade, armadilhas de taxas	`card_name`, `issuer` (opcional)

Seleções de benefícios

As ferramentas optimize_portfolio e check_card_renewal aceitam um parâmetro benefit_selections — uma lista de chaves de benefícios individuais que o usuário realmente utiliza. Benefícios selecionados contam com 100% de utilização; benefícios não selecionados contam com 0%.

benefit_selections: ["uber", "airline_fee", "dining", "admirals_club"]

Isso fornece cálculos precisos de valor líquido em vez da estimativa padrão de 50% de utilização.

Descubra chaves válidas chamando o endpoint REST GET https://kokofinance.net/api/v1/benefit-categories (sem necessidade de autenticação), ou consulte a documentação do desenvolvedor.

Exemplos de conversas

"Revise meu portfólio"

Tenho um Chase Sapphire Reserve, Amex Gold e Citi Double Cash. Analise meu portfólio e me diga quais cartões valem a pena manter.

"Qual cartão devo usar?"

Vou gastar US$ 200 em compras de supermercado. Tenho um Amex Gold, Chase Freedom Unlimited e Citi Custom Cash. Qual cartão devo usar?

"Encontre um novo cartão para mim"

Gasto muito com viagens e alimentação. Quero um cartão com anuidade abaixo de US$ 300 e um bom bônus de adesão. O que você recomenda?

"Devo renovar meu Amex Platinum?"

Uso apenas o crédito do Uber e o crédito de taxas de companhias aéreas no meu Amex Platinum. Ainda vale a pena pagar a anuidade de US$ 695?

"Qual cartão no Starbucks?"

Vou comprar café no Starbucks. Tenho um Chase Sapphire Reserve, Amex Gold e Citi Double Cash. Qual cartão rende mais?

"Tenho créditos na Saks?"

Estou comprando na Saks Fifth Avenue. Algum dos meus cartões tem créditos lá? Tenho um Amex Platinum e Chase Sapphire Reserve.

"Quais benefícios meu Amex Platinum tem?"

Mostre-me todos os créditos e benefícios do meu cartão Amex Platinum — quanto vale cada um?

Capturas de tela

Capturas de tela obtidas do Claude usando o servidor MCP KoKo Finance.

1. Pesquisa de cartões de crédito

"Encontre os melhores cartões de crédito de viagem com anuidade abaixo de US$ 300"

2. Compare cartões lado a lado

"Compare Chase Sapphire Reserve e Amex Gold"

Compare cards — part 1 Compare cards — part 2

3. Revisão do portfólio

"Analise meu portfólio: Chase Sapphire Reserve, Amex Gold, Citi Double Cash"

Portfolio review — part 1 Portfolio review — part 2

4. Qual cartão em um comerciante

"Qual cartão devo usar no Starbucks?"

Which card at merchant

5. Detalhamento dos benefícios do cartão

"Mostre-me todos os créditos e benefícios do meu Amex Platinum"

Card benefits — part 1 Card benefits — part 2

Também disponível

Plugin Claude Code — Adiciona a conexão do servidor MCP além de uma Skill de Agente que ensina ao Claude fluxos de trabalho estruturados de cartão de crédito

Política de privacidade

A KoKo Finance coleta dados mínimos necessários para operar o servidor MCP:

Dados de autenticação: Perfil do Google OAuth (nome, e-mail) quando você faz login. Nenhum login é necessário para uso no nível gratuito.
Registros de uso: Nome da ferramenta, parâmetros, status de sucesso/falha e carimbo de data/hora para cada chamada de ferramenta MCP. Usados para limitação de taxa e melhoria do serviço.
Sem compartilhamento com terceiros: Não vendemos nem compartilhamos dados pessoais com terceiros.
Retenção de dados: Os registros de uso são mantidos para a operação do serviço. Você pode solicitar a exclusão entrando em contato conosco.
Contato: privacy@kokofinance.net

Política de privacidade completa: https://kokofinance.net/privacy.html

Licença

MIT