Back to Browse

Bodymeasure MCP Server

Developer ToolsModerate6.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

Anthropometric predictions and percentile lookups via the Humanform API.

About

Anthropometric predictions and percentile lookups via the Humanform API.

Security Report

6.3
Moderate6.3Moderate Risk

bodymeasure is a small, transparent client for the Humanform anthropometric API that requires the user's own API key, fails closed when the key is missing, and validates arguments before any network request. Its only network destination is the declared Humanform API (overridable via HUMANFORM_API_URL), and its permissions match its purpose. Minor observations are limited to the env-controlled base URL and a generic error pass-through, neither of which materially lowers the score. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

HUMANFORM_API_KEYRequired

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "bodymeasure": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/bodymeasure@0.1.0"
      ],
      "env": {
        "HUMANFORM_API_KEY": "your-humanform-api-key-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

bodymeasure

How tall is a 30-year-old man at the 50th percentile in the US? And which percentile does a measured popliteal height of 43.1 cm land on for a 34-year-old woman? bodymeasure asks the Humanform API — a service of anthropometric reference data — and returns its answers as JSON, in both directions:

  • Forward: give a percentile, get the measurement value that sits there for a person of a given sex, age, and country.
  • Reverse: give a measured value, get the percentile it falls on for that same kind of person.

Two catalogue calls round out the surface: the measurement names and body groups the API supports, and its country codes and labels.

Configuration

You bring your own Humanform API key:

export HUMANFORM_API_KEY="your key"

Without it, bodymeasure does not guess: every call fails with HUMANFORM_API_KEY is not set, no request is made, and no measurement is invented. HUMANFORM_API_URL overrides the API base URL (https://api.humanform.app by default).

CLI

Each subcommand takes its arguments as one JSON string; the two list commands take "{}".

HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure predict_measurement '{"measurement":"Stature","sex":"Male","age":30,"percentile":50,"country":"US","unit":"cm"}'
HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure percentile_lookup '{"measurement":"PoplitealHeight","sex":"Female","age":34,"country":"US","unit":"cm","value":43.1}'
HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure list_measurements '{}'
HUMANFORM_API_KEY=... npx @reneturcios/bodymeasure list_countries '{}'
npx @reneturcios/bodymeasure --version

Output is the Humanform payload as JSON. Exit codes: 0 on success, 1 on a runtime error (including a missing key, a validation failure, or an upstream error), 2 on a usage error.

Arguments are checked before any request: string arguments must be non-empty, age must be a finite number greater than 0, percentile must lie strictly between 0 and 100, and a lookup value must be finite. When the API itself answers with an error body carrying error and message fields, that pair is reported as <error>: <message>.

MCP server

npx -y @reneturcios/bodymeasure mcp

MCP client config:

{
  "mcpServers": {
    "bodymeasure": {
      "command": "npx",
      "args": ["-y", "@reneturcios/bodymeasure", "mcp"],
      "env": { "HUMANFORM_API_KEY": "your key" }
    }
  }
}

Tools

  • predict_measurement — Forward lookup: percentile → measurement value. Requires measurement, sex, age, percentile, country, and unit.
  • percentile_lookup — Reverse lookup: measured value → percentile. Requires measurement, sex, age, country, unit, and value.
  • list_measurements — List all supported measurement names and body groups. No arguments.
  • list_countries — List supported country codes and labels. No arguments.

Docker

docker run -i -e HUMANFORM_API_KEY="your key" ghcr.io/cloudcorprecords/bodymeasure
docker run --rm -e HUMANFORM_API_KEY="your key" ghcr.io/cloudcorprecords/bodymeasure list_countries '{}'

Development

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios

Reviews

No reviews yet

Be the first to review this server!