Log inSubmit server
Web3 Research MCP logo

Web3 Research MCP

by aaronjmars

Locally researches crypto tokens across web sources, CoinGecko, CoinMarketCap, DeFiLlama, and stored resources.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Web3 Research MCP

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

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "aaronjmars-web3-research-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "web3-research-mcp@latest"
      ]
    }
  }
}

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

Automated check passed— started and listed 13 tools correctly (1mo ago).

Overview

aaronjmars/web3-research-mcp MCP server coordinates token research across web search, CoinGecko, CoinMarketCap, DeFiLlama, and other sources. It runs locally through Node.js and does not require an API key for its public-data tools, though optional CoinGecko Pro access is supported. Research plans, search results, fetched pages, and section status are managed as structured resources. Reach for it when an agent needs repeatable crypto research covering market data, protocol metrics, technical fundamentals, and related web content.

Use cases

  • Research a cryptocurrency token across multiple public sources
  • Compare CoinGecko trading venues and market data
  • Inspect DeFiLlama TVL, fees, and chain metrics
  • Build a staged token research report with saved resources
  • Fetch and retain web pages for later reference

Key features

  • Structured token research planning
  • Multi-source web and crypto data searches
  • CoinGecko market and exchange data
  • DeFiLlama protocol metrics
  • Saved research resources and status tracking
  • Optional CoinGecko Pro API support

Tools13

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

Verified live~1.0k 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.

19/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · web3-research-mcp@latest (npm)

Adoption & maintenance

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

GitHub stars170Stargazers on the source repository.
npm downloads1.9kPackage downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed13Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Web3 Research MCP works

What aaronjmars/web3-research-mcp MCP server does

The aaronjmars/web3-research-mcp MCP server provides a structured workflow for researching cryptocurrency tokens and DeFi protocols. It combines general web search with direct lookups against CoinGecko and DeFiLlama, while also supporting source-specific research for services such as CoinMarketCap and news sites.

A research workflow can begin with a plan based on a token name and ticker. The server then supports targeted searches, content retrieval, resource storage, and progress updates. Results can be used to assemble reports that cover market information, technical fundamentals, social or news context, and protocol data.

How it works

The server creates a research plan with sections for the subject being investigated. Search operations return results for web, news, image, or video queries, and keyword-based searches can be associated with a token. Content fetched from a URL can be saved in text, HTML, Markdown, or JSON form.

Saved results are exposed as resources that can be listed later. Section status can be changed between planned, in-progress, and completed, allowing an agent to track the state of a longer investigation. The repository also defines a token-research prompt for initiating comprehensive token research.

Several tools call public data APIs directly rather than relying only on page scraping. CoinGecko tools can resolve ambiguous token matches, retrieve market and supply data, and list active exchange markets. DeFiLlama tools can find protocols and return TVL, fee, chain, token, and fundraising information when available.

Setup and configuration

The aaronjmars/web3-research-mcp MCP server requires Node.js 16 or newer. Its npm package can be launched through npx using the package name web3-research-mcp and the -y flag.

Claude Desktop and Cursor configurations both use a local stdio entry with the following command and arguments:

config.json
{
  "command": "npx",
  "args": ["-y", "web3-research-mcp@latest"]
}

The standard CoinGecko and DeFiLlama tools use public API tiers and do not require credentials. Setting COINGECKO_API_KEY switches CoinGecko requests to the Pro API and sends the key through the documented request header. The key is optional, not a prerequisite for starting the server.

Tools and capabilities

Available capabilities include:

  • Creating token research plans and updating section status
  • Searching the web by query type, including news and media searches
  • Searching for and researching a token from a named source
  • Fetching URL content and saving it as a resource
  • Listing previously saved resources
  • Resolving CoinGecko token candidates and retrieving live market data
  • Listing CoinGecko trading venues, prices, volumes, spreads, and trade links
  • Finding DeFiLlama protocols and retrieving TVL, fees, chains, addresses, and related fields

Limitations and notes

The aaronjmars/web3-research-mcp MCP server depends on external search services and public APIs, so rate limits can affect search operations. Some websites block automated retrieval, which can cause direct URL fetching to fail with HTTP 403 responses. Search results may also be incomplete and should be checked against the original sources when accuracy matters.

The CoinGecko public tier is described as supporting roughly 30 requests per minute. CoinGecko, CoinGecko ticker, and DeFiLlama requests have a 15-second timeout, while the DeFiLlama protocol index is cached for five minutes per process.

Read the full README View source on GitHub

Reviews

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

Frequently Asked Questions about Web3 Research MCP

Install Node.js 16 or newer, then run `npx -y web3-research-mcp@latest` or add that command and argument to an MCP client configuration.

Yes. The README provides a Claude Desktop configuration using `npx` and `web3-research-mcp@latest`.

Yes. The README provides a Cursor MCP configuration using the same local npm command.

No API key is required for the documented public CoinGecko and DeFiLlama tools. `COINGECKO_API_KEY` is optional for CoinGecko Pro access.

Related MCP servers

All in Finance & Fintech All alternatives
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 PreviewWeb3 Research MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/aaronjmars-web3-research-mcp?style=directory)](https://allmcps.com/mcp/aaronjmars-web3-research-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/aaronjmars-web3-research-mcp"><img src="https://allmcps.com/api/badge/aaronjmars-web3-research-mcp?style=directory" alt="Web3 Research MCP on AllMCPs" /></a>