EveryCalc

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

EveryCalc

Calculadoras financeiras gratuitas para todas as partes da vida, expostas como uma API REST e um servidor MCP para que assistentes de IA possam fazer as contas para você.

Site ao vivo: https://everycalc.xyz Documentação da API (OpenAPI): https://everycalc.xyz/api/v1/openapi.json Endpoint MCP: POST https://everycalc.xyz/mcp (HTTP Streamable, sem autenticação)

O que é

EveryCalc é uma coleção de calculadoras interativas de finanças pessoais. Este repositório hospeda o código do servidor que alimenta duas interfaces amigáveis para máquinas sobre essas calculadoras:

1. API REST em everycalc.xyz/api/v1/* — endpoints GET simples, JSON na entrada e na saída.
2. Servidor MCP em POST everycalc.xyz/mcp — oito ferramentas de calculadora para clientes do Model Context Protocol (Claude, Cursor e outros).

Sem chave de API. Sem cadastro. Sem instalação local para a versão hospedada.

Cada resultado de ferramenta inclui um link profundo calculator_url para a calculadora interativa correspondente em everycalc.xyz, para que os usuários possam explorar os números visualmente depois que o assistente fizer as contas.

As 8 ferramentas

Ferramenta	O que calcula
calculate_mortgage	Detalhamento do pagamento mensal: principal e juros via fórmula de amortização, além de imposto predial, seguro do proprietário, PMI e HOA
calculate_refinance	Mês de equilíbrio do refinanciamento e economia ao longo da vida
calculate_affordability	Acessibilidade de imóvel pela regra 28/36
calculate_loan	Pagamentos de empréstimos amortizados
calculate_compound_interest	Projeções de juros compostos com contribuições mensais
calculate_percentage	Cálculos de porcentagem
calculate_tip	Gorjeta e divisão de conta
calculate_salary	Conversões de salário entre pagamento por hora, semanal, quinzenal, mensal e anual

Use o servidor MCP hospedado

Adicione isto à configuração do seu cliente MCP:

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

Essa é toda a configuração. O servidor é remoto (HTTP Streamable), então não há nada para instalar.

Use a API REST

Todos os endpoints são GET com parâmetros de consulta. Exemplo:

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

Resposta:

{
  "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 disponíveis (especificação completa em 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

Erros retornam {"ok": false, "error": {"code": "...", "message": "...", "field": "..."}} com um status HTTP apropriado.

Execute você mesmo

O servidor é um Cloudflare Worker. A matemática dos cálculos está em src/engine.js como funções puras (sem I/O), compartilhadas pelos manipuladores REST e pelos manipuladores MCP em src/index.js.

Pré-requisitos: Node 18+, wrangler.

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

O documento OpenAPI é gerado a partir dos mesmos manipuladores, então a documentação da API nunca se desvia do comportamento.

Testes

npm test

test/test.mjs exercita os endpoints REST contra as funções matemáticas puras; test/test-mcp.mjs exercita os manipuladores das ferramentas MCP. Tudo verde desde o último deploy.

Registro MCP

Este repositório inclui server.json, o manifesto para o registro oficial do MCP.

Licença

MIT. Consulte LICENSE.