Skip to content
MCP server

Hpo Api

Look up HPO phenotype terms, their hierarchy and disease links via MCP, for clinical

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/hpo-api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hpo-api": {
      "url": "https://gateway.pipeworx.io/hpo-api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers