{
  "markdown": "# NobleBlocks MCP Server\n\n<!-- mcp-name: com.nobleblocks/nobleblocks-mcp -->\n\n<p align=\"center\">\n  <a href=\"https://registry.modelcontextprotocol.io\"><img src=\"https://img.shields.io/badge/MCP_Registry-listed-brightgreen\" alt=\"MCP Registry\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"></a>\n  <a href=\"https://www.nobleblocks.com\"><img src=\"https://img.shields.io/badge/papers-340M%2B-orange\" alt=\"Papers\"></a>\n</p>\n\nSearch 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.\n\nThis 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.\n\n---\n\n## What's in the index\n\n| Source | Papers | Updates |\n|--------|--------|---------|\n| OpenAlex | ~250M works | Daily |\n| Semantic Scholar | ~220M papers | Weekly |\n| PubMed / MEDLINE | ~41M articles | Daily |\n| Europe PMC | ~43M articles | Daily |\n| Crossref | Incremental | Daily |\n| arXiv | ~2.5M preprints | Daily |\n| bioRxiv / medRxiv | ~1K/day | Daily |\n| ClinicalTrials.gov | ~582K trials | Daily |\n| Unpaywall | OA link resolution | Daily |\n| DBLP | Computer science | Via OpenAlex |\n| CORE | ~37M open access outputs | Coming soon |\n| BASE (Bielefeld) | Discovery metadata | Via OpenAlex |\n| DOAJ | Open access journals | Via Crossref |\n| Papers with Code | ML/AI benchmarks | Weekly |\n| Retraction Watch | Retraction status | Weekly |\n| USPTO / EPO patents | ~9.3M patent-paper links | Daily |\n| …and others | | |\n\nAll sources are cross-deduplicated on DOI, PMID, and arXiv ID. Total unique records after dedup: **340M+** (June 2026).\n\n## Knowledge graph\n\nThe 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.\n\n## Tools\n\n| Tool | What it does |\n|------|-------------|\n| `search_papers` | Full-text + semantic hybrid search with year/citation/source filters |\n| `get_paper` | Fetch metadata by DOI, PMID, arXiv ID, or OpenAlex ID |\n| `find_similar` | Find papers related by meaning, not just keyword matching |\n| `get_citation_graph` | Citation network — references and citing papers |\n| `search_by_entity` | Find papers linked to a gene, drug, disease, or institution via the KG |\n| `create_literature_review` | AI-generated structured lit review with citations (Pro) |\n\n---\n\n## Get an API key\n\nAll usage requires a free NobleBlocks account. Sign up takes 30 seconds:\n\n1. Go to [nobleblocks.com/signup](https://www.nobleblocks.com/auth/signup)\n2. Create an account (email or Google)\n3. Navigate to [Settings > API Keys](https://www.nobleblocks.com/settings/api-keys) and generate a key\n\n**Free plan**: 100 searches/day, 5 similar/day, citation graph access.\n**Pro plan**: 5,000 searches/day, literature review generation, priority support.\n\n---\n\n## Quick start (Remote — no install needed)\n\nThe easiest way to get started is the **remote connector** — no API keys, no Python install:\n\n1. Open [claude.ai](https://claude.ai) → Settings → Connectors (or Integrations)\n2. Click \"Add\" and paste: `https://mcp.nobleblocks.com/mcp`\n3. Sign in with your NobleBlocks account\n4. Ask Claude: *\"Search for papers on CRISPR gene therapy\"*\n\n---\n\n## Install (Local)\n\n```bash\nuvx nobleblocks-mcp\n```\n\n---\n\n## Configure Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"nobleblocks\": {\n      \"command\": \"nobleblocks-mcp\",\n      \"env\": {\n        \"NOBLEBLOCKS_API_KEY\": \"nb_pk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The NobleBlocks tools will appear in the tools list.\n\n## Configure VS Code Copilot\n\nAdd to `.vscode/mcp.json` in your project:\n\n```json\n{\n  \"servers\": {\n    \"nobleblocks\": {\n      \"command\": \"nobleblocks-mcp\",\n      \"env\": {\n        \"NOBLEBLOCKS_API_KEY\": \"nb_pk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Configure Cursor / Cline / Continue\n\nPoint your editor's MCP settings at the `nobleblocks-mcp` command with stdio transport. Set `NOBLEBLOCKS_API_KEY` in the environment.\n\n---\n\n## CLI usage\n\nYou can also search directly from the terminal:\n\n```bash\n# Search papers\nnobleblocks search \"CRISPR base editing\" --limit 5 --min-year 2022\n\n# Get a specific paper\nnobleblocks get 10.1038/s41586-020-2649-2\n\n# Find similar papers\nnobleblocks similar \"Attention Is All You Need\"\n\n# Citation graph\nnobleblocks citations 10.1038/s41586-020-2649-2 --direction both\n```\n\nAll CLI commands require `NOBLEBLOCKS_API_KEY` set in your environment (or pass `--key`).\n\n---\n\n## Environment variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `NOBLEBLOCKS_API_KEY` | *(required)* | Your API key from nobleblocks.com |\n| `NOBLEBLOCKS_API_BASE` | `https://www.nobleblocks.com` | API endpoint |\n| `LOG_LEVEL` | `INFO` | Logging verbosity |\n\n---\n\n## Examples\n\nOnce configured, ask naturally in Claude/Cursor:\n\n> \"Find the most-cited papers on CRISPR base editing from 2022-2024\"\n\n> \"Show me papers similar to 'Attention Is All You Need' by Vaswani\"\n\n> \"What papers cite DOI 10.1038/s41586-020-2649-2?\"\n\n> \"Find papers linking BRCA1 to drug resistance\"\n\n> \"Generate a literature review on CAR-T cell therapy in solid tumors\"\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/nobleblocks/nobleblocks-mcp.git\ncd nobleblocks-mcp\npip install -e .\n\n# Test with MCP Inspector\nnpx @modelcontextprotocol/inspector nobleblocks-mcp\n```\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n---\n\nBuilt by [NobleBlocks](https://www.nobleblocks.com) — the academic research platform for the AI era.\n",
  "bytes": 6066,
  "sha": "b84ea804f65a00d5327f6afa6165a92a72a4f466401666e186905f3c1168b664",
  "repo_slug": "nobleblocks/nobleblocks-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_nobleblocks_nobleblocks_mcp_ffc4b1cc/readme"
}