# Hpo Api

> Hpo Api is a freemium MCP server for health and science. Look up HPO phenotype terms, their hierarchy and disease links via MCP, for clinical. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/hpo-api
- **Repository:** https://github.com/pipeworx-io/mcp-hpo-api
- **MCP Registry name:** io.github.pipeworx-io/hpo-api
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hpo-api https://gateway.pipeworx.io/hpo-api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/hpo-api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hpo-api": {
      "url": "https://gateway.pipeworx.io/hpo-api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hpo-api": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/hpo-api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hpo-api": {
      "serverUrl": "https://gateway.pipeworx.io/hpo-api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hpo-api": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/hpo-api/mcp"
    }
  }
}
```

## Tools

- `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).

## 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.

## Alternatives

- [Ebi Ols](https://ai-powered.com/mcp/ebi-ols): Ebi Ols is a freemium MCP server for health and science.
- [Ensembl](https://ai-powered.com/mcp/ensembl): Ensembl is a freemium MCP server for health and science.
- [Photon Health MCP by usefulapi](https://ai-powered.com/mcp/photon-health-mcp-by-usefulapi): Photon Health MCP by usefulapi is a freemium MCP server for health and science.
- [Medical Codes](https://ai-powered.com/mcp/medical-codes): Medical Codes is a freemium MCP server for health and science.
- [Npi Registry](https://ai-powered.com/mcp/npi-registry): Npi Registry is a freemium MCP server for health and science.
- [Particle Health MCP by usefulapi](https://ai-powered.com/mcp/particle-health-mcp-by-usefulapi): Particle Health MCP by usefulapi is a freemium MCP server for health and science.
- [NPPES NPI Registry MCP by usefulapi](https://ai-powered.com/mcp/nppes-npi-registry-mcp-by-usefulapi): NPPES NPI Registry MCP by usefulapi is a freemium MCP server for health and science.
- [Health Gorilla MCP by usefulapi](https://ai-powered.com/mcp/health-gorilla-mcp-by-usefulapi): Health Gorilla MCP by usefulapi is a freemium MCP server for health and science.

---
Source: https://ai-powered.com/mcp/hpo-api
