Koko Credit card assistant

Servidor MCP para acceder a los flujos de trabajo de tarjetas de crédito de Koko, permitiendo buscar, comparar y optimizar tarjetas de crédito.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de KoKo Finance

Un servidor MCP alojado para asesoramiento de tarjetas de crédito impulsado por IA. Busca entre más de 100 tarjetas de crédito de EE. UU., compara opciones lado a lado, analiza la salud de tu cartera y obtén recomendaciones personalizadas, todo a través del Model Context Protocol.

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

No se requiere clave API. No es necesaria instalación local. Solo conecta tu cliente MCP.

Configuración rápida

Claude Desktop

Agrega a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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/

O copia el .mcp.json de este repositorio a tu proyecto.

Cursor

Ve a Settings > MCP y agrega un nuevo servidor:

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

Cline / Windsurf

Agrega a tu archivo de configuración de MCP:

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

Herramientas (14)

Herramienta	Descripción
`search_credit_cards`	Búsqueda en lenguaje natural entre más de 100 tarjetas de crédito de EE. UU. Filtros opcionales: `card_type`, `issuer`, `max_annual_fee`, `credit_tier`
`compare_cards`	Comparación lado a lado de 2-3 tarjetas con comisiones, recompensas, valor neto y punto de equilibrio. Opcional: `credit_tier`, `primary_goal`, `issuer_preferences` (<100ms)
`get_card_details`	Detalles completos de una tarjeta específica (comisiones, recompensas, beneficios)
`calculate_card_value`	Análisis de punto de equilibrio de la comisión anual con valor del primer año y valor continuo
`optimize_portfolio`	Puntaje de salud de la cartera, veredictos por tarjeta de KEEP/OPTIMIZE/CANCEL. Opcional: `point_balances`, `benefit_selections`, `credit_tier`, `primary_goal`, `issuer_preferences`, `analysis_type`, `cancel_threshold`, `keep_threshold` (<100ms)
`recommend_card_for_category`	Mejor tarjeta para usar en una categoría de gasto específica, clasificada por valor de recompensa. Opcional: `spending`, `credit_tier`, `primary_goal`, `issuer_preferences` (<100ms)
`check_card_renewal`	¿Deberías renovar esta tarjeta? Veredicto + opciones de downgrade o reemplazo. Opcional: `benefit_selections`, `acquired_date`, `credit_tier`, `primary_goal`, `renewal_cancel_threshold`, `renewal_keep_threshold`
`create_mcp_session`	Seguimiento de sesión para conversaciones con múltiples consultas
`which_card_at_merchant`	Mejor tarjeta de tu cartera en un comercio específico. Detecta automáticamente la categoría de gasto (p. ej., Starbucks → restaurantes) y clasifica por valor de recompensa
`check_merchant_benefits`	Verifica si alguna tarjeta tiene créditos en un comercio (p. ej., Saks → crédito de $100 de Amex Platinum). Incluye recomendación de uso
`get_card_benefits`	Todos los créditos/beneficios de una tarjeta con valor, frecuencia, calendario y condiciones
`get_card_terms`	Datos de Schumer Box: APR de compras, APR por penalización, cargos por mora, cargos por adelanto de efectivo, APR promocional, período de gracia
`get_card_changes`	Registro de auditoría de cambios en los datos de la tarjeta (actualizaciones de comisiones, cambios de beneficios) con filtro por fecha. Opcional: filtro `field`
`get_program_trends`	Historial de valoración del programa de puntos: cambios en CPP y en la proporción de socios de transferencia a lo largo del tiempo

Parámetros de personalización

Varias herramientas aceptan parámetros opcionales que mejoran la relevancia de los resultados. Todos son opcionales; cuando se omiten, el servidor usa valores predeterminados razonables (p. ej., gasto promedio nacional, sin sesgo de emisor).

`credit_tier`

Rango de puntaje crediticio que afecta la elegibilidad de la tarjeta y la probabilidad de aprobación.

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

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

`primary_goal`

El objetivo principal del usuario para su estrategia de tarjetas de crédito.

Valor	Significado
`"maximize_rewards"`	Obtener la mayor cantidad de puntos/reembolsos en efectivo del gasto diario
`"minimize_fees"`	Mantener las comisiones anuales bajas mientras se conserva el valor
`"build_credit"`	Establecer o mejorar el puntaje crediticio
`"travel_perks"`	Priorizar acceso a salas VIP, créditos de viaje y socios de transferencia
`"simplicity"`	Preferir menos tarjetas con estructuras de recompensa sencillas

Usado por: compare_cards, optimize_portfolio, recommend_card_for_category, check_card_renewal

`issuer_preferences`

Una lista de objetos de preferencia de emisor que expresan afinidad o aversión hacia emisores de tarjetas específicos. Cada entrada tiene un nombre issuer y un weight que multiplica el puntaje de clasificación de la tarjeta: 1.0 es neutral (el valor predeterminado para cualquier emisor no listado), los valores por encima de 1.0 aumentan, los valores por debajo de 1.0 disminuyen. El rango válido es 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`

Un diccionario de montos de gasto mensual por categoría, utilizado para calcular valores de recompensa personalizados en lugar de promedios nacionales.

{"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`

Anula los umbrales predeterminados de valor neto (en dólares) para los veredictos KEEP/OPTIMIZE/CANCEL.

cancel_threshold — Tarjetas por debajo de esto → CANCEL (predeterminado: -200)
keep_threshold — Tarjetas por encima de esto → KEEP (predeterminado: 100)

Usado por: optimize_portfolio

`renewal_cancel_threshold` / `renewal_keep_threshold`

El mismo concepto aplicado a la decisión de renovación de una sola tarjeta.

Usado por: check_card_renewal

`acquired_date`

Fecha en que el usuario adquirió la tarjeta (YYYY-MM-DD). Informa el análisis de renovación basado en la antigüedad.

Usado por: check_card_renewal

Metadatos de respuesta

Las herramientas de cálculo incluyen campos de metadatos en las respuestas:

spending_source — "user_provided" o "national_averages". Indica si los cálculos usaron gastos proporcionados por el usuario o promedios nacionales de BLS.
data_source — Indica de dónde se obtuvieron los datos de la tarjeta (p. ej., "koko_db").
rewards_by_category — Desglose de recompensas por categoría incluido en las herramientas de comparación, cartera y valor.
points_program_key / portal_cpp — Identificador del programa de puntos y valoración de centavos por punto del portal, incluidos en todos los datos de tarjetas.

Prompts (5)

Inicios de conversación preconstruidos que guían a la IA a través de flujos de trabajo estructurados:

Prompt	Descripción	Parámetros
`portfolio-review`	Análisis completo de la cartera con puntaje de salud y veredictos	`card_names`, `monthly_spending` (opcional)
`which-card`	Encuentra la mejor tarjeta para una compra específica	`card_names`, `category`, `amount` (opcional)
`new-card-finder`	Busca una nueva tarjeta que coincida con tus criterios	`spending_focus`, `annual_fee_limit` (opcional), `credit_score` (opcional)
`renewal-check`	Recorre una decisión de renovación de tarjeta paso a paso	`card_name`, `annual_fee` (opcional)
`card-risk-assessment`	Analiza el perfil de riesgo de una tarjeta: exposición a APR, desencadenantes de penalización, trampas de comisiones	`card_name`, `issuer` (opcional)

Selecciones de beneficios

Las herramientas optimize_portfolio y check_card_renewal aceptan un parámetro benefit_selections: una lista de claves de beneficios individuales que el usuario realmente utiliza. Los beneficios seleccionados cuentan con una utilización del 100%; los beneficios no seleccionados cuentan con una utilización del 0%.

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

Esto proporciona cálculos precisos de valor neto en lugar de la estimación predeterminada de utilización del 50%.

Descubre claves válidas llamando al endpoint REST GET https://kokofinance.net/api/v1/benefit-categories (sin autenticación requerida), o consulta la documentación para desarrolladores.

Conversaciones de ejemplo

"Revisa mi cartera"

Tengo una Chase Sapphire Reserve, una Amex Gold y una Citi Double Cash. Analiza mi cartera y dime qué tarjetas vale la pena conservar.

"¿Qué tarjeta debería usar?"

Voy a comprar $200 en comestibles. Tengo una Amex Gold, una Chase Freedom Unlimited y una Citi Custom Cash. ¿Qué tarjeta debería usar?

"Encuéntrame una tarjeta nueva"

Gasto mucho en viajes y restaurantes. Quiero una tarjeta con una comisión anual inferior a $300 y un buen bono de bienvenida. ¿Qué me recomiendas?

"¿Debería renovar mi Amex Platinum?"

Solo uso el crédito de Uber y el crédito de comisiones de aerolínea en mi Amex Platinum. ¿Todavía vale la pena pagar la comisión anual de $695?

"¿Qué tarjeta en Starbucks?"

Voy a comprar café en Starbucks. Tengo una Chase Sapphire Reserve, una Amex Gold y una Citi Double Cash. ¿Qué tarjeta genera más?

"¿Tengo créditos en Saks?"

Estoy comprando en Saks Fifth Avenue. ¿Alguna de mis tarjetas tiene créditos allí? Tengo una Amex Platinum y una Chase Sapphire Reserve.

"¿Qué beneficios tiene mi Amex Platinum?"

Muéstrame todos los créditos y beneficios de mi tarjeta Amex Platinum: ¿cuánto vale cada uno?

Capturas de pantalla

Capturas de pantalla tomadas de Claude usando el servidor MCP de KoKo Finance.

1. Búsqueda de tarjetas de crédito

"Encuéntrame las mejores tarjetas de crédito de viaje con una comisión anual inferior a $300"

2. Comparar tarjetas lado a lado

"Compara Chase Sapphire Reserve y Amex Gold"

Compare cards — part 1 Compare cards — part 2

3. Revisión de cartera

"Analiza mi cartera: Chase Sapphire Reserve, Amex Gold, Citi Double Cash"

Portfolio review — part 1 Portfolio review — part 2

4. Qué tarjeta en un comercio

"¿Qué tarjeta debería usar en Starbucks?"

Which card at merchant

5. Desglose de beneficios de la tarjeta

"Muéstrame todos los créditos y beneficios de mi Amex Platinum"

Card benefits — part 1 Card benefits — part 2

Enlaces

KoKo Finance — Sitio principal
Documentación para desarrolladores — Referencia completa de API y herramientas
Endpoint MCP — URL directa del servidor

También disponible

Plugin de Claude Code — Agrega la conexión del servidor MCP más una habilidad de agente que enseña a Claude flujos de trabajo estructurados de tarjetas de crédito

Política de privacidad

KoKo Finance recopila los datos mínimos necesarios para operar el servidor MCP:

Datos de autenticación: Perfil de Google OAuth (nombre, correo electrónico) cuando inicias sesión. No se requiere inicio de sesión para el uso del nivel gratuito.
Registros de uso: Nombre de la herramienta, parámetros, estado de éxito/fracaso y marca de tiempo para cada llamada de herramienta MCP. Se utilizan para limitación de velocidad y mejora del servicio.
Sin intercambio con terceros: No vendemos ni compartimos datos personales con terceros.
Retención de datos: Los registros de uso se conservan para la operación del servicio. Puedes solicitar su eliminación contactándonos.
Contacto: privacy@kokofinance.net

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

Licencia

MIT