Getting Started with the NobleBlocks MCP
The NobleBlocks MCP server lets AI assistants that support the Model Context Protocol, such as Claude, ChatGPT, Codex, Cursor and VS Code, search the NobleBlocks paper index, look up a paper and produce a citation, directly from the conversation.
Getting Started
NobleBlocks runs a remote MCP server. There is nothing to install and no account or API key to create: add the URL below to your AI client as a remote (HTTP) MCP server.
Server URL
https://mcp.nobleblocks.com/mcp
- Transport
- Streamable HTTP
- Authentication
- None
- Tools
- 3, all read-only
The older nobleblocks-mcp package (stdio with an API key) is not covered by this page. Use the remote URL above instead.
Connect Your Client
Menu names change between client versions and which features you can use depends on your plan with each provider. If a step below does not match what you see, look for the client's option to add a remote or custom MCP server and paste the server URL.
Claude (claude.ai and Claude Desktop)
- Open Settings → Connectors
- Choose Add custom connector, name it NobleBlocks and paste the server URL
- Leave the authentication settings empty: the server needs no sign-in
- In a chat, enable the connector and ask: "Search NobleBlocks for papers on CRISPR base editing"
https://mcp.nobleblocks.com/mcp
Claude Code
claude mcp add --transport http nobleblocks https://mcp.nobleblocks.com/mcp
ChatGPT
ChatGPT connects to remote MCP servers as a custom app (connector) created in developer mode.
- Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode
- Create a new app/connector, name it NobleBlocks and paste the server URL
- Set authentication to No authentication
- Select it in a chat and ask: "Find recent papers on mRNA vaccine stability"
https://mcp.nobleblocks.com/mcp
Codex (CLI and IDE extension)
Add the server to ~/.codex/config.toml:
[mcp_servers.nobleblocks] url = "https://mcp.nobleblocks.com/mcp"
Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"nobleblocks": {
"url": "https://mcp.nobleblocks.com/mcp"
}
}
}VS Code (GitHub Copilot)
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"nobleblocks": {
"type": "http",
"url": "https://mcp.nobleblocks.com/mcp"
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"nobleblocks": {
"serverUrl": "https://mcp.nobleblocks.com/mcp"
}
}
}Other MCP Clients
Any client that supports remote MCP servers over Streamable HTTP can connect to the server URL with no authentication. Clients that only support local (stdio) servers cannot connect directly.
Verify Your Connection
Your client should list three NobleBlocks tools. Then try:
"Search NobleBlocks for papers on exercise and depression published since 2020, then give me a BibTeX entry for the most cited one."
You should see papers with titles, authors, years, journals and citation counts, followed by a BibTeX entry. To check the server from a terminal:
curl -s https://mcp.nobleblocks.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'Available Tools
The server exposes three tools. All are read-only (annotated readOnlyHint): they look things up and never change anything.
search_papers
Keyword search over the NobleBlocks paper index. Returns title, authors, year, journal, DOI, citation count, an abstract excerpt and a link to the paper on NobleBlocks.
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Topic, question, title words or author name (2–500 characters). Supports AND / OR / NOT and "quoted phrases". |
| limit | integer | No | Number of results, 1–20 (default 10) |
| year_from | integer | No | Only papers published in or after this year |
| year_to | integer | No | Only papers published in or before this year |
get_paper
Full metadata for one paper: authors, journal, volume, issue, pages, DOI, PMID, OpenAlex id, citation count, abstract, and its NobleID ARK when the paper has a confirmed one.
| Parameter | Type | Required | Description |
|---|---|---|---|
| identifier | string | Yes | A NobleBlocks paper id (the id from search_papers), a DOI (10.xxxx/…), a NobleID ARK (ark:/48914/…), an OpenAlex id (W…), or a PubMed id written as pmid:<number> |
get_citation
A ready-to-paste citation for one paper in BibTeX, RIS or APA 7. The link is the paper's NobleID ARK when it has one, otherwise its DOI.
| Parameter | Type | Required | Description |
|---|---|---|---|
| identifier | string | Yes | A NobleBlocks paper id (the id from search_papers), a DOI (10.xxxx/…), a NobleID ARK (ark:/48914/…), an OpenAlex id (W…), or a PubMed id written as pmid:<number> |
| format | string | No | bibtex (default), ris or apa |
About DOIs. When a record's DOI is known to be unreliable, the tools leave it out and say so instead of guessing.
About NobleIDs. A paper's ARK is included only when the NobleID record is confirmed to be the same work. NobleID codes (NI…) are not accepted as identifiers; use the ARK or the DOI.
Example Prompts
- •"Find recent papers on mRNA vaccine stability published after 2022"
- •"What are the most cited papers on remote work and productivity?"
- •"Get the details of DOI 10.1038/s41586-020-2649-2"
- •"Give me an APA citation for ark:/48914/w1/20260526/9B523996"
- •"Export RIS citations for the top five results on protein folding prediction"
Access
- Free, with no account, API key or sign-in.
- Fair-use limits apply. If the server answers HTTP 429, wait a moment and try again.
Your AI subscription (Claude, ChatGPT and so on) does not change what NobleBlocks returns.
Troubleshooting
The client cannot connect or shows no tools
- Check the URL ends in
/mcp:https://mcp.nobleblocks.com/mcp - Make sure the client is set to a remote / HTTP server, not a local command
- Make sure no authentication (OAuth or API key) is configured for it
- Run the curl check under Verify Your Connection; a JSON reply means the server is up
No results found
Search matches words in titles and abstracts. Use specific academic terms, fewer words, or remove the year filters.
Too many requests (429)
Wait a moment, then try again.
Searches are slow or time out
Broad searches over the full index can take several seconds. Narrow the query or add a year range.
Privacy & Security
- What is sent: only the tool arguments your AI client chooses to send, such as a search query, a paper identifier or a citation format. Your conversation is not sent to NobleBlocks.
- Read-only: every tool only reads public scholarly metadata (titles, authors, abstracts, identifiers). Nothing is written, and no account is needed.
- Logs and moderation: we keep standard access logs, including IP addresses, to operate and protect the service. Search queries are logged and checked by automated content moderation. Do not put personal or confidential information in a search.
- Transport: HTTPS only.
Supported Clients
| Client | How it connects |
|---|---|
| Claude (claude.ai, Desktop) | Custom connector |
| Claude Code | claude mcp add --transport http |
| ChatGPT | Developer-mode app / connector |
| Codex | mcp_servers entry in config.toml |
| Cursor | url entry in mcp.json |
| VS Code (Copilot) | http server in .vscode/mcp.json |
| Windsurf | serverUrl entry in mcp_config.json |