BMI Calculator Logo
BMI Calculator
Developer Docs

BMI Calculator Public API

Structured endpoints for BMI, heart age, and love score calculations, plus machine-readable discovery documents for agent workflows.

OpenAPI SpecAPI Catalog

Base URLs

API root: https://bmi-calculator.app/api

Health: https://bmi-calculator.app/api/health

OpenAPI: https://bmi-calculator.app/openapi.json

POST/api/bmi

Calculate BMI from metric or imperial measurements.

{
  "height": 180,
  "heightUnit": "cm",
  "weight": 75,
  "weightUnit": "kg"
}

POST/api/heart-age

Estimate heart age and return a risk band with recommendations.

{
  "age": 42,
  "gender": "male",
  "systolicBP": 128,
  "diastolicBP": 82,
  "cholesterol": 210,
  "smoking": "never",
  "diabetes": "no",
  "familyHistory": "yes",
  "exercise": "moderate",
  "bmi": 26
}

POST/api/love-score

Return a deterministic name compatibility score for fun use cases.

{
  "firstName": "Alex",
  "secondName": "Jamie"
}

Authentication

The calculator APIs are currently public, but the site also publishes OAuth discovery metadata so agents can discover a structured auth flow when they need one.

Authorization server metadata:
https://bmi-calculator.app/.well-known/oauth-authorization-server

Protected resource metadata:
https://bmi-calculator.app/.well-known/oauth-protected-resource

curl -X POST https://bmi-calculator.app/oauth/token \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=my-agent&scope=calculators:read'

Agent Discovery

API catalog: https://bmi-calculator.app/.well-known/api-catalog

Agent skills index: https://bmi-calculator.app/.well-known/agent-skills/index.json

MCP server card: https://bmi-calculator.app/.well-known/mcp/server-card.json