Skip to content
MCP server

Ebi Ols

Search and traverse ~250 biomedical ontologies via an MCP gateway, no key required

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Ebi Ols

Ebi Ols is a freemium MCP server for health and science. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ebi-ols": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/ebi-ols/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 (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day; free account 200 calls/day; paid plans from $49/month or pay-as-you-go

Prices change. Check pipeworx.io before you buy.

Ebi Ols 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.

How AIPoweredBot checks servers