PocketScout MCP
Provides access to scientific literature via PubMed E-utilities for searching and retrieving papers related to target binding sites and drug design.
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., "@PocketScout MCP Assess the binding pockets of 6OIM"
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.
๐ฌ PocketScout MCP
Scout the binding landscape before you design the binder.
PocketScout is a fast triage tool for drug-target binding sites โ it gives an AI assistant the tools to pull together everything known about a protein's pockets (structure, chemistry, conservation, literature) into a single briefing in minutes. It's especially handy as the reconnaissance step before computational binder design, filling the gap between "I have a target" and "I'm running RFdiffusion."
Get Started
Use instantly on claude.ai (no install)
Name:
PocketScoutURL:
https://pocketscout-mcp.up.railway.app/mcpAsk Claude:
"Assess KRAS G12C (PDB 6OIM) as a target for de novo protein binder design. Where are the best pockets, and what should I watch out for?"
Use with Claude Code
claude mcp add pocketscout --transport http https://pocketscout-mcp.up.railway.app/mcpUse with Claude Desktop
Add to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"pocketscout": {
"url": "https://pocketscout-mcp.up.railway.app/mcp"
}
}
}Restart Claude Desktop, then ask Claude to assess a target.
Related MCP server: Protein Design MCP Server
The Problem
Drug discovery scientists spend hours to days manually gathering information across 6-10 browser tabs before they can make an informed decision about a target. Scientists evaluating an unfamiliar target, new team members trying to get up to speed, and scouting or BD roles screening many candidates face the same bottleneck: they check UniProt for function, browse PDB for structures, search ChEMBL for prior art, read papers for allosteric insights โ and then synthesize it all in their heads.
This manual triage step is where campaigns quietly go wrong. A scientist picks the obvious orthosteric site without checking that 200 compounds have already failed there. They miss an allosteric pocket described in a 2023 paper. They don't realize the binding site residues aren't conserved in mouse until their in vivo model fails. For binder-design campaigns specifically, it's the gap between "I have a target" and knowing which pocket to hand off to RFdiffusion.
The Solution
PocketScout gives an AI assistant (Claude, or any MCP-compatible model) the tools to perform systematic binding site triage in minutes instead of hours โ whether you're screening a target for the first time, briefing a new team member, or preparing a computational design campaign. Eight tools compose into a scientific workflow that reflects how expert medicinal chemists actually evaluate targets.
Tools
Tool | What it does | Key APIs |
| Biological context + AlphaFold confidence | UniProt, AlphaFold DB |
| All PDB structures, ligands, quality | RCSB PDB Search |
| Map known pockets with residue contacts | RCSB PDB Data + gemmi |
| Competitive landscape from bioactivity data | ChEMBL |
| Human vs. mouse at binding residues | UniProt Orthologs |
| Structural/design-focused papers | PubMed E-utilities |
| Flag known disease/resistance variants at binding-site residues | UniProt |
| Union of pockets across all structures of a target, ranked by recurrence | RCSB PDB + gemmi |
Orchestration Prompts
target_briefing โ Quick triage briefing for a drug target: what the protein is, its main pockets, the competitive landscape, and the one or two things worth knowing before going deeper. Use this for fast first-pass assessment.
binding_site_assessment โ In-depth, design-focused workup. Guides the AI through all tools in scientific workflow order, producing a ranked recommendation of binding regions with evidence, trade-offs, and design parameters.
Install locally (optional)
If you prefer to run the server yourself:
pip install pocketscout-mcpOr from source:
git clone https://github.com/Proprius-Labs/pocketscout-mcp.git
cd pocketscout-mcp
pip install -e .Requires Python 3.11+. If your system Python is older, use uv:
uv pip install pocketscout-mcp
Then configure Claude Desktop to run locally:
{
"mcpServers": {
"pocketscout": {
"command": "pocketscout-mcp"
}
}
}Tip: If you installed in a virtual environment, use the full path:
"command": "/path/to/venv/bin/pocketscout-mcp"
Test with MCP Inspector
fastmcp dev src/pocketscout_mcp/server.pyDesign Decisions
Why these tools?
The tool set reflects the actual decision workflow of an experienced drug discovery scientist evaluating a new target. Each tool answers a specific question that gates the next decision:
characterize_target: "What am I looking at?" โ You can't interpret binding sites without knowing the protein family, location, and structure quality. AlphaFold confidence is included here because it determines whether downstream structural analysis is trustworthy.
get_related_structures: "How much do we know?" โ A target with 200 co-crystal structures is a different problem than one with a single cryo-EM map. This step sets expectations for the binding site analysis.
get_binding_sites: "Where can I bind?" โ The core deliverable. Downloads the mmCIF coordinate file, uses gemmi to compute residue contacts within 4.5 A of each co-crystallized ligand, and classifies pockets (orthosteric, allosteric, cofactor) with size-based druggability assessment. When a structure has both cofactor and non-cofactor ligands, non-overlapping sites are automatically reclassified as allosteric.
get_ligand_history: "What's been tried?" โ Determines whether you're entering a crowded or greenfield space. A crowded orthosteric site argues for novel sites or modalities.
check_conservation: "Will my mouse model work?" โ Non-conserved binding residues mean your preclinical model may give misleading results. This is the step most scientists skip โ and the one that most often causes late-stage failures.
search_target_literature: "What do the experts know that the databases don't?" โ Cryptic sites from MD simulations, allosteric mechanisms from mutagenesis studies, resistance mutations that reshape pockets โ these insights live in papers, not databases.
check_known_variants: "Will this pocket mutate out from under me?" โ Binding-site residues that are documented resistance/disease variants (e.g. EGFR T790M) flag pockets that change under drug pressure.
consolidate_binding_sites: "Which pocket is real and recurrent?" โ Unions pockets across all structures of a target so the dominant, repeatedly-observed site stands out from one-offs.
Why not include pocket prediction?
Tools like fpocket, P2Rank, and SiteMap predict novel binding sites computationally. These are valuable but require computational infrastructure (CPU/GPU) that doesn't fit the MCP model of lightweight API-based tools. PocketScout focuses on known binding intelligence from experimental data and literature. Pocket prediction belongs in a separate compute-oriented server.
Why pre-compute interpretations?
Each tool returns both raw data and an interpretation field with scientific context. This is a deliberate design choice: the interpretation encodes domain expertise that helps the AI make better reasoning decisions. A raw list of ChEMBL activities is harder for Claude to reason about than a structured competitive landscape assessment.
Why local-context conservation across mouse, rat, and cynomolgus?
Full multi-species conservation requires multiple sequence alignment, which is computationally expensive and error-prone without proper gap handling. The tool now checks three preclinical model organisms โ mouse (NCBI taxonomy 10090), rat (10116), and cynomolgus macaque (9541) โ covering both rodent and non-human primate translatability questions in a single call. Each species is assessed independently using local-context (sliding-window) matching to handle insertions/deletions between the human and ortholog sequences, providing accurate residue correspondence without requiring a full MSA or a BioPython dependency. The tool is deliberately kept lightweight: no MSA, no external alignment tools, no heavy dependencies.
Architecture
User: "Assess PDB 7S4S for de novo binder design"
โ
โผ
Claude (or any MCP client)
โ
โโโ characterize_target(pdb_id="7S4S")
โ โโโ UniProt API + AlphaFold DB
โ
โโโ get_related_structures(pdb_id="7S4S")
โ โโโ RCSB PDB Search API
โ
โโโ get_binding_sites(pdb_id="7S4S")
โ โโโ RCSB PDB Data API
โ
โโโ get_ligand_history(uniprot_id="...")
โ โโโ ChEMBL REST API
โ
โโโ check_conservation(uniprot_id="...", residues=[...])
โ โโโ UniProt Orthologs
โ
โโโ check_known_variants(uniprot_id="...", residues=[...])
โ โโโ UniProt variants
โ
โโโ consolidate_binding_sites(uniprot_id="...")
โ โโโ RCSB PDB + gemmi (cross-structure)
โ
โโโ search_target_literature(gene_name="...")
โโโ PubMed E-utilities
โ
โผ
Ranked binding site assessment with evidence + trade-offsExample Output
See examples/egfr_assessment.md for a complete walkthrough using EGFR (PDB 1M17) โ a well-studied kinase with rich structural and chemical data.
Configuration
PubMed API Key (optional but recommended)
NCBI rate limits to 3 requests/second without a key. Get a free key at NCBI and set:
export NCBI_API_KEY=your_key_hereLimitations
No pocket prediction: PocketScout reports known binding sites from experimental structures. Novel/cryptic site prediction requires computational tools not included here.
Simplified conservation: Human vs. mouse, rat, and cynomolgus comparison using local context matching. Handles indels but not a full MSA โ accurate for most drug targets.
Public data only: All data comes from public APIs (UniProt, PDB, ChEMBL, PubMed, AlphaFold DB). Proprietary databases are not accessed.
Roadmap
Coordinate-level binding site analysis with gemmi
Per-residue AlphaFold pLDDT from CIF files
Multi-species conservation (mouse/rat/cynomolgus via local-context matching)
Integration with computational pocket prediction (fpocket MCP)
Allosteric site detection from ensemble structures
Patent landscape integration (SureChEMBL)
Contributing
PRs welcome. See CONTRIBUTING.md for guidelines.
License
MIT
Author
Paul Mangiamele, PhD Proprius Labs ยท LinkedIn
Available Tools
8 toolsCharacterizeTargetCharacterize TargetARead-onlyIdempotent
Establish biological context for a drug target protein.
Retrieves protein function, family classification, subcellular location, disease associations, and AlphaFold structure confidence. This should be your FIRST call โ all downstream analysis depends on this context.
IMPORTANT: AlphaFold confidence flags regions where predicted structure is unreliable. Low-confidence regions (<70 pLDDT) may have incorrect pocket predictions โ always cross-reference with experimental structures.
Provide EITHER a PDB ID (e.g. '1M17') OR a UniProt accession (e.g. 'P00533'). If a PDB ID is given, the UniProt mapping is resolved automatically.
Inputs: pdb_id, uniprot_id. Returns: object
CheckConservationCheck ConservationARead-onlyIdempotent
Check conservation at binding site residues across mouse, rat, and cynomolgus.
Critical for preclinical translatability: if key binding site residues differ between human and a preclinical model, that species' efficacy data may not predict human response. Non-conserved positions are flagged for each species individually.
Conservation > 90%: excellent โ species should recapitulate human binding. Conservation 70-90%: acceptable โ verify non-conserved positions are not critical contact residues. Conservation < 70%: caution for that species โ consider a better-conserved alternative. Cynomolgus (macaque) is the closest primate model and often shows higher conservation than rodents when the target has primate-specific sequence features.
Default species checked: mouse, rat, cynomolgus. Pass a custom species
list to restrict or reorder (supported values: 'mouse', 'rat', 'cynomolgus').
Provide the human UniProt accession and residue positions from GetBindingSites.
Inputs: uniprot_id (required), residue_positions (required), species. Returns: object
CheckKnownVariantsCheck Known VariantsARead-onlyIdempotent
Flag known sequence variants and mutagenesis hits at binding-site residues.
Binding-site residues that are documented disease/resistance variants (e.g. EGFR T790M) mark pockets that mutate under drug pressure โ a key risk signal when choosing where to design. Source: UniProt Natural variant + Mutagenesis features. Provide the human UniProt accession and positions from GetBindingSites.
Inputs: uniprot_id (required), residue_positions (required). Returns: object
ConsolidateBindingSitesConsolidate Binding SitesARead-onlyIdempotent
Map the union of binding pockets across all structures of a target.
Fans out GetBindingSites over the top structures and clusters pockets by residue overlap, so recurrent pockets (e.g. the ATP site appearing in most structures) stand out from one-off or artifact sites. The heaviest tool โ downloads several coordinate files. Provide uniprot_id (preferred) or pdb_id.
Inputs: limit, pdb_id, uniprot_id. Returns: object
GetBindingSitesGet Binding SitesARead-onlyIdempotent
Map all known binding sites in a protein structure from co-crystallized ligands.
Identifies binding pockets by analyzing non-polymer entities (ligands, cofactors) in the structure, filtering out crystallization artifacts (glycerol, PEG, sulfate, etc.), and classifying each site by type.
Each site includes druggability assessment and modality recommendations:
Small deep pockets (< 20 contact residues) favor small molecules
Large flat interfaces (> 30 residues) favor biologics or de novo protein binders
Allosteric sites may offer selectivity advantages over orthosteric sites
Call this on specific PDB IDs identified by GetRelatedStructures. For comprehensive analysis, call on multiple structures with different co-crystallized ligands to build a complete pocket map.
Inputs: pdb_id (required). Returns: object
GetLigandHistoryGet Ligand HistoryARead-onlyIdempotent
Retrieve the bioactivity landscape for a drug target from ChEMBL.
Shows what compounds have been tested, how potent the best ones are, whether any have reached clinical trials, and how crowded the competitive landscape is.
Use this to decide whether to target KNOWN binding sites (where SAR exists) or seek NOVEL sites (where de novo design has an advantage). A crowded landscape suggests new modalities or allosteric approaches; an untargeted landscape suggests opportunity but less prior validation.
Provide EITHER uniprot_id or pdb_id (UniProt preferred for accuracy).
Inputs: pdb_id, uniprot_id. Returns: object
GetRelatedStructuresGet Related StructuresARead-onlyIdempotent
Find all PDB structures for a target protein.
Returns all available experimental structures, sorted by resolution. Use this to understand structural coverage: how many structures exist, what ligands have been co-crystallized, what conformational states are captured, and what the best-quality structure is.
A target with many high-resolution co-crystal structures has a rich binding site landscape to analyze. A target with only 1-2 structures (or only apo/unliganded structures) has less structural evidence.
Call this AFTER CharacterizeTarget and BEFORE GetBindingSites to identify which structures to analyze for pockets.
Inputs: limit, pdb_id, uniprot_id. Returns: object
SearchTargetLiteratureSearch Target LiteratureARead-onlyIdempotent
Search PubMed for recent structural biology and drug design papers.
Focuses specifically on binding site characterization, allosteric mechanisms, resistance mutations, and prior design campaigns โ the literature most relevant to planning a new binder design effort.
Use the optional context parameter to narrow results, e.g.:
context='allosteric' for allosteric site literature
context='resistance' for resistance mutation papers
context='antibody' for biologic-focused papers
context='oncology' for disease-specific context
Call this LAST โ after CharacterizeTarget, GetRelatedStructures, GetBindingSites, GetLigandHistory, and CheckConservation โ to see if the literature reveals insights not captured in database records (e.g., cryptic sites found by MD simulation, unpublished allosteric mechanisms).
Inputs: gene_name (required), context, max_results. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 8 tools
Tools have distinct purposes: CharacterizeTarget, GetRelatedStructures, GetBindingSites, GetLigandHistory, CheckConservation, CheckKnownVariants, SearchTargetLiterature, and ConsolidateBindingSites. Some potential overlap exists between GetBindingSites and ConsolidateBindingSites (both analyze binding pockets), but descriptions clarify that ConsolidateBindingSites aggregates across multiple structures while GetBindingSites analyzes a single structure. An agent could still confuse when to use one versus the other, but the 'heaviest tool' warning helps.
All tool names follow a consistent verb-noun (PascalCase) pattern: CharacterizeTarget, GetRelatedStructures, GetBindingSites, etc. No deviations or mixed conventions.
8 tools is well-scoped for a specialized structural biology MCP server. Each tool covers a distinct analysis step, and the count is neither too thin nor too heavy.
The toolset covers key aspects: target characterization, structure discovery, binding site mapping, ligand history, conservation, variants, literature, and consolidation. However, there is no explicit tool for exporting or visualizing results, nor for direct comparison between human and model organism structures beyond conservation. These are minor gaps that might require workarounds but don't break core workflows.
Maintenance
Related MCP Connectors
Biotech intelligence for AI agents: drugs, targets, diagnostics, PoS estimates, and writeups.
Link compounds to protein targets, rank bioactivity, and look up drug mechanisms and indications.
Protein analysis: ESM-2/ESMC embeddings, mutation scoring, landscape scans, ESMFold structure.
Federated protein structure & annotation across experimental (PDB) and predicted (AlphaFold) models.
716
Related MCP Servers
- FlicenseBqualityDmaintenanceProvides programmatic access to AlphaFold protein structure predictions and UniProt data, enabling users to retrieve protein structures, summaries, and annotations through natural language.3-
- AlicenseNot gradedqualityCmaintenanceEnables LLM agents to design proteins, predict structures, score interfaces, and run molecular dynamics simulations through a unified interface.1Apache 2.0
- FlicenseNot gradedqualityCmaintenanceProvides a standardized interface for AI assistants to search biomedical literature and clinical trials, combining evidence from multiple sources and offering a prompt for structured research briefs.-
- AlicenseAqualityBmaintenanceEnables unified access to 110 life science APIs and databases, including genomics, proteomics, chemistry, literature, and clinical data. Users can query genes, proteins, compounds, pathways, and more through natural language.3MIT