Skip to content
MCP server

Biosamples

Search and fetch EBI BioSamples metadata for cell lines, tissues and organisms via MCP

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

Similar MCP servers

About Biosamples

Biosamples is a freemium MCP server for genomics data. It can run locally on your machine or as a hosted remote server.

The README describes this as a stdio bridge and a hosted endpoint on the Pipeworx gateway that exposes two tools for querying the European Bioinformatics Institute's BioSamples archive. One tool runs free-text searches by organism, tissue or keyword and returns accession, name, organism and release date; the other fetches a single record by accession, including taxId, dates and a flattened map of characteristics such as tissue, sex and cell type.

Connections can be made over streamable HTTP through the gateway or through an npm package launched with npx. Calls are anonymous by default and capped daily; an optional Pipeworx API key raises the limit and meters usage under a Pipeworx account. The site notes that connecting to a pack endpoint also lists shared gateway meta-tools such as ask_pipeworx, and the npm package can be set to list only this pack's tools.

The pack suits researchers and developers who want an AI assistant to look up sample metadata without writing their own EBI API client. It is an unofficial integration and is not affiliated with EBI.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

{
  "mcpServers": {
    "biosamples": {
      "serverUrl": "https://gateway.pipeworx.io/biosamples/mcp"
    }
  }
}

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

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

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

search_samples
Free-text search of EBI BioSamples by organism, tissue or keyword.
get_sample
Fetch a single BioSamples record by accession.

What it does

Free-text sample search
Searches BioSamples by organism, tissue or keyword and returns matching accessions with names and release dates.
Single-record lookup
Fetches one sample by accession, including its name, dates, taxId, organism and characteristics.
Keyless access
Both tools are documented as working without an API key, subject to daily anonymous call limits.
Streamable HTTP endpoint
A hosted MCP endpoint on the Pipeworx gateway can be added directly to compatible clients.
Optional npm bridge
A local stdio package forwards calls to the same endpoint and can be configured with an API key.

Good for

  • Look up the organism and tissue recorded for a BioSamples accession
  • Search for cell line or tissue samples by keyword during literature or data review
  • Retrieve sample characteristics such as sex or cell type for a dataset
  • Let an AI assistant answer sample metadata questions without building an EBI API client

Pricing

Freemium, from $49 a month

Anonymous use capped at 50 calls a day; free Pipeworx account 200 calls a day; paid tiers from $49/month.

Prices change. Check pipeworx.io before you buy.

Biosamples FAQ

Does it need an API key?

The README says both tools are keyless. Without a Pipeworx key, calls are anonymous and capped daily; a free key raises the cap.

How do I run it locally?

The npm package @pipeworx/mcp-biosamples runs via npx as a stdio bridge that forwards calls to the hosted gateway endpoint. It needs network access and has no offline mode.

Is this an official EBI product?

No. The README states it is an independent, unofficial integration not affiliated with or endorsed by the upstream provider.

Is Biosamples free?

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

How do I add Biosamples to Claude Code?

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

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