NobleBlocks
MCP Documentation

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)

  1. Open Settings → Connectors
  2. Choose Add custom connector, name it NobleBlocks and paste the server URL
  3. Leave the authentication settings empty: the server needs no sign-in
  4. 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.

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode
  2. Create a new app/connector, name it NobleBlocks and paste the server URL
  3. Set authentication to No authentication
  4. 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.

ParameterTypeRequiredDescription
querystringYesTopic, question, title words or author name (2–500 characters). Supports AND / OR / NOT and "quoted phrases".
limitintegerNoNumber of results, 1–20 (default 10)
year_fromintegerNoOnly papers published in or after this year
year_tointegerNoOnly 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.

ParameterTypeRequiredDescription
identifierstringYesA 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.

ParameterTypeRequiredDescription
identifierstringYesA 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>
formatstringNobibtex (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

  1. Check the URL ends in /mcp: https://mcp.nobleblocks.com/mcp
  2. Make sure the client is set to a remote / HTTP server, not a local command
  3. Make sure no authentication (OAuth or API key) is configured for it
  4. 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

ClientHow it connects
Claude (claude.ai, Desktop)Custom connector
Claude Codeclaude mcp add --transport http
ChatGPTDeveloper-mode app / connector
Codexmcp_servers entry in config.toml
Cursorurl entry in mcp.json
VS Code (Copilot)http server in .vscode/mcp.json
WindsurfserverUrl entry in mcp_config.json