uniprot-mcp
Auditable UniProt MCP server with per-response SHA-256 provenance, release pinning, verification, and offline replay.
Install / Use
claude mcp add smaniches -- npx -y github:smaniches/uniprot-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of uniprot-mcp
uniprot-mcp scores 80/100 on our quality scale, 532nd of 606 Data & Analytics skills we index.
Its MCP Server is 30 KB long, well organised into 44 sections with 22 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 4 days ago, so uniprot-mcp is actively maintained.
- Our last check on 2026-09-23 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
uniprot-mcp compared with similar skills
All 4 of these similar skills score higher than uniprot-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| uniprot-mcp (this skill)by smaniches | 80 | 3 | 4d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install uniprot-mcp?
- Run
claude mcp add smaniches -- npx -y github:smaniches/uniprot-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does uniprot-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is uniprot-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is uniprot-mcp still maintained?
- The repository was last updated 4 days ago, so uniprot-mcp is actively maintained.
Skill content
View source on GitHubUniProt MCP Server
Produce verifiable, release-aware protein evidence packages from UniProt and linked scientific sources.
Use this MCP server to find proteins, assemble protein, target, and variant evidence, and keep a checkable record of where each result came from. Responses preserve source-specific provenance, including the provider, retrieval time, source URL, and a SHA-256 digest. A release identifier is present when the provider supplies one. uniprot_provenance_verify can compare recorded UniProt REST records with current UniProt data; it does not independently verify ClinVar or AlphaFold DB results.
The complete tool catalog remains available for specialized research workflows.
Author: Santiago Maniches · ORCID 0009-0005-6480-1987 · TOPOLOGICA LLC
Research authorship: Santiago Maniches independently maintains this server and is the sole scientific author of its project-specific research contributions. AI-assisted tools have supported development, testing, and internal review under his direction. UniProt records, linked source data, and underlying third-party methods retain their original authorship; internal tool-assisted review is not external scientific validation.
Run it in one line:
uvx uniprot-mcp-server
Provenance: a source-backed TP53 capture
The TP53 R175H example is a real capture from October 15, 2026, not a hypothetical model transcript. Its UniProt, ClinVar and AlphaFold DB responses are saved with their original response bytes in the capture directory. The contract test recomputes raw and canonical SHA-256 values from the saved upstream bytes and checks their captured footer URLs and hashes. It separately compares the transcript text with a saved tool-output record; it does not independently re-derive every parsed statement from those bytes.
For example, the captured UniProt P04637 response has:
Source: UniProt release 2026_03 (02-September-2026)
Retrieved: 2026-10-15T10:32:43Z
URL: https://rest.uniprot.org/uniprotkb/P04637
Canonical SHA-256: 112540dcb662c3ce2feba05272ce0e946ce76089a5bcf8346eb55141892f7fcf
To validate this historical capture from a repository checkout:
pytest -q tests/contract/test_tp53_capture_binding.py
To compare the current upstream record with the captured one, invoke
uniprot_provenance_verify with the URL, release and digest above.
A live response can legitimately differ from the October 2026 capture;
do not assume that its verification verdict will be verified.
This verifies source digest binding and that two recorded text copies agree, not the scientific correctness of every parsed claim. ClinVar's germline classification does not establish somatic actionability, and a model-wide AlphaFold confidence summary does not establish confidence at a specific residue.
Installation
Run without installing (recommended):
uvx uniprot-mcp-server
Or install into an environment:
pip install uniprot-mcp-server
Note: There is an unrelated package named
uniprot-mcpon PyPI (different author, 5 tools, MIT). This package isuniprot-mcp-server. Runningpip install uniprot-mcpwill install the wrong package silently.
For researchers — where to start
If you are a biomedical researcher visiting this repo, the highest-signal places to look are:
| Resource | What it gives you |
|---|---|
| MCP tool documentation | Live UniProt source access, accession-level lookups, provenance, and optional AlphaFold structure-confidence retrieval. No separate hand-maintained clinical collection is distributed. |
| TP53 R175H capture | Dated live transcript, preserved upstream response bytes, digest/footer checks, and recorded text comparison. Not independently validated biomedical interpretation. The illustrative transcripts were withdrawn. |
| tests/benchmark/ | A 30-prompt benchmark protocol with a sealed answer key (SHA-256 commitments on main). On 2026-04-26 the answer key was re-derived 30/30 from live UniProt; the record is in tests/benchmark/run-2026-04-26-v1.1.0/. That check validates the answers, not this server: no server or baseline has been run against the prompts, and the runner and scorer are scaffolds. |
| scripts/replicate.sh | One-command verification that the published PyPI wheel was built from this exact repo (cross-checks SHA-256 across PyPI / GitHub Release / SLSA attestation; runs --self-test; re-derives the benchmark answers from live UniProt). POSIX + scripts/replicate.ps1 for Windows. |
| docs/COMPETITIVE_LANDSCAPE.md | Honest 14-server survey of the bio-MCP space (April 2026) and the specific differentiation this server claims. |
Issues / corrections welcome at https://github.com/smaniches/uniprot-mcp/issues. Tool results are source-attributed; UniProt annotations and predicted structural confidence retain their upstream evidence type. No separate clinical disease index is maintained.
What makes this different
| | uniprot-mcp | Vanilla LLM + WebFetch | A typical bio-MCP |
|---|---|---|---|
| Tool surface | 41 tools, 8 families | none — caller writes URLs | usually 5–10 |
| Source provenance | provider • date • URL • SHA-256 (release where available) | none | sometimes URL only |
| UniProt REST verification | uniprot_provenance_verify compares recorded UniProt REST responses; external ClinVar/AlphaFold origins are outside its scope | varies | varies |
| Release pinning | --pin-release=YYYY_MM raises on drift | n/a | n/a |
| Benchmark protocol | 30 pre-registered prompts with a SHA-256-sealed answer key on main and an answer verifier; no system has been evaluated against it yet | n/a | n/a |
| Local provenance cache | uniprot_replay_from_cache read primitive (automatic cache write-through is not wired into the request path — see §Provenance & verification) | n/a | n/a |
| Clinical primitives | sequence chemistry / position-aware features / HGVS variant lookup / disease associations / AlphaFold pLDDT / ClinVar | none | none |
| Composition tool | uniprot_target_dossier — one call, nine sections | n/a | n/a |
| Input validation | regex + length cap before any HTTP call | none | partial |
| Error-channel safety | upstream exception text never echoed to LLM | n/a | partial |
| Cross-origin allowlist | enumerated, threat-modelled, privacy-listed | n/a | usually unaudited |
| Supply chain | SLSA build provenance + Sigstore + CycloneDX SBOM, produced by the release workflow | n/a | rare |
| Test layers | unit + property + contract + client + integration | n/a | usually unit only |
| Mutation testing | weekly + on-demand workflow, measurement only: no kill-rate threshold is enforced. Last recorded per-module results (April 2026): cache 82 %, proteinchem 92 %, client 70 % — see docs/MUTATION_SCORES.md | n/a | rare |
The provenance + verify chain is, in my 2026-04-26 survey, absent
from every other bio-MCP I could find. A regulated user can take any
prior uniprot-mcp answer and prove — without contacting the author
— that UniProt still returns the same bytes, or detect exactly how the
upstream has drifted. If you find a counter-example I missed, please
file an issue and I will update the comparison.
Tools (41)
Eight endpoint families. All read-only (readOnlyHint: true). All
but uniprot_replay_from_cache interact with at least one upstream
service (openWorldHint: true). No UniProt API key required.
Core UniProtKB (10)
| Tool | Purpose |
|---|---|
| uniprot_get_entry | Full UniProt entry (e.g. P04637 for p53). Function, gene, organism, disease, cross-refs. |
| uniprot_search | UniProt query language — gene, organism, taxon ID, reviewed flag, free text. |
| uniprot_get_sequence | FASTA. PIR-style provenance comment block above the first record (BLAST+ / biopython compatible). |
| uniprot_get_features | Domains, binding sites, PTMs, signal peptides — optional type filter. |
| uniprot_get_variants | Natural variants and disease mutations. |
| uniprot_get_go_terms | GO annotations grouped by aspect (F / P / C). |
| uniprot_get_cross_refs | Raw cross-references to PDB, Pfam, Ensembl, Reactome, KEGG, STRING … |
| uniprot_id_mapping | Map IDs between databases (Gene_Name → UniProtKB, PDB → UniProtKB, …). |
| uniprot_batch_entries | Up to 100 entries in one call; invalid accessions filtered client-side. |
| uniprot_taxonomy_search | Search UniProt taxonomy by organism name. |
Controlled vocabularies (4)
| Tool | Purpose |
|---|---|
| uniprot_get_keyword | Keyword by ID (e.g. KW-0007 = Acetylation). Definition, synonyms, GO refs, hierarchy. |
| uniprot_search_keywords | Free-text keyword search. |
| uniprot_get_subcellular_location | Subcellular-location term by ID (e.g. SL-0039 = Cell membrane). |
| uniprot_search_subcellular_locations | Free-text location search. |
Sequence archives & clusters (4)
| Tool | Purpose |
|---|---|
| uniprot_get_uniref | UniRef cluster by ID (UniRef50_P04637, UniRef90_P04637, UniRef100_P04637). |
| uniprot_search_uniref | Cluster search with identity_tier filter (50 / 90 / 100). |
| uniprot_get_uniparc | Sequence-archive record by UPI (UPI000002ED67). |
| uniprot_search_uniparc | UniParc full-text search. |
Proteomes & literature (4)
| Tool | Purpose |
|---|---|
| uniprot_get_proteome | Proteome by UP ID (UP000005640 = human). Counts, BUSCO score, components. |
| uniprot_search_proteomes | Filter by organism / type / completeness. |
| uniprot_get_citation | Citation record by ID (typically a PubMed numeric ID). |
| uniprot_search_citations | Index search across UniProt citations. |
Structured cross-DB resolvers (4)
Gateway-only — no calls l
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
