About nobleblocks-mcp
nobleblocks-mcp is an MCP server for academic researchers that searches NobleBlocks’ deduplicated, cross-database paper index. It combines semantic search, citation graphs, biomedical entity links, and cited literature reviews.
Key features
- 01Hybrid full-text and semantic search
- 02Fetch papers by DOI, PMID, and more
- 03Find semantically similar papers
- 04Explore citation networks
- 05Search papers by linked entities
- 06Generate cited literature reviews
Use cases
- 01Filter topic papers by year and citations
- 02Trace a paper’s references and citing works
- 03Find research linked to a gene or disease
- 04Create a cited review on a topic
MCP support
Exposes paper search, metadata retrieval, similarity, citation graph, entity search, and literature-review tools to MCP clients. It supports both local and remote connections.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.nobleblocks.com/mcpclaude mcp add --transport http com-nobleblocks-nobleblocks https://mcp.nobleblocks.com/mcp{"mcpServers":{"com-nobleblocks-nobleblocks":{"type":"http","url":"https://mcp.nobleblocks.com/mcp"}}}Open in Cursor{"servers":{"com-nobleblocks-nobleblocks":{"type":"http","url":"https://mcp.nobleblocks.com/mcp"}}}Open in VS Code{"mcpServers":{"com-nobleblocks-nobleblocks":{"type":"http","url":"https://mcp.nobleblocks.com/mcp"}}}{"mcpServers":{"com-nobleblocks-nobleblocks":{"serverUrl":"https://mcp.nobleblocks.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Number of results (1-20). |
| query | string | Yes | Topic, question, title words or author name. Supports AND / OR / NOT and "quoted phrases". |
| year_to | any | No | Only papers published in or before this year. |
| year_from | any | No | Only papers published in or after this year. |
Details
From the project READMENobleBlocks MCP Server
Search 340 million deduplicated academic papers from Claude Desktop, Claude Web, ChatGPT, Cursor, VS Code Copilot, or any MCP-compatible tool. Covers 15+ academic databases — all cross-linked through a biomedical knowledge graph with 1.3M+ entities and 109M+ paper connections.
This is a thin authenticated client — all indexing, ranking, vector search, and knowledge graph traversal runs on the NobleBlocks backend. You get fast results without managing any infrastructure.
What's in the index
| Source | Papers | Updates |
|---|---|---|
| OpenAlex | ~250M works | Daily |
| Semantic Scholar | ~220M papers | Weekly |
| PubMed / MEDLINE | ~41M articles | Daily |
| Europe PMC | ~43M articles | Daily |
| Crossref | Incremental | Daily |
| arXiv | ~2.5M preprints | Daily |
| bioRxiv / medRxiv | ~1K/day | Daily |
| ClinicalTrials.gov | ~582K trials | Daily |
| Unpaywall | OA link resolution | Daily |
| DBLP | Computer science | Via OpenAlex |
| CORE | ~37M open access outputs | Coming soon |
| BASE (Bielefeld) | Discovery metadata | Via OpenAlex |
| DOAJ | Open access journals | Via Crossref |
| Papers with Code | ML/AI benchmarks | Weekly |
| Retraction Watch | Retraction status | Weekly |
| USPTO / EPO patents | ~9.3M patent-paper links | Daily |
| …and others |
All sources are cross-deduplicated on DOI, PMID, and arXiv ID. Total unique records after dedup: 340M+ (June 2026).
Knowledge graph
The search backend also maintains a biomedical knowledge graph (1.3M+ entities, 109M+ paper links) with genes, diseases, drugs, proteins, institutions, researchers, topics, genetic variants, and drug-target-disease relationships sourced from PubTator Central, DisGeNET, ChEMBL, UniProt, ROR, ORCID, Open Targets, and others.
Tools
| Tool | What it does |
|---|---|
search_papers | Full-text + semantic hybrid search with year/citation/source filters |
get_paper | Fetch metadata by DOI, PMID, arXiv ID, or OpenAlex ID |
find_similar | Find papers related by meaning, not just keyword matching |
get_citation_graph | Citation network — references and citing papers |
search_by_entity | Find papers linked to a gene, drug, disease, or institution via the KG |
create_literature_review | AI-generated structured lit review with citations (Pro) |
Get an API key
All usage requires a free NobleBlocks account. Sign up takes 30 seconds:
- Go to nobleblocks.com/signup
- Create an account (email or Google)
- Navigate to Settings > API Keys and generate a key
Free plan: 100 searches/day, 5 similar/day, citation graph access. Pro plan: 5,000 searches/day, literature review generation, priority support.
Quick start (Remote — no install needed)
The easiest way to get started is the remote connector — no API keys, no Python install:
- Open claude.ai → Settings → Connectors (or Integrations)
- Click "Add" and paste:
https://mcp.nobleblocks.com/mcp - Sign in with your NobleBlocks account
- Ask Claude: "Search for papers on CRISPR gene therapy"
Install (Local)
uvx nobleblocks-mcp
Configure Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"nobleblocks": {
"command": "nobleblocks-mcp",
"env": {
"NOBLEBLOCKS_API_KEY": "nb_pk_your_key_here"
}
}
}
}
Restart Claude Desktop. The NobleBlocks tools will appear in the tools list.
Configure VS Code Copilot
Add to .vscode/mcp.json in your project:
{
"servers": {
"nobleblocks": {
"command": "nobleblocks-mcp",
"env": {
"NOBLEBLOCKS_API_KEY": "nb_pk_your_key_here"
}
}
}
}
Configure Cursor / Cline / Continue
Point your editor's MCP settings at the nobleblocks-mcp command with stdio transport. Set NOBLEBLOCKS_API_KEY in the environment.
CLI usage
You can also search directly from the terminal:
# Search papers
nobleblocks search "CRISPR base editing" --limit 5 --min-year 2022
# Get a specific paper
nobleblocks get 10.1038/s41586-020-2649-2
# Find similar papers
nobleblocks similar "Attention Is All You Need"
# Citation graph
nobleblocks citations 10.1038/s41586-020-2649-2 --direction both
All CLI commands require NOBLEBLOCKS_API_KEY set in your environment (or pass --key).
Environment variables
| Variable | Default | Description |
|---|---|---|
NOBLEBLOCKS_API_KEY | (required) | Your API key from nobleblocks.com |
NOBLEBLOCKS_API_BASE | https://www.nobleblocks.com | API endpoint |
LOG_LEVEL | INFO | Logging verbosity |
Examples
Once configured, ask naturally in Claude/Cursor:
"Find the most-cited papers on CRISPR base editing from 2022-2024"
"Show me papers similar to 'Attention Is All You Need' by Vaswani"
"What papers cite DOI 10.1038/s41586-020-2649-2?"
"Find papers linking BRCA1 to drug resistance"
"Generate a literature review on CAR-T cell therapy in solid tumors"
Development
git clone https://github.com/nobleblocks/nobleblocks-mcp.git
cd nobleblocks-mcp
pip install -e .
# Test with MCP Inspector
npx @modelcontextprotocol/inspector nobleblocks-mcp
License
MIT — see LICENSE.
Built by NobleBlocks — the academic research platform for the AI era.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.