EBI PDBe MCP Server for Mastra AIGive Mastra AI instant access to 16 tools to Get Assemblies, Get Binding Sites, Get Cofactors, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect EBI PDBe through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The EBI PDBe MCP Server for Mastra AI is a standout in the The Unthinkable category — giving your AI agent 16 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"ebi-pdbe": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "EBI PDBe Agent",
instructions:
"You help users interact with EBI PDBe " +
"using 16 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with EBI PDBe?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About EBI PDBe MCP Server
Connect to the PDBe (Protein Data Bank in Europe) API and access the world's most comprehensive repository of experimentally determined 3D macromolecular structures.
Mastra's agent abstraction provides a clean separation between LLM logic and EBI PDBe tool infrastructure. Connect 16 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Structure Summaries — Get titles, authors, deposition dates, resolution, and experimental methods for any PDB entry
- Molecular Entities — Retrieve protein chains, nucleic acids, ligands, their sequences, source organisms, and gene names
- Binding Sites & Ligands — Access ligand binding pocket residues, small molecule ligands with formulas and weights
- Quality Assessment — Check resolution, R-factors, and overall quality scores for structure reliability
- UniProt Mappings — Map between UniProt sequence positions and PDB residue numbers
- Biological Assemblies — Understand quaternary structure — monomer, dimer, tetramer, or higher-order complexes
- Structure Search — Full-text Solr search across 200+ PDB metadata fields
- Publications — Find primary citations, PubMed IDs, and related structural studies
The EBI PDBe MCP Server exposes 16 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 16 EBI PDBe tools available for Mastra AI
When Mastra AI connects to EBI PDBe through Vinkius, your AI agent gets direct access to every tool listed below — spanning pdb, protein-structure, 3d-structures, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Get assemblies on EBI PDBe
Returns assembly IDs, composition (which entities and how many copies), preferred assembly flag, and form description. Critical for understanding whether a protein functions as a monomer, dimer, tetramer, or higher-order complex. Get biological assembly information (quaternary structure)
Get binding sites on EBI PDBe
Critical for drug discovery, molecular docking, and understanding protein-ligand interactions. Get ligand binding site residues and interactions
Get cofactors on EBI PDBe
Cofactors like heme, NAD+, FAD, and metal ions are essential for enzyme catalysis and protein function. Get cofactor and prosthetic group annotations
Get experiment on EBI PDBe
Get experimental method details for a structure
Get ligand monomers on EBI PDBe
Returns chemical component IDs, names, molecular formulas, molecular weights, and their chain/residue positions. Essential for drug discovery and understanding protein-small molecule interactions. Get small molecule ligands bound in the structure
Get modified residues on EBI PDBe
Shows the parent compound ID and modification name. Get non-standard amino acids and nucleotides
Get molecules on EBI PDBe
Returns entity IDs, molecule types, names, chain assignments, sequence lengths, molecular weights, source organisms, and gene names. Get molecular entities (chains, polymers) in a structure
Get mutated residues on EBI PDBe
Shows the original residue, mutated residue, chain, and position. Essential for understanding how the crystallized construct differs from the native protein. Get engineered mutations vs. wild-type sequence
Get publications on EBI PDBe
Useful for finding the primary citation and methodology papers for a structure. Get associated journal publications and PubMed IDs
Get quality scores on EBI PDBe
The first thing a structural biologist checks when evaluating a structure for reliability. Get global quality metrics for a structure
Get related entries on EBI PDBe
Useful for discovering alternative conformations, mutants, or complexes of the same protein that have been structurally characterized. Get related PDB entries citing the same publications
Get residue listing on EBI PDBe
Shows residue names, numbers (both PDB and author numbering), organized by entity and chain. Returns a sample of the first 20 residues per chain for efficiency. Get full residue-level inventory per chain
Get secondary structure on EBI PDBe
Shows the count of helices and strands per chain, organized by molecular entity. Essential for understanding protein fold topology. Get helix, sheet, and coil assignments per residue
Get summary on EBI PDBe
Use a 4-character PDB ID such as 1cbs, 4hhb, 6lu7. Get PDB entry summary with title, authors, and resolution
Get uniprot mapping on EBI PDBe
Returns UniProt accessions, chain assignments, and start/end position mappings. Essential for cross-referencing between protein sequence databases and 3D structural data. Get UniProt to PDB residue mappings
Search structures on EBI PDBe
Use natural language queries like "insulin receptor kinase", "SARS-CoV-2 spike protein", "cryo-EM resolution<3", or specific organism names. Returns PDB IDs, titles, methods, resolutions, and organisms. Search PDB structures with full-text queries
Connect EBI PDBe to Mastra AI via MCP
Follow these steps to wire EBI PDBe into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the EBI PDBe MCP Server
Mastra AI provides unique advantages when paired with EBI PDBe through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add EBI PDBe without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every EBI PDBe tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
EBI PDBe + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the EBI PDBe MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query EBI PDBe, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed EBI PDBe as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query EBI PDBe on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using EBI PDBe tools alongside other MCP servers
Example Prompts for EBI PDBe in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with EBI PDBe immediately.
"Show me the structure summary and quality of the SARS-CoV-2 main protease (6lu7)."
"What ligands are bound in the hemoglobin structure 4hhb?"
"Search for cryo-EM structures of ribosome complexes."
Troubleshooting EBI PDBe MCP Server with Mastra AI
Common issues when connecting EBI PDBe to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpEBI PDBe + Mastra AI FAQ
Common questions about integrating EBI PDBe MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Numbers API
5 toolsFacts about numbers and dates — access trivia, math, and historical data via AI.

AT&T IoT
10 toolsIoT Control Center -- Manage SIM devices, activation, data pools, shared plans, and connectivity diagnostics via AT&T IoT API.

Data Sorting & Filtering Engine
2 toolsPerfect array manipulation. Sort and deduplicate massive JSON lists with native Vinkius Edge JavaScript instead of relying on token-limited LLMs.

Nextcloud
16 toolsManage your Nextcloud instance — handle files, shares, user statuses, and server capabilities directly from your AI agent.
