data-aggregator-mcp
by musharna
README.md
# data-aggregator-mcp
data-aggregator-mcp is an MCP server that lets AI agents search 21 public
research-data sources at once and get back one deduplicated list.
[](https://github.com/musharna/data-aggregator-mcp/actions/workflows/ci.yml)
[](https://pypi.org/project/data-aggregator-mcp/)
[](https://pypi.org/project/data-aggregator-mcp/)
[](https://github.com/musharna/data-aggregator-mcp/blob/main/LICENSE)
[](https://doi.org/10.5281/zenodo.21636332)
[](https://glama.ai/mcp/servers/musharna/data-aggregator-mcp)
<!--
mcp-name: io.github.musharna/data-aggregator-mcp
-->
<p align="center">
<img src="https://raw.githubusercontent.com/musharna/data-aggregator-mcp/main/examples/assets/demo.svg"
alt="Live calls over stdio: a search for transcriptome data on Orobanche aegyptiaca that NCBI Taxonomy expands to Phelipanche aegyptiaca and that returns hits from SRA, BioProject, PubMed, OpenAIRE and DataCite; resolving one SRA hit to two FASTQ files with sizes and md5 checksums; fetching an OpenML ARFF file with its md5 verified; and SQL over a remote CSV on Hugging Face without downloading it"
width="820">
</p>
## Does it help?
Not shown yet: there has been one small held-out round (5 tasks, 2 runs each,
Claude Sonnet 5.5), and on it this server is not separated from web search. Its
mean recall was higher than web search's on 4 of 5 tasks (sign test p = 0.38):
| Tools given to the agent | Mean recall |
| --- | :---: |
| this server | 0.49 |
| web search | 0.35 |
| ToolUniverse | 0.26 |
It made fewer tool calls than web search (7.7 fewer per run, 95% CI 1.8 to 13.1)
and ToolUniverse; cost and wall time against web search are not separated.
Method and controls:
[benchmarks/h2h](https://github.com/musharna/data-aggregator-mcp/blob/main/benchmarks/h2h/README.md).
## Install
Claude Code:
```bash
claude mcp add data-aggregator -- uvx data-aggregator-mcp
```
One-click install for VS Code or Cursor:
[](https://insiders.vscode.dev/redirect/mcp/install?name=data-aggregator&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22data-aggregator-mcp%22%5D%7D)
[](https://cursor.com/install-mcp?name=data-aggregator&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJkYXRhLWFnZ3JlZ2F0b3ItbWNwIl19)
Any other MCP client: run `uvx data-aggregator-mcp` as a stdio server.
<details>
<summary>Claude Desktop, pip, and the <code>operate</code> extra</summary>
Claude Desktop (`claude_desktop_config.json`) and most other clients:
```json
{
"mcpServers": {
"data-aggregator": {
"command": "uvx",
"args": ["data-aggregator-mcp"],
"env": { "NCBI_API_KEY": "your-optional-key" }
}
}
}
```
With pip:
```bash
pip install data-aggregator-mcp
data-aggregator-mcp # or: python -m data_aggregator_mcp
```
`operate` (SQL and previews over remote files) needs an optional extra:
`pip install "data-aggregator-mcp[operate]"`.
</details>
## What you can ask
**"Find transcriptomes for Orobanche aegyptiaca."** The species was renamed; NCBI
Taxonomy maps it to *Phelipanche aegyptiaca*, and the sources that accept synonyms
match both names (the demo above).
**"What data came out of this paper?"**
```text
resolve("pubmed:40098680")
links geo:GSE284240, bioproject:PRJNA1198054, and 18 sra: experiments
files PMC11910882.xml (open-access full text)
```
**"Can I train a model on this dataset?"**
```text
resolve("hf:scikit-learn/iris", use="ml-training")
license_compat ALLOW: "CC0-1.0 grants the permission(s) required for
ml-training: commercial-use, modifications"
```
The verdict is read from the record's license metadata; it is advice, not a legal
opinion. `resolve` also renders citations in any CSL style, checks Crossref for
retractions, scores FAIRness, and exports Croissant or RO-Crate. `relate` reports
how a set of records connect (a shared accession, DOI or explicit link).
## How a search runs
<p align="center">
<img src="https://raw.githubusercontent.com/musharna/data-aggregator-mcp/main/docs/assets/architecture.svg"
alt="How one search runs: NCBI Taxonomy maps Orobanche aegyptiaca to its current name, Phelipanche aegyptiaca, and the sources that accept synonyms search both names; the query goes to 21 sources in parallel (11 archives, 9 omics, 1 literature); records that share a DOI become one, keeping the copy that can be downloaded; a record can then be resolved to files and checksums, fetched with the checksum verified where the source publishes one, or queried with SQL without downloading it"
width="820">
</p>
A source that fails is named in the result's `errors`, never dropped silently.
What each source can fetch, and which checksum it is verified against:
[docs/sources.md](https://github.com/musharna/data-aggregator-mcp/blob/main/docs/sources.md).
## Compared with other servers
| Server | Searches | One search | Checksum | Remote SQL | License check |
| --- | --- | :---: | :---: | :---: | :---: |
| **data-aggregator-mcp** | 21 sources: data archives, omics, papers | yes, DOI dedup | where published | yes | yes |
| [Mobus](https://github.com/mobus-ai/Mobus) | 20 general and ML data platforms | yes | — | row preview | yes |
| [paper-search-mcp](https://github.com/openags/paper-search-mcp) | papers: arXiv, PubMed, OpenAlex, Crossref and more | yes, deduplicated | — | — | — |
| [ToolUniverse](https://github.com/mims-harvard/ToolUniverse) | 1000+ tools: models, datasets, APIs, packages | papers | — | — | — |
| [BioMCP](https://github.com/genomoncology/biomcp) | genes, variants, trials, drugs, proteins, papers | yes (`search all`) | — | — | — |
— means the project's README doesn't describe it (READMEs read 2026-10-04).
Where they are ahead: BioMCP reaches clinical trials, ChEMBL and AlphaFold;
ToolUniverse covers far more ground overall; paper-search-mcp covers far more
literature sources; Mobus also compares datasets and checks schema compatibility.
More: [docs/POSITIONING.md](https://github.com/musharna/data-aggregator-mcp/blob/main/docs/POSITIONING.md).
## Reference and development
Every tool and parameter, the HTTP transport (`--transport http`) and the
environment variables:
[docs/reference.md](https://github.com/musharna/data-aggregator-mcp/blob/main/docs/reference.md).
Sources that need every word of a query, and how they are searched:
[every-word sources](https://github.com/musharna/data-aggregator-mcp/blob/main/docs/reference.md#every-word-sources).
Tests, linting and the live API probes:
[CONTRIBUTING.md](https://github.com/musharna/data-aggregator-mcp/blob/main/CONTRIBUTING.md).
## License
MIT. See [LICENSE](https://github.com/musharna/data-aggregator-mcp/blob/main/LICENSE).
TDQS
A4.4/5.0
Scored across 6 tools
Disambiguation5/5
Each tool targets a distinct phase of the data workflow: search finds, resolve expands a known id, operate queries remote tabular files without downloading, fetch writes files to disk, list_sources introspects capabilities, and relate proposes joins. The boundaries between operate (in-place query) and fetch (download) and between search (discovery) and resolve (known-id lookup) are clearly drawn in the descriptions.
Naming Consistency4/5
Five tools are single snake_case verbs (search, resolve, operate, fetch, relate) and one is verb_noun (list_sources), a minor but readable deviation. No camelCase/snake_case mixing or synonym verbs like get/find/query for the same action.
Tool Count5/5
Six tools is well-scoped for a federated data-aggregation server, covering discovery, expansion, remote query, download, source introspection, and cross-record linking. Each tool maps to a distinct, non-redundant capability with no filler.
Completeness5/5
The surface covers the full read-only lifecycle for a data-aggregation domain: find records (search), get full metadata/files (resolve), inspect tabular data (operate), download artifacts (fetch), understand coverage/limits (list_sources), and link datasets (relate). No obvious dead ends remain for a consumer of external archives.
Maintenance
ActivityActive
ResponsivenessSlow