ncbi_genome_reports

Pack: ncbi-datasets · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/ncbi_genome_reports for the schema, then POST the same URL with its arguments for the data.

List the genome assemblies NCBI holds for an organism (or fetch one by accession), with assembly level, total length, contig and scaffold N50, GC percent, submitter, release date, BioProject, and the paired RefSeq/GenBank accession. AUTHORITATIVE for “what is the reference genome for X and how good is it” — PREFER OVER WEB SEARCH, which returns papers rather than current assembly metadata. Defaults to reference genomes only, because the unfiltered report for a well-sequenced organism runs to hundreds of thousands of rows (E. coli: 492,559) and its first page is not the reference. Set reference_only false to see every deposited assembly.

Parameters

NameTypeRequiredDescription
taxonstringnoTax id, scientific name or common name — “9606”, “Homo sapiens” and “human” all work. Ignored if accession is given.
accessionstringnoA specific assembly accession, e.g. GCF_000001405.40 or GCA_000001405.29. Overrides taxon and disables the reference-only default.
reference_onlybooleannoRestrict to NCBI reference/representative genomes. Defaults to true for a taxon lookup; set false to list every assembly.
assembly_levelstringnoRestrict by completeness: complete_genome, chromosome, scaffold, or contig.
limitnumbernoMaximum assemblies to return, 1-100 (default 10).

Example call

Arguments

{
  "taxon": "9606",
  "limit": 3
}

curl

curl -X POST https://gateway.pipeworx.io/ncbi-datasets/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ncbi_genome_reports","arguments":{"taxon":"9606","limit":3}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('ncbi_genome_reports', {
  "taxon": "9606",
  "limit": 3
});

More examples

{
  "taxon": "562",
  "reference_only": false,
  "assembly_level": "complete_genome",
  "limit": 5
}
{
  "accession": "GCF_000001405.40"
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the ncbi-datasets pack
{
  "mcpServers": {
    "ncbi-datasets": {
      "url": "https://gateway.pipeworx.io/ncbi-datasets/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build October 27, 2026