Cashish

Por qué existe

La mayoría de apps tratan la tarjeta de crédito como “otra cuenta en negativo”.
Cashish modela el ciclo real: límite, disponible, día de corte, fecha de pago, cargos del periodo y pagos vinculados desde tu débito.

Además recuerda qué tarjeta cobra Netflix y cuándo toca el siguiente cobro.

Related MCP server: MCP Agent - AI Expense Tracker

Stack

Funciones (Entrega 1)

• Cuentas: efectivo, débito, ahorros y TDC

• Perfil de tarjeta: límite, día de corte, día de pago

• Periodos de estado (abrir → cerrar snapshot → marcar pagado)

• Movimientos e ingresos

• Pago a tarjeta como transferencia vinculada

• Suscripciones ligadas a una tarjeta

• Recordatorios in-app (+ email cuando hay Resend)

• MCP para Cursor / Claude / otros agentes

Conectar agentes (MCP)

1. Entra a la app → Agentes → crea una clave (csh_…).

2. Configura tu cliente:

{
  "mcpServers": {
    "cashish": {
      "url": "https://cashish-beta.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer csh_TU_CLAVE"
      }
    }
  }
}

Herramientas MCP: panorama (cashish_dashboard, cashish_upcoming_events, cashish_cashflow_forecast), cuentas CRUD + perfil TDC, movimientos/búsqueda, transferencias y pago TDC (cashish_pay_to_avoid_interest), cortes, suscripciones (+ sugerencias), presupuestos/MSI/tickets list, recordatorios. Usa cashish_list_tools_help desde el agente.

El endpoint MCP requiere SUPABASE_SERVICE_ROLE_KEY en el entorno del servidor (nunca en el cliente).

Desarrollo local

cp .env.example .env.local
# Rellena NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY,
# SUPABASE_SERVICE_ROLE_KEY, CRON_SECRET

npm install
npm run dev

Migraciones: supabase/migrations/.

npm test
npm run build

Variables de entorno

Auth (Supabase)

• UI: /login (entrar) y /register (crear cuenta). El enlace mágico solo inicia sesión (shouldCreateUser: false).

• Callback PKCE: {APP_URL}/auth/callback.

• En el dashboard de Supabase → Authentication → URL configuration, incluye exactamente:

  • Site URL: https://cashish-beta.vercel.app (o tu dominio)

  • Redirect URLs: https://cashish-beta.vercel.app/auth/callback y previews si las usas (https://*.vercel.app/auth/callback si el plan lo permite)

Estructura

src/
  app/           # UI + API (ai, mcp, cron, auth)
  components/
  lib/
    money.ts     # aritmética segura en centavos
    ai/          # BYOK provider, chat loop, prompts
    finance-tools/ # registry compartido MCP + asistente
    mcp/         # auth de claves + wrapper MCP
    supabase/
docs/ai.md
supabase/migrations/

Roadmap breve

1. Proyectos (ledgers) + invitaciones + tickets MVP (fase 2)

2. Import CSV/OFX + sugerencias de suscripción (fase 3)

3. Cashflow + presupuestos/MSI (fase 3)

4. Quincena OS: hub, onboarding, smart-pay deep-link, plan de agente (fase 4)

5. Push (VAPID) + polish analíticas rollup

Ver docs/ai.md, docs/projects.md, docs/cashflow.md, docs/phase3.md, docs/phase4.md.

Licencia

Uso personal por ahora. El código vive en este repositorio.