# Biosamples

> Biosamples is a freemium MCP server for genomics data. Search and fetch EBI BioSamples metadata for cell lines, tissues and organisms via MCP. 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/biosamples
- **Repository:** https://github.com/pipeworx-io/mcp-biosamples
- **MCP Registry name:** io.github.pipeworx-io/biosamples
- **Categories:** genomics data
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

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

```sh
https://gateway.pipeworx.io/biosamples/mcp
```

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

```json
{
  "mcpServers": {
    "biosamples": {
      "url": "https://gateway.pipeworx.io/biosamples/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

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

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

## Alternatives

- [Gtex](https://ai-powered.com/mcp/gtex): Gtex is a freemium MCP server for sports data.

---
Source: https://ai-powered.com/mcp/biosamples
