OpenResearch MCP logo

OpenResearch MCP

Zero-auth MCP server for web, academic, financial, weather, social, and developer research across 22 tools.

Install OpenResearch MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "openresearch-mcp": {
      "command": "uvx",
      "args": [
        "openresearch-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx openresearch-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1d ago.

Overview

OpenResearch MCP MCP server connects MCP-compatible agents to public research sources including the web, GitHub, academic indexes, news, finance, weather, Bluesky, and YouTube. It runs locally over stdio or Streamable HTTP and requires no API keys for its tools, though optional environment variables can increase some rate limits. Use it when an agent needs to combine sources such as SEC filings and news, academic papers and PDFs, or economic indicators and exchange rates.

Use cases

  • Research companies using SEC filings, financials, and news
  • Find academic and biomedical papers and read their PDFs
  • Compare economic indicators, exchange rates, and weather history
  • Inspect public repositories and developer discussions
  • Track Bluesky profiles and recent original posts

Key features

  • Zero-auth public-source research
  • Webpage and PDF extraction
  • Academic and biomedical literature search
  • Finance, SEC, macroeconomic, and weather data
  • GitHub, developer-community, news, and Bluesky tools
  • Stdio and Streamable HTTP support

Tools22

What OpenResearch MCP lets your agent do. Expand a tool for its parameters.

Self-reported~106 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

4/4 checks healthy over the last 34d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · openresearch-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars11Stargazers on the source repository.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed22Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How OpenResearch MCP works

What OpenResearch MCP does

OpenResearch MCP MCP server provides 22 MCP tools for gathering and reading public information across several research domains. Web and source tools cover DuckDuckGo search, webpage extraction, PDFs, public GitHub repositories, Hacker News, Stack Overflow, OpenAlex, Europe PMC, YouTube captions, and GDELT news. Additional tools query weather, World Bank indicators, foreign-exchange rates, cryptocurrency prices, Bluesky accounts and feeds, SEC filings, and company financial data.

The tools are intended to be combined. For example, an agent can find a company’s SEC data, locate related news, and inspect a repository or webpage. An academic workflow can search OpenAlex or Europe PMC, then pass a paper URL to the PDF reader.

How it works

The server can communicate with MCP clients through stdio or Streamable HTTP. The default HTTP endpoint is http://127.0.0.1:8000/mcp, and the default loopback binding keeps the service off the local network unless the host is changed explicitly. In stdio mode, the client launches the server process directly.

All listed tools work without credentials. Optional variables raise limits or provide contact information for selected upstream services: GitHub, OpenAlex, Stack Overflow, and SEC EDGAR. Results from search tools can be passed to reading tools where the source returns a URL.

Setup and configuration

Run the package without a global installation using uvx openresearch-mcp. Add --stdio when configuring a client that starts the process, such as Claude Desktop or Cursor. Without that flag, the server uses Streamable HTTP on port 8000; --port changes the port and --host changes the bind address.

The OpenResearch MCP MCP server is listed in the official MCP Registry under io.github.olanokhin/openresearch-mcp. It can also be installed from PyPI with pip install openresearch-mcp. For HTTP agents, start the server and connect to http://localhost:8000/mcp.

Tools and capabilities

  • Search and read webpages, PDFs, GitHub repositories, Hacker News, Stack Overflow, news, and YouTube transcripts.
  • Search OpenAlex and Europe PMC for academic and biomedical literature.
  • Retrieve current and historical weather, World Bank indicators, foreign-exchange data, and cryptocurrency prices.
  • Find Bluesky users, inspect profiles, and read recent original posts.
  • Query SEC filings and retrieve annual financial figures for US-listed companies.
  • Get the current UTC date and time for requests involving relative dates.

Limitations and notes

The service is zero-auth by design, so an HTTP deployment exposed beyond loopback should sit behind an authentication and rate-limit gateway. URL and PDF readers fetch remote resources, although private, link-local, and loopback address ranges are blocked to reduce SSRF risk. Rate limits still apply to upstream services; optional credentials can improve limits for only the services that support them.

Weather data is supplied through Open-Meteo, and the tool documentation notes a licensing consideration. SEC company financials target US-listed companies and 10-K data. Bluesky feed reading filters out reposts and replies. Search results are not a substitute for checking the linked source content.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about OpenResearch MCP

OpenResearch MCP is an MCP server that connects agents to public web, GitHub, academic, news, finance, weather, Bluesky, SEC, and YouTube sources. Its main tools search and read webpages, PDFs, repositories, papers, filings, feeds, transcripts, indicators, prices, and forecasts without requiring API keys.

Install it with `uvx openresearch-mcp` or `pip install openresearch-mcp`. Use `uvx openresearch-mcp --stdio` for clients that launch MCP processes, or start it without `--stdio` for the default Streamable HTTP endpoint.

Yes, OpenResearch MCP works with Cursor through a stdio configuration. Add an `openresearch` server entry using the `uvx` command and `openresearch-mcp --stdio` arguments in the global or project Cursor MCP configuration.

No, API keys are not required to run the tools. `GITHUB_TOKEN`, `OPENALEX_EMAIL`, `STACKEXCHANGE_KEY`, and `SEC_USER_AGENT` are optional settings that can increase limits or identify the client to an upstream service.

Connect the agent to `http://localhost:8000/mcp` after starting `uvx openresearch-mcp`. The server uses port 8000 by default, and `--host` or `--port` can change its binding and port.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOpenResearch MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/openresearch-mcp?style=directory)](https://allmcps.com/mcp/openresearch-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/openresearch-mcp"><img src="https://allmcps.com/api/badge/openresearch-mcp?style=directory" alt="OpenResearch MCP on AllMCPs" /></a>