# Ebi Ols

> Ebi Ols is a freemium MCP server for health and science. Search and traverse ~250 biomedical ontologies via an MCP gateway, no key required. 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/ebi-ols
- **Repository:** https://github.com/pipeworx-io/mcp-ebi-ols
- **MCP Registry name:** io.github.pipeworx-io/ebi-ols
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science)
- **Listing updated:** 2026-11-18

## About

The server wraps the EMBL-EBI Ontology Lookup Service, giving AI clients access to roughly 250 biomedical ontologies such as GO, EFO, MONDO, Cell Ontology and ChEBI. Its six tools cover listing loaded ontologies, fetching ontology metadata, full-text search across terms, retrieving a single term by IRI, short form or OBO id, and walking the hierarchy to find transitive ancestors or direct children.

The README says the package is a local stdio bridge that forwards every call to a hosted Pipeworx gateway endpoint, so it needs network access and has no offline mode. Anonymous use is capped at 50 calls a day; an optional free Pipeworx key raises that to 200 and is sent as a Bearer token.

It suits developers and researchers who need to map biomedical terms to canonical ontology identifiers or explore their parent and child relationships from inside an agent workflow.

## Features

- **Ontology listing and metadata:** Lists every ontology loaded into OLS and returns metadata such as the latest release and term count for a given ontology.
- **Full-text term search:** Searches terms across all ontologies or within one, with options for exact matching and result size.
- **Term lookup by identifier:** Retrieves a term by IRI, short form or OBO id, scoped to a named ontology.
- **Hierarchy traversal:** Returns transitive ancestors or direct children of a term for navigating ontology structure.
- **Keyless anonymous access:** Works without an API key, with an optional free key for a higher daily call cap.

## Good for

- Mapping free-text disease or cell type names to MONDO, EFO or Cell Ontology identifiers
- Finding the parent classes of a gene ontology term during literature triage
- Exploring the children of a phenotype term when building a research dataset
- Looking up ChEBI chemical entity identifiers for compound annotation

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ebi-ols https://gateway.pipeworx.io/ebi-ols/mcp
```

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

```sh
https://gateway.pipeworx.io/ebi-ols/mcp
```

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

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

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

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

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

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

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

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

## Tools

- `list_ontologies`: List all loaded ontologies.
- `get_ontology`: Ontology metadata by id.
- `search`: Full-text search across terms, optionally within one ontology.
- `get_term`: Term details by iri, short_form or obo_id.
- `term_ancestors`: Transitive ancestors of a term.
- `term_children`: Direct children of a term.

## FAQ

### Does it need an API key?

No. The README says it calls anonymously by default, capped at 50 calls a day. A free Pipeworx key raises the cap to 200 a day.

### Which ontologies are included?

The listing says about 250 biomedical ontologies from OLS, with examples including GO, EFO, MONDO, CL, ChEBI and HP.

### Does the npm package work offline?

No. The README states it is a local bridge to the hosted gateway, needs network access and has no offline mode.

### Does the endpoint expose only these six tools?

The README says the endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx, and the npm package lists only pack tools unless PIPEWORX_META_TOOLS=1 is set.

### Is Ebi Ols free?

Ebi Ols has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Ebi Ols to Claude Code?

Run this command in your terminal: claude mcp add --transport http ebi-ols https://gateway.pipeworx.io/ebi-ols/mcp

### What are the best alternatives to Ebi Ols?

The closest alternatives to Ebi Ols are Complex Portal, Ensembl, Opentreeoflife, Medical Codes and Idigbio.

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

- [Complex Portal](https://ai-powered.com/mcp/complex-portal): Complex Portal 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.
- [Opentreeoflife](https://ai-powered.com/mcp/opentreeoflife): Opentreeoflife 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.
- [Idigbio](https://ai-powered.com/mcp/idigbio): Idigbio is a freemium MCP server for health and science.
- [Hpo Api](https://ai-powered.com/mcp/hpo-api): Hpo Api is a freemium MCP server for health and science.
- [NCBI PubMed MCP by usefulapi](https://ai-powered.com/mcp/ncbi-pubmed-mcp-by-usefulapi): NCBI PubMed MCP by usefulapi is a freemium MCP server for health and science.
- [PubMed Search](https://ai-powered.com/mcp/pubmed-search): PubMed Search is an open-source MCP server for health and science.

---
Source: https://ai-powered.com/mcp/ebi-ols
