{"data":{"name":"io.github.cyanheads/uniprot-mcp-server","title":null,"description":"Protein research over UniProtKB: search by function, fetch curated records, map IDs, proteomes.","version":"0.2.6","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/uniprot-mcp-server","remotes":[{"url":"https://uniprot.caseyjhand.com/mcp","type":"streamable-http"}],"packages":[{"version":"0.2.6","identifier":"@cyanheads/uniprot-mcp-server","runtimeHint":"stdio","registryType":"npm","runtimeArguments":null,"environmentVariables":null},{"version":"0.2.6","identifier":"@cyanheads/uniprot-mcp-server","runtimeHint":"streamable-http","registryType":"npm","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-10-12T23:10:04.032Z","updatedAt":"2026-10-12T23:10:04.032Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":null,"source":"official-registry","sourceId":"io.github.cyanheads/uniprot-mcp-server","updatedAt":"2026-10-12T23:10:04.032Z","confidence":100,"websiteUrl":null,"description":"Protein research over UniProtKB: search by function, fetch curated records, map IDs, proteomes.","verification":"official","repositoryUrl":"https://github.com/cyanheads/uniprot-mcp-server"}],"toolIndex":{"tools":[{"serverName":"io.github.cyanheads/uniprot-mcp-server","endpointFingerprint":"42e2b2451ff721d51884bcab9630f69f3f124889c07ad22fae59081ddb68c652","name":"uniprot_get_entry","title":"uniprot-mcp-server: get entry","description":"Fetch full curated UniProtKB entries by accession in one batch of up to 20 distinct accessions; repeats collapse, and any further accessions return in deferredAccessions to pass as accessions on the next call. Each entry carries alternative names, function, EC numbers and catalytic activity, cofactors, active and binding sites with their ligands, subcellular location and membrane topology, disease involvement, PTMs, molecule processing (signal, propeptides, chains), natural variants, isoforms, domains, free-text comments (PTM, pathway, subunit, tissue specificity), GO terms with their evidence, keywords, cross-references, and Ensembl gene IDs; mutagenesis and IntAct interaction partners come back when sections or fields name them. Partial failures do not abort the batch — resolved entries land in succeeded[] and unknown or inactive (merged, demerged, deleted) accessions in failed[], where an inactive accession names its replacement or UniParc ID. Pass fields to trim the upstream projection; a field this tool cannot return (e.g. sequence) is not requested and is listed in ignoredFields with a notice. Each record is measured on its own across both output surfaces: one within 24,000 UTF-8 bytes returns in succeeded[]; a larger one is listed in outlinedEntries with its size instead. Re-call an outlined accession alone, e.g. accessions:[\"P04637\"], for its section outline (kind: \"outline\", sections with byte sizes), then add sections:[\"disease\",\"variants\"] to select sections. sections takes exactly one accession; trim a batch with fields instead. All returned list items and cross-reference IDs render in full. A large list section pages with section_limit/section_offset on a re-call naming that one section. This tool does not search: accessions come from uniprot_search_proteins.results[].accession or uniprot_map_ids. Strip any isoform suffix (P04637-2 to P04637) before calling.","inputSchema":{"type":"object","properties":{"accessions":{"minItems":1,"type":"array","items":{"type":"string","pattern":"^(?:[OPQ][0-9][A-Z0-9]{3}[0-9]|[A-NR-Z][0-9](?:[A-Z][A-Z0-9]{2}[0-9]){1,2})$","description":"A UniProtKB primary accession, e.g. \"P04637\". Canonical form only — strip any \"-N\" isoform suffix."},"maxItems":500,"description":"Accessions to fetch (1–500). Repeats collapse to their first occurrence; the first 20 distinct are fetched and the rest return in deferredAccessions, in order, for the next call. From uniprot_search_proteins or uniprot_map_ids."},"fields":{"description":"Comma-separated UniProtKB return-field names to fetch in place of the default record, e.g. \"accession,cc_function,ft_variant,xref_pdb\" — trims a batch. Omit for the default record. The identity fields always come back. Names are case-insensitive; keywordid is sent as keyword and rhea as cc_catalytic_activity. Any xref_ field (e.g. xref_reactome) fills xrefs. A field this tool does not return (e.g. sequence, which uniprot_get_sequence returns, or ft_helix) is not requested from UniProt and comes back in ignoredFields with a notice listing the supported fields. An xref_ database UniProt does not know, or text that is not a field name, fails invalid_fields with UniProt's message.","type":"string"},"sections":{"description":"Section keys to return for one accession, e.g. [\"disease\",\"variants\"]: the record is cut to these plus its identity fields. Re-call an accession with it after a kind: \"outline\" response, or name the on-request sections mutagenesis and interactions, which the default record leaves out — without fields, naming one fetches it; with fields, include ft_mutagen or cc_interaction there. Requires exactly one accession: a batch with sections is rejected, so trim a batch with fields. A requested section the record lacks is named in absentSections, not an error.","type":"array","items":{"type":"string","description":"A section key of the entry record, e.g. \"disease\", \"variants\", \"mutagenesis\", \"interactions\". Case-insensitive."}},"section_limit":{"type":"integer","minimum":1,"description":"Window size for one list section on a sections re-call: return at most this many items of it (at least 1; a value past the remaining items returns them all). Requires sections naming exactly one list section, e.g. [\"variants\"] (or ptms, domains, goTerms). Omit together with section_offset to return the whole section."},"section_offset":{"description":"Zero-based index of the first item in the windowed section. Defaults to 0. Pass the previous response's nextOffset to page forward. Same requirements as section_limit; set without section_limit, returns every item from this index on.","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["accessions"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"2b112db3ccbce68cbb9a66ee26bea33b0e41bc218ed1c5c9efe275c83feef08c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T08:46:24.512Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/uniprot-mcp-server","endpointFingerprint":"42e2b2451ff721d51884bcab9630f69f3f124889c07ad22fae59081ddb68c652","name":"uniprot_get_proteome","title":"uniprot-mcp-server: get proteome","description":"Fetch the reference proteome for an organism by UPID (e.g. \"UP000005640\") or NCBI taxon ID (e.g. 9606) — provide exactly one. Returns metadata inline: proteome type, total protein count, BUSCO completeness (score, complete/fragmented/missing counts, lineage dataset), and the genome assembly accession. The protein set is opt-in via include_proteins (it is large — human is ~147,506) and returns a capped page with a forward cursor; narrow it with the query filter (UniProtKB Lucene syntax) for a subset. Resolve an organism name to a taxon ID first with uniprot_get_taxonomy.","inputSchema":{"type":"object","properties":{"upid":{"description":"Proteome UPID. Provide this OR taxon_id, not both.","anyOf":[{"type":"string","const":""},{"type":"string","pattern":"^UP[0-9]{9}$","description":"Proteome identifier, e.g. \"UP000005640\"."}]},"taxon_id":{"description":"NCBI taxon ID, e.g. 9606 for human. Prefers an exact reference proteome; otherwise resolves a unique descendant reference, or returns candidate UPIDs and taxon IDs for explicit selection. Provide this OR upid, not both.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"include_proteins":{"default":false,"description":"When true, also return a capped, cursor-paginated page of the proteome's proteins. Defaults to false — metadata alone is the common case.","type":"boolean"},"query":{"description":"Optional UniProtKB Lucene filter to narrow the protein list, e.g. \"reviewed:true AND keyword:KW-0067\". Only applies when include_proteins is true.","type":"string"},"size":{"type":"integer","minimum":1,"description":"Proteins per page when include_proteins is true. Default 25; a value above 500, UniProt's page maximum, returns 500 and says so."},"cursor":{"description":"Opaque cursor from this tool for the same resolved UPID and exact query. Identifier aliases resolving to that UPID and size changes are allowed. Older raw cursors are rejected; restart without cursor. Only meaningful with include_proteins.","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"350a56736834d8f16781b7bf40ce5975ac281dac13385cd9637df077f72ad2fa","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T08:46:24.512Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/uniprot-mcp-server","endpointFingerprint":"42e2b2451ff721d51884bcab9630f69f3f124889c07ad22fae59081ddb68c652","name":"uniprot_get_sequence","title":"uniprot-mcp-server: get sequence","description":"Fetch the canonical amino-acid sequence (FASTA) for a UniProtKB accession, with length and the parsed header. Set include_isoforms to also return the alternatively-spliced isoform sequences. This is the cheap sequence-only path — for the full functional record use uniprot_get_entry. A merged accession returns the sequences of its merge target, labelled with the target accession and the requested one in mergedFrom; a demerged or deleted accession fails not_found naming its replacements or UniParc ID. Accessions come from uniprot_search_proteins or uniprot_map_ids; strip any \"-N\" isoform suffix (P04637-2 to P04637) before calling.","inputSchema":{"type":"object","properties":{"accession":{"type":"string","pattern":"^(?:[OPQ][0-9][A-Z0-9]{3}[0-9]|[A-NR-Z][0-9](?:[A-Z][A-Z0-9]{2}[0-9]){1,2})$","description":"UniProtKB primary accession, e.g. \"P04637\". Canonical form only — strip any \"-N\" isoform suffix."},"include_isoforms":{"default":false,"description":"When true, also return the isoform sequences. Defaults to false (canonical only).","type":"boolean"}},"required":["accession"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"53645a425256a8b1e9bf5879d82d901a5ff785937577304fe102a19ab080a2b7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T08:46:24.512Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/uniprot-mcp-server","endpointFingerprint":"42e2b2451ff721d51884bcab9630f69f3f124889c07ad22fae59081ddb68c652","name":"uniprot_get_taxonomy","title":"uniprot-mcp-server: get taxonomy","description":"Resolve a taxonomy record by NCBI taxon ID (e.g. 9606) or organism name (e.g. \"Homo sapiens\" or \"human\") — provide exactly one. Exact case-insensitive scientific names take priority, then common names, mnemonic and aliases; stray double quotes and backslashes are tolerated after exact matching. Ties and partial matches return candidate taxon IDs instead of guessing. Returns the scientific and common name, mnemonic, rank, parent, and full lineage. Set include_children for immediate child taxa in pages of 100; pass the returned cursor for the next page. Use the resolved taxon ID with uniprot_search_proteins (organism_id) or uniprot_get_proteome (taxon_id).","inputSchema":{"type":"object","properties":{"taxon_id":{"description":"NCBI taxonomy ID, e.g. 9606. Provide this OR name, not both.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"name":{"description":"Organism name, e.g. \"Homo sapiens\" or \"human\". Exact case-insensitive scientific names take priority, then common names, mnemonic and aliases. Stray double quotes and backslashes are tolerated only after exact matching; ties require taxon_id. Provide this OR taxon_id, not both.","type":"string"},"include_children":{"default":false,"description":"When true, also fetch a page of up to 100 immediate child taxa via a follow-up search. Defaults to false.","type":"boolean"},"cursor":{"description":"Forward-pagination cursor from a prior children page, for the next page of the same taxon; a cursor issued for another taxon is rejected. Only meaningful with include_children.","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"ce885765f669f0479e3b2f4b2534513bc40cccb764217efb284d4495b9e51025","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T08:46:24.512Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/uniprot-mcp-server","endpointFingerprint":"42e2b2451ff721d51884bcab9630f69f3f124889c07ad22fae59081ddb68c652","name":"uniprot_map_ids","title":"uniprot-mcp-server: map IDs","description":"Translate identifiers across databases via UniProt's ID-mapping service — gene names to accessions, accession to PDB / Ensembl / RefSeq / ChEMBL / GeneID, and back. The job runs asynchronously; this tool submits it and polls within a budget. A running job returns status \"running\" with a ticket; pass that ticket alone to poll the same job. A completed call returns status \"finished\" with one results page; when continuation is present, pass it alone to fetch the next completed page without re-submitting or polling the job. A gene name often maps to one reviewed Swiss-Prot accession plus dozens of unreviewed TrEMBL ones, so target UniProtKB-Swiss-Prot (reviewed only) for the usual intent, or UniProtKB to include TrEMBL. Pair a gene-symbol from_db with tax_id to disambiguate species. A row whose UniProtKB target is inactive (merged, demerged, or deleted) carries an inactive marker naming its replacements. Chain the resulting active accessions into uniprot_get_entry.","inputSchema":{"type":"object","properties":{"from_db":{"description":"Source database. Gene_Name = gene symbol (e.g. TP53; pair with tax_id); UniProtKB_AC-ID = accession or entry name; Ensembl/Ensembl_Protein = ENSG/ENSP; PDB; RefSeq_Nucleotide/RefSeq_Protein = NM_/NP_; ChEMBL; GeneID = NCBI Gene. Required only when submitting a new mapping job; omitted when resuming with a ticket or continuation.","type":"string","enum":["UniProtKB_AC-ID","Gene_Name","GeneID","Ensembl","Ensembl_Protein","PDB","RefSeq_Nucleotide","RefSeq_Protein","ChEMBL","PomBase","WormBase_Protein"]},"to_db":{"description":"Target database. UniProtKB-Swiss-Prot = reviewed accessions only (the usual intent); UniProtKB also includes unreviewed TrEMBL. Required only when submitting a new mapping job; omitted when resuming with a ticket or continuation.","type":"string","enum":["UniProtKB","UniProtKB-Swiss-Prot","Gene_Name","GeneID","Ensembl","Ensembl_Protein","PDB","RefSeq_Nucleotide","RefSeq_Protein","ChEMBL","PomBase","WormBase_Protein"]},"ids":{"description":"Identifiers to translate. Required only when submitting a new mapping job; omitted when resuming with a ticket or continuation.","maxItems":100000,"type":"array","items":{"type":"string","description":"A source identifier in the from_db namespace, e.g. \"TP53\" for Gene_Name."}},"tax_id":{"description":"Exact NCBI taxon node for submission, e.g. 9606 for human. Unlike protein search taxonomy filters, this excludes descendant strains and subspecies. Resolve the strain taxon with uniprot_get_taxonomy when needed; no descendant filtering is applied to mapped results.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"ticket":{"description":"Running-job ticket from a prior status \"running\" response. Pass it alone to poll that job; do not combine it with continuation or submission inputs.","type":"string","minLength":1},"continuation":{"description":"Completed-page continuation from a prior status \"finished\" response. Pass it alone to fetch the next page without polling or re-submitting.","type":"object","properties":{"jobId":{"type":"string","minLength":1,"description":"UniProt ID-mapping job identifier for the completed job."},"cursor":{"type":"string","minLength":1,"description":"Opaque cursor for the next completed results page."}},"required":["jobId","cursor"]}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"f796b1e5774e9a686a6e68bebec1059545f482e2ef017eed5745a4f95d015832","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T08:46:24.512Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/uniprot-mcp-server","endpointFingerprint":"42e2b2451ff721d51884bcab9630f69f3f124889c07ad22fae59081ddb68c652","name":"uniprot_search_proteins","title":"uniprot-mcp-server: search proteins","description":"Search UniProtKB and return curated protein records. Pass text_search for a plain-language query (the 80% case) or query for the full Lucene field syntax (gene:TP53 AND organism_id:9606 AND reviewed:true) — exactly one is required. Reviewed (Swiss-Prot) entries are manually curated; unreviewed (TrEMBL) are computationally predicted and ~30x more numerous, so reviewed defaults to true to avoid drowning in predictions — set it false to search both tiers together (for TrEMBL only, put reviewed:false in query). The organism_id and reviewed filters apply to the whole query. Request facets (e.g. reviewed, model_organism) for server-side count breakdowns. Results page forward with an opaque cursor; UniProtKB has no offset paging. An inactive accession the query matches (merged, demerged, or deleted) comes back in inactive[] with the accessions that replace it, never as a result. This is the discovery entry point — chain results[].accession into uniprot_get_entry for full records, or uniprot_get_sequence for FASTA.","inputSchema":{"type":"object","properties":{"text_search":{"description":"Plain-language search across protein names, gene names, and function, e.g. \"kinase apoptosis\". Punctuation and uppercase AND/OR/NOT are searched as text, with UniProt tokenization; use query for operators and field syntax. Provide this OR query, not both.","type":"string"},"query":{"description":"UniProtKB Lucene query with field prefixes — gene, organism_id, keyword (KW-xxxx), go (GO id), reviewed, protein_name, family, length, existence, accession. Example: \"gene:BRCA1 AND organism_id:9606 AND reviewed:true\". Provide this OR text_search, not both.","type":"string"},"reviewed":{"default":true,"description":"Restrict to reviewed Swiss-Prot entries. Defaults to true (curated only). false applies no tier filter, returning reviewed and unreviewed TrEMBL entries together; for TrEMBL only, put reviewed:false in query. Ignored when query already contains a reviewed: clause; plain text never overrides this filter.","type":"boolean"},"organism_id":{"description":"Restrict to an NCBI taxon and its descendants, including strains and subspecies, e.g. 9606 for human or 562 for E. coli. Applies taxonomy_id to the whole query; use an explicit organism_id: clause in query for an exact taxon. Resolve names with uniprot_get_taxonomy.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fields":{"description":"Comma-separated UniProtKB return-field names that trim each hit, e.g. \"accession,gene_names\" to drop the function snippet. Omit for the default hit: name, gene, organism, length, reviewed, score, and a function snippet. The identity fields always come back. Hits carry only these fields: accession, id, protein_name, gene_names, gene_primary, gene_synonym, gene_oln, gene_orf, organism_name, organism_id, length, reviewed, annotation_score, protein_existence, cc_function. Any other field (e.g. ec, ft_act_site, xref_pdb) is not requested and comes back in ignoredFields with a notice — fetch it with uniprot_get_entry. Text that is not a field name fails invalid_query with UniProt's message.","type":"string"},"facets":{"description":"Comma-separated upstream facet names for count breakdowns, e.g. \"reviewed,model_organism,proteins_with\". Returns a facets array alongside the hits.","type":"string"},"size":{"type":"integer","minimum":1,"description":"Number of hits per page. Default 25; a value above 500, UniProt's page maximum, returns 500 and says so."},"cursor":{"description":"Opaque forward cursor from this tool for the same exact effective query and filters. Size, fields, and facets may change. Older raw cursors are rejected; restart without cursor. Random access to page N is not supported.","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"5f6a769b95a946be9e2ec18be07fc09a23e4168e3d3dcf1a3e26e0782de46a7a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T08:46:24.512Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"42e2b2451ff721d51884bcab9630f69f3f124889c07ad22fae59081ddb68c652","protocol":"streamable-http","status":"indexed","toolCount":6,"observedAt":"2026-11-19T08:46:24.512Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.cyanheads/uniprot-mcp-server":{"url":"https://uniprot.caseyjhand.com/mcp"}}},"Cursor":{"mcpServers":{"io.github.cyanheads/uniprot-mcp-server":{"url":"https://uniprot.caseyjhand.com/mcp"}}},"VS Code":{"servers":{"io.github.cyanheads/uniprot-mcp-server":{"type":"http","url":"https://uniprot.caseyjhand.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://uniprot.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/uniprot-mcp-server","registryType":"npm","version":"0.2.6"},{"protocol":"mcp","package":"@cyanheads/uniprot-mcp-server","registryType":"npm","version":"0.2.6"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.cyanheads%2Funiprot-mcp-server","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.cyanheads%2Funiprot-mcp-server","name":"io.github.cyanheads/uniprot-mcp-server","description":"Protein research over UniProtKB: search by function, fetch curated records, map IDs, proteomes.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://uniprot.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/uniprot-mcp-server","registryType":"npm","version":"0.2.6"},{"protocol":"mcp","package":"@cyanheads/uniprot-mcp-server","registryType":"npm","version":"0.2.6"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/uniprot-mcp-server","version":"0.2.6"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.cyanheads/uniprot-mcp-server","status":"online","lastCheckedAt":"2026-11-20T09:18:09.632Z","lastSuccessfulCheck":"2026-11-20T09:18:09.632Z","latencyMs":243,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T09:18:09.632Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T09:18:09.632Z"},"security":null,"timestamps":{"createdAt":"2026-10-12T23:10:04.032Z","updatedAt":"2026-10-12T23:10:04.032Z","observedAt":"2026-11-20T09:18:09.632Z"},"compatibility":{"serverVersion":"0.2.6","protocolVersions":[{"protocol":"mcp","version":null}]}}}}