EveryCalc

npx add-mcp 'https://everycalc.xyz/mcp'

EveryCalc

Calculadoras financieras gratuitas para cada aspecto de la vida, expuestas como una API REST y un servidor MCP para que los asistentes de IA puedan hacer los cálculos por ti.

Sitio en vivo: https://everycalc.xyz Documentación de la API (OpenAPI): https://everycalc.xyz/api/v1/openapi.json Endpoint MCP: POST https://everycalc.xyz/mcp (HTTP Streamable, sin autenticación)

Qué es

EveryCalc es una colección de calculadoras interactivas de finanzas personales. Este repositorio aloja el código del servidor que impulsa dos interfaces aptas para máquinas sobre esas calculadoras:

1. API REST en everycalc.xyz/api/v1/* — endpoints GET simples, JSON de entrada y salida.
2. Servidor MCP en POST everycalc.xyz/mcp — ocho herramientas de calculadora para clientes del Protocolo de Contexto de Modelo (Claude, Cursor y otros).

Sin clave de API. Sin registro. Sin instalación local para la versión alojada.

Cada resultado de herramienta incluye un enlace profundo calculator_url a la calculadora interactiva correspondiente en everycalc.xyz, para que los usuarios puedan explorar los números visualmente después de que el asistente haga los cálculos.

Las 8 herramientas

Herramienta	Qué calcula
calculate_mortgage	Desglose del pago mensual: capital e intereses mediante la fórmula de amortización, más impuesto a la propiedad, seguro del propietario, PMI y HOA
calculate_refinance	Mes de punto de equilibrio de la refinanciación y ahorro de por vida
calculate_affordability	Asequibilidad de vivienda mediante la regla 28/36
calculate_loan	Pagos de préstamos amortizables
calculate_compound_interest	Proyecciones de interés compuesto con aportes mensuales
calculate_percentage	Cálculos de porcentajes
calculate_tip	Propinas y división de cuentas
calculate_salary	Conversiones de salario entre pago por hora, semanal, quincenal, mensual y anual

Usa el servidor MCP alojado

Añade esto a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "everycalc": {
      "url": "https://everycalc.xyz/mcp"
    }
  }
}

Esa es toda la configuración. El servidor es remoto (HTTP Streamable), así que no hay nada que instalar.

Usa la API REST

Todos los endpoints son GET con parámetros de consulta. Ejemplo:

GET https://everycalc.xyz/api/v1/calculate/mortgage?home_price=400000&down_payment_pct=20&annual_rate_pct=6.5&term_years=30

Respuesta:

{
  "ok": true,
  "tool": "calculate_mortgage",
  "inputs": { "homePrice": 400000, "annualRatePct": 6.5, "termYears": 30, "...": "..." },
  "results": {
    "loan_amount": 320000,
    "down_payment_usd": 80000,
    "monthly_principal_interest": 2022.62,
    "monthly_total": 2022.62,
    "total_interest": 408142.36,
    "total_cost": 808142.36
  },
  "calculator_url": "https://everycalc.xyz/mortgage-calculator/"
}

Endpoints disponibles (especificación completa en openapi.json):

• GET /api/v1/health
• GET /api/v1/calculate/mortgage
• GET /api/v1/calculate/refinance
• GET /api/v1/calculate/affordability
• GET /api/v1/calculate/loan
• GET /api/v1/calculate/compound-interest
• GET /api/v1/calculate/percentage
• GET /api/v1/calculate/tip
• GET /api/v1/calculate/salary
• GET /api/v1/openapi.json

Los errores devuelven {"ok": false, "error": {"code": "...", "message": "...", "field": "..."}} con un estado HTTP apropiado.

Ejecútalo tú mismo

El servidor es un Cloudflare Worker. La lógica de cálculo vive en src/engine.js como funciones puras (sin E/S), compartidas por los manejadores REST y los manejadores MCP en src/index.js.

Requisitos previos: Node 18+, wrangler.

npm install -g wrangler
wrangler login
# point [assets] directory at your static-site build, then:
wrangler deploy

El documento OpenAPI se genera a partir de los mismos manejadores, por lo que la documentación de la API nunca se desvía del comportamiento real.

Pruebas

npm test

test/test.mjs ejercita los endpoints REST contra las funciones matemáticas puras; test/test-mcp.mjs ejercita los manejadores de herramientas MCP. Todo en verde desde el último despliegue.

Registro MCP

Este repositorio incluye server.json, el manifiesto para el registro oficial de MCP.

Licencia

MIT. Ver LICENSE.