SureChEMBL MCP Server
Provides configuration support for running the SureChEMBL MCP server with Claude Desktop on macOS systems.
Enables running the SureChEMBL MCP server which provides tools for accessing the SureChEMBL chemical patent database for patent searches, chemical discovery, and structure analysis.
Used for implementing the SureChEMBL MCP server with type-safe API interactions to the SureChEMBL chemical patent database.
Supported as an export format for chemical data from the SureChEMBL database.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SureChEMBL MCP Server search for patents related to aspirin"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.

Unofficial SureChEMBL MCP Server
A comprehensive Model Context Protocol (MCP) server for accessing the SureChEMBL chemical patent database. This server provides tools for patent search, chemical discovery, structure analysis, and patent intelligence research.
Developed by Augmented Nature
Overview
SureChEMBL is a large-scale chemical patent database that provides access to chemical structures and their associated patent documents. This MCP server enables seamless integration with SureChEMBL's API, offering powerful tools for:
Patent Intelligence: Search and analyze chemical patents
Chemical Discovery: Find compounds and their patent coverage
Prior Art Research: Identify existing chemical disclosures
Competitive Analysis: Track chemical developments by companies
Structure-Activity Analysis: Correlate chemical structures with patent claims
Related MCP server: ChEMBL MCP Server
Features
π Document & Patent Search (4 tools)
search_patents- Search patents by text, keywords, or identifiersget_document_content- Get complete patent document content with chemical annotationsget_patent_family- Get patent family members and relationshipssearch_by_patent_number- Search by specific patent numbers
π§ͺ Chemical Search & Retrieval (4 tools)
search_chemicals_by_name- Search chemicals by name or synonymget_chemical_by_id- Get detailed chemical information by SureChEMBL IDsearch_by_smiles- Search chemicals by SMILES structure notationsearch_by_inchi- Search chemicals by InChI/InChI key
πΌοΈ Structure & Visualization (2 tools)
get_chemical_image- Generate chemical structure imagesget_chemical_properties- Get molecular properties and descriptors
π Data Export & Analysis (2 tools)
export_chemicals- Bulk export chemical data (CSV/XML)analyze_patent_chemistry- Analyze chemical content in patents
π¬ Advanced Analysis Tools (3 tools)
get_chemical_frequency- Get frequency statistics for chemicals across patent databasesearch_similar_structures- Find structurally similar chemicals using similarity searchget_patent_statistics- Get statistical overview of chemical content in patents
π Resource Templates
surechembl://document/{doc_id}- Patent document contentsurechembl://chemical/{chem_id}- Chemical compound datasurechembl://family/{patent_id}- Patent family informationsurechembl://search/{query}- Search results
Installation
Prerequisites
Node.js 18+
npm or yarn
Install Dependencies
npm installBuild the Server
npm run buildDevelopment Mode
npm run watchUsage
Running the Server
npm startUsing with Claude Desktop
Add to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"surechembl-server": {
"command": "node",
"args": ["/path/to/surechembl-server/build/index.js"]
}
}
}Using with MCP Inspector
npm run inspectorAPI Examples
Search for Chemicals by Name
// Search for aspirin-related compounds
await use_mcp_tool({
server_name: "surechembl-server",
tool_name: "search_chemicals_by_name",
arguments: {
name: "aspirin",
limit: 10,
},
});Get Patent Document Content
// Get full patent document with chemical annotations
await use_mcp_tool({
server_name: "surechembl-server",
tool_name: "get_document_content",
arguments: {
document_id: "WO-2020096695-A1",
},
});Generate Chemical Structure Image
// Generate structure image from SMILES
await use_mcp_tool({
server_name: "surechembl-server",
tool_name: "get_chemical_image",
arguments: {
structure: "CC(=O)OC1=CC=CC=C1C(=O)O",
width: 300,
height: 200,
},
});Analyze Patent Chemistry
// Analyze chemical annotations in a patent
await use_mcp_tool({
server_name: "surechembl-server",
tool_name: "analyze_patent_chemistry",
arguments: {
document_id: "US-2021123456-A1",
},
});Tool Reference
Document & Patent Search
search_patents
Search patents by text, keywords, or identifiers.
Parameters:
query(string, required): Search querylimit(number, optional): Results limit (1-1000, default: 25)offset(number, optional): Results offset (default: 0)
get_document_content
Get complete patent document content with chemical annotations.
Parameters:
document_id(string, required): Patent document ID (e.g., WO-2020096695-A1)
get_patent_family
Get patent family members and relationships.
Parameters:
patent_id(string, required): Patent ID to find family members for
search_by_patent_number
Search for patents by specific patent numbers.
Parameters:
patent_number(string, required): Patent or publication number
Chemical Search & Retrieval
search_chemicals_by_name
Search for chemicals by name, synonym, or common name.
Parameters:
name(string, required): Chemical name or synonymlimit(number, optional): Results limit (1-1000, default: 25)
get_chemical_by_id
Get detailed chemical information by SureChEMBL chemical ID.
Parameters:
chemical_id(string, required): SureChEMBL chemical ID (numeric)
search_by_smiles
Search for chemicals by SMILES structure notation.
Parameters:
smiles(string, required): SMILES stringlimit(number, optional): Results limit (1-1000, default: 25)
search_by_inchi
Search for chemicals by InChI or InChI key.
Parameters:
inchi(string, required): InChI string or InChI keylimit(number, optional): Results limit (1-1000, default: 25)
Structure & Visualization
get_chemical_image
Generate chemical structure image from SMILES or other structure notation.
Parameters:
structure(string, required): SMILES string or structure notationheight(number, optional): Image height in pixels (default: 200)width(number, optional): Image width in pixels (default: 200)
get_chemical_properties
Get molecular properties and descriptors for a chemical.
Parameters:
chemical_id(string, required): SureChEMBL chemical ID
Data Export & Analysis
export_chemicals
Bulk export chemical data in CSV or XML format.
Parameters:
chemical_ids(array, required): Array of SureChEMBL chemical IDs (1-100)output_type(string, optional): Export format - 'csv' or 'xml' (default: csv)kind(string, optional): ID type - 'cid' or 'smiles' (default: cid)
analyze_patent_chemistry
Analyze chemical content and annotations in a patent document.
Parameters:
document_id(string, required): Patent document ID to analyze
Advanced Analysis Tools
get_chemical_frequency
Get frequency statistics for chemicals across the patent database.
Parameters:
chemical_id(string, required): SureChEMBL chemical ID
search_similar_structures
Find structurally similar chemicals using similarity search.
Parameters:
reference_id(string, required): Reference chemical ID for similarity searchthreshold(number, optional): Similarity threshold (0.0-1.0, default: 0.7)limit(number, optional): Number of results to return (1-100, default: 25)
get_patent_statistics
Get statistical overview of chemical content in patents.
Parameters:
document_id(string, required): Patent document ID for statisticsinclude_annotations(boolean, optional): Include detailed annotation statistics (default: true)
Resource Templates
Document Resource
surechembl://document/{doc_id}Access complete patent document content with chemical annotations.
Chemical Resource
surechembl://chemical/{chem_id}Access chemical compound information and properties.
Patent Family Resource
surechembl://family/{patent_id}Access patent family members and relationships.
Search Resource
surechembl://search/{query}Access chemical search results for a query.
Error Handling
The server includes comprehensive error handling for:
Invalid API parameters
Network timeouts and connection issues
API rate limiting
Malformed chemical structures
Missing documents or chemicals
All errors are returned with descriptive messages and appropriate error codes.
Rate Limiting
The server respects SureChEMBL's API rate limits:
30-second timeout for complex requests
Respectful request spacing
Automatic retry logic for transient failures
Development
Project Structure
surechembl-server/
βββ src/
β βββ index.ts # Main server implementation
βββ build/ # Compiled JavaScript
βββ package.json # Dependencies and scripts
βββ tsconfig.json # TypeScript configuration
βββ README.md # This fileAvailable Scripts
npm run build- Compile TypeScript to JavaScriptnpm run watch- Watch mode for developmentnpm run inspector- Run MCP inspectornpm start- Start the servernpm run dev- Development mode with watch
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
License
MIT License - see LICENSE file for details.
Support
For issues and questions:
GitHub Issues: Report bugs and feature requests
Documentation: SureChEMBL API Documentation
Related Projects
ChEMBL MCP Server - ChEMBL bioactivity database
PubChem MCP Server - PubChem chemical database
UniProt MCP Server - UniProt protein database
Citation
If you use this project in your research or publications, please cite it as follows:
author = {Moudather Chelbi},
title = {SureChEMBL MCP Server},
year = {2025},
howpublished = {https://github.com/Augmented-Nature/SureChEMBL-MCP-Server},
note = {Accessed: 2025-06-29}
---
**SureChEMBL MCP Server** - Empowering chemical patent intelligence through the Model Context Protocol.Available Tools
15 toolsanalyze_patent_chemistryC
Analyze chemical content and annotations in a patent document
Inputs: document_id (required).
export_chemicalsC
Bulk export chemical data in CSV or XML format
Inputs: chemical_ids (required), output_type, kind.
get_chemical_by_idC
Get detailed chemical information by SureChEMBL chemical ID
Inputs: chemical_id (required).
get_chemical_frequencyB
Get frequency statistics for chemicals across the patent database
Inputs: chemical_id (required).
get_chemical_imageC
Generate chemical structure image from SMILES or other structure notation
Inputs: structure (required), height, width.
get_chemical_propertiesC
Get molecular properties and descriptors for a chemical by ID
Inputs: chemical_id (required).
get_document_contentB
Get complete patent document content with chemical annotations by document ID
Inputs: document_id (required).
get_patent_familyB
Get patent family members and relationships for a patent
Inputs: patent_id (required).
get_patent_statisticsC
Get statistical overview of chemical content in patents
Inputs: document_id (required), include_annotations.
search_by_inchiC
Search for chemicals by InChI or InChI key
Inputs: inchi (required), limit.
search_by_patent_numberC
Search for patents by specific patent numbers or publication numbers
Inputs: patent_number (required).
search_by_smilesC
Search for chemicals by SMILES structure notation
Inputs: smiles (required), limit.
search_chemicals_by_nameC
Search for chemicals by name, synonym, or common name
Inputs: name (required), limit.
search_patentsB
Search patents by text, keywords, or identifiers in SureChEMBL database
Inputs: query (required), limit, offset.
search_similar_structuresC
Find structurally similar chemicals using similarity search
Inputs: reference_id (required), threshold, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 15 tools
Each tool has a clearly distinct purpose with no significant overlap. For example, search_by_smiles and search_by_inchi both search chemicals but use different input formats, while get_chemical_by_id retrieves specific records. The descriptions clarify distinct functions like analysis vs. export vs. search.
All tools follow a consistent verb_noun pattern with snake_case, such as get_chemical_by_id, search_by_smiles, and analyze_patent_chemistry. The naming is predictable and readable throughout the set, with verbs like get, search, analyze, and export used appropriately.
With 15 tools, the count is well-scoped for a patent chemistry database server. Each tool earns its place by covering distinct aspects like chemical retrieval, patent search, analysis, and export, without being overwhelming or too sparse for the domain.
The tool set provides complete coverage for the SureChEMBL domain, including CRUD-like operations (e.g., get, search, analyze, export) for both chemicals and patents. There are no obvious gaps; it supports chemical lookup, structure search, patent analysis, and data export, enabling full agent workflows.
Related MCP Connectors
ChEMBL MCP β drug discovery database (EBI).
PubChem MCP β NIH chemistry compound database (no auth)
MyChem.info MCP. Aggregated drug / chemical-compound annotation from the BioThings API: ChEMBLβ¦
Auditable MCP server for PubMed, Europe PMC, ClinicalTrials.gov, and bioRxiv/medRxiv queries
Related MCP Servers
- AlicenseCqualityDmaintenanceA comprehensive Model Context Protocol (MCP) server providing advanced access to the UniProt protein database.2621MIT
- AlicenseBqualityDmaintenanceA comprehensive Model Context Protocol (MCP) server providing advanced access to the ChEMBL chemical database.2789MIT
- AlicenseBqualityDmaintenanceA comprehensive Model Context Protocol server providing access to over 110 million chemical compounds with extensive molecular properties, bioassay data, and chemical informatics tools from the PubChem database.3048MIT
- FlicenseNot gradedqualityDmaintenanceA FastMCP wrapper server that provides API access to the ChEMBL database, enabling users to query drug discovery data such as activities, assays, targets, and molecules.2-