SkillAgentSearch skills...

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

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

80/100

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
3/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
uniprot-mcp (this skill)by smaniches8034d agoMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.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.
<!-- mcp-name: io.github.smaniches/uniprot-mcp -->

UniProt MCP Server

CI OpenSSF Scorecard GitHub Release PyPI version PyPI downloads/30d License: Apache 2.0 Python 3.11+ MCP compatible Coverage Provenance: SHA-256 + verify ORCID DOI Glama score Awesome MCP Servers

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-mcp on PyPI (different author, 5 tools, MIT). This package is uniprot-mcp-server. Running pip install uniprot-mcp will 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

View on GitHub
GitHub Stars3
CategoryData
Updated4d ago
Forks0

Languages

Python

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low