{"id":"fb1d51cd-24be-482a-8a0a-a8582e9f238d","slug":"bodymeasure","kind":"mcp","name":"bodymeasure","summary":"Anthropometric predictions and percentile lookups via the Humanform API.","owner":"CloudCorpRecords","repoUrl":"https://github.com/CloudCorpRecords/bodymeasure","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-11-03T03:41:56.000Z","addedAt":"2026-11-05T20:06:05.142Z","logoUrl":"https://avatars.githubusercontent.com/u/95189389?u=8e277e1a24ff84ae7b49c89e6897fa44178a5c34&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["utilities"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-11-05T21:21:29.304Z","sample":false,"url":"https://conduits.dev/tools/bodymeasure","language":"TypeScript","transports":["stdio"],"install":{"npm":"@reneturcios/bodymeasure"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# bodymeasure\n\nHow tall is a 30-year-old man at the 50th percentile in the\nUS? And which percentile does a measured popliteal height of\n43.1 cm land on for a 34-year-old woman? bodymeasure asks the\nHumanform API — a service of anthropometric reference data —\nand returns its answers as JSON, in both directions:\n\n- **Forward:** give a percentile, get the measurement value\n  that sits there for a person of a given sex, age, and\n  country.\n- **Reverse:** give a measured value, get the percentile it\n  falls on for that same kind of person.\n\nTwo catalogue calls round out the surface: the measurement\nnames and body groups the API supports, and its country codes\nand labels.\n\n## Configuration\n\nYou bring your own Humanform API key:\n\n```bash\nexport HUMANFORM_API_KEY=\"your key\"\n```\n\nWithout it, bodymeasure does not guess: every call fails with\n`HUMANFORM_API_KEY is not set`, no request is made, and no\nmeasurement is invented. `HUMANFORM_API_URL` overrides the\nAPI base URL (`https://api.humanform.app` by default).\n\n## CLI\n\nEach subcommand takes its arguments as one JSON string; the\ntwo list commands take `\"{}\"`.\n\n```bash\nHUMANFORM_API_KEY=... npx @reneturcios/bodymeasure predict_measurement '{\"measurement\":\"Stature\",\"sex\":\"Male\",\"age\":30,\"percentile\":50,\"country\":\"US\",\"unit\":\"cm\"}'\nHUMANFORM_API_KEY=... npx @reneturcios/bodymeasure percentile_lookup '{\"measurement\":\"PoplitealHeight\",\"sex\":\"Female\",\"age\":34,\"country\":\"US\",\"unit\":\"cm\",\"value\":43.1}'\nHUMANFORM_API_KEY=... npx @reneturcios/bodymeasure list_measurements '{}'\nHUMANFORM_API_KEY=... npx @reneturcios/bodymeasure list_countries '{}'\nnpx @reneturcios/bodymeasure --version\n```\n\nOutput is the Humanform payload as JSON. Exit codes: `0` on\nsuccess, `1` on a runtime error (including a missing key, a\nvalidation failure, or an upstream error), `2` on a usage\nerror.\n\nArguments are checked before any request: string arguments\nmust be non-empty, `age` must be a finite number greater\nthan 0, `percentile` must lie strictly between 0 and 100, and\na lookup `value` must be finite. When the API itself answers\nwith an error body carrying `error` and `message` fields,\nthat pair is reported as `<error>: <message>`.\n\n## MCP server\n\n```bash\nnpx -y @reneturcios/bodymeasure mcp\n```\n\nMCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"bodymeasure\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@reneturcios/bodymeasure\", \"mcp\"],\n      \"env\": { \"HUMANFORM_API_KEY\": \"your key\" }\n    }\n  }\n}\n```\n\n### Tools\n\n- `predict_measurement` — Forward lookup: percentile →\n  measurement value. Requires `measurement`, `sex`, `age`,\n  `percentile`, `country`, and `unit`.\n- `percentile_lookup` — Reverse lookup: measured value →\n  percentile. Requires `measurement`, `sex`, `age`, `country`,\n  `unit`, and `value`.\n- `list_measurements` — List all supported measurement names\n  and body groups. No arguments.\n- `list_countries` — List supported country codes and labels.\n  No arguments.\n\n## Docker\n\n```bash\ndocker run -i -e HUMANFORM_API_KEY=\"your key\" ghcr.io/cloudcorprecords/bodymeasure\ndocker run --rm -e HUMANFORM_API_KEY=\"your key\" ghcr.io/cloudcorprecords/bodymeasure list_countries '{}'\n```\n\n## Development\n\n```bash\nnpm install\nnpm run build   # tsc -> dist/\nnpm test        # tsx --test test/*.test.ts (fake fetch, no network)\nnpm run dev     # run the CLI from source\n```\n\n## License\n\nMIT — Copyright (c) 2026 Rene Turcios\n"}