
Hpo Api
Look up HPO phenotype terms, their hierarchy and disease links via MCP, for clinical
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Hpo Api
Hpo Api is a freemium MCP server for health and science. It can run locally on your machine or as a hosted remote server.
The README describes this server as a bridge to the Human Phenotype Ontology, exposing its term lookup, text search and ontology graph navigation as MCP tools. An AI client can resolve an HP identifier to its definition, walk up to parent classes or down to child and descendant phenotypes, and find which HPO phenotypes are annotated to a disease identifier.
Gene-to-disease queries use NCBI Gene IDs, and disease-to-phenotype queries accept OMIM, ORPHA or MONDO identifiers. The README notes that the data comes from the upstream HPO REST services, with a fallback endpoint if the primary one is unavailable.
The server is hosted by Pipeworx and is listed as an independent, unofficial integration. Pipeworx's own documentation says a single-pack endpoint also lists shared gateway tools such as ask_pipeworx, and that a key raises the daily call cap.
Install
Run in a terminal
claude mcp add --transport http hpo-api https://gateway.pipeworx.io/hpo-api/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/hpo-api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"hpo-api": {
"url": "https://gateway.pipeworx.io/hpo-api/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hpo-api": {
"type": "http",
"url": "https://gateway.pipeworx.io/hpo-api/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hpo-api": {
"serverUrl": "https://gateway.pipeworx.io/hpo-api/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hpo-api": {
"type": "http",
"url": "https://gateway.pipeworx.io/hpo-api/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- term
- HPO term by HP id.
- search
- Text search across HPO terms.
- term_children
- Direct children of a term.
- term_parents
- Direct parents of a term.
- term_descendants
- Full descendant subtree of a term, paginated.
- gene_diseases
- Diseases associated with a gene id (NCBIGene).
- disease_phenotypes
- HPO terms annotated to a disease id (OMIM/ORPHA/MONDO).
What it does
- Phenotype term lookup
- Fetches a single HPO term by its HP identifier.
- Free-text term search
- Searches HPO terms from a plain-language symptom or sign description.
- Ontology graph navigation
- Returns direct children, direct parents or the full descendant subtree of a term.
- Gene-disease associations
- Lists diseases linked to a gene given as an NCBI Gene identifier.
- Disease phenotype annotations
- Lists HPO phenotypes annotated to a disease identified by OMIM, ORPHA or MONDO.
Good for
- Mapping clinical notes or patient symptoms to standard HPO identifiers
- Expanding a broad phenotype into all its more specific child terms
- Finding which diseases a candidate gene is associated with during variant review
- Listing the phenotypes documented for a rare disease identifier
Pricing
Freemium, from $49 a month
Anonymous use capped at 50 calls a day; free account 200 calls a day; paid credits and subscriptions beyond that.
Prices change. Check pipeworx.io before you buy.
Hpo Api FAQ
Does the server need an API key?
The README says it is keyless. An optional Pipeworx API key raises the daily call cap from 50 to 200 calls.
Which identifiers does the disease lookup accept?
The tool accepts OMIM, ORPHA or MONDO identifiers for diseases, and NCBI Gene identifiers for gene lookups.
Is this an official HPO product?
The README states it is an independent, unofficial integration and is not affiliated with or endorsed by the upstream provider.
Is Hpo Api free?
Hpo Api has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Hpo Api to Claude Code?
Run this command in your terminal: claude mcp add --transport http hpo-api https://gateway.pipeworx.io/hpo-api/mcp
What are the best alternatives to Hpo Api?
The closest alternatives to Hpo Api are Ebi Ols, Ensembl, Photon Health MCP by usefulapi, Medical Codes and Npi Registry.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.