← Back to directory
U

Universal Crypto MCP

Community
Universal crypto MCP server: let AI agents operate blockchains and DeFi via natural language.
Category
Dev Tools #5 of 438
Stars
★ 42 Popular
Transport
stdio (local process) · Streamable HTTP · SSE
Runtime
Node.js 18+ · Hosted (no local runtime)
Credentials
Optional API key
License
Other / unspecified
Last commit
Tools
11
75FMRS · B

A general-purpose blockchain/crypto MCP server published by a third-party developer, distributed via npm with stdio support plus HTTP/SSE modes and a hosted endpoint. Market-data queries are backed by free sources and are easy to integrate, but private-key-dependent write features and monorepo-wide marketing claims should be evaluated carefully and kept distinct from this specific server.

Strongest · Documentation 18/20 Weakest · Reliability 12/20

Reliability
12/20
Security and permissions
16/20
Maintenance
15/20
Documentation
18/20
Setup experience
14/20
Why each score
Reliability 12/20
The project has well-defined tools and server structure, but lacks statically verifiable evidence of test execution. While claiming 380+ tools, static analysis cannot verify if these tools function as declared. Error handling mechanisms are visible in the code, but edge cases and error recovery paths are not fully demonstrated.
Security and permissions 16/20
The project has clear environment variable configuration and permission separation for sensitive operations like transaction signing, with sensitive information like PRIVATE_KEY marked as isSecret. Dangerous operations like transfers require user confirmation, following least privilege principles. No obvious security vulnerabilities or excessive permission requests were found.
Maintenance 15/20
The project has clear version control (0.1.0) and release processes with well-defined dependencies. It includes contribution guidelines and issue tracking, but response times and update frequency cannot be fully verified from static code alone. The Apache-2.0 license is clear, but security response mechanisms are not explicitly demonstrated in the code.
Documentation 18/20
The documentation structure is comprehensive, including installation guides, configuration options, tool parameters, and examples. The README provides rich example prompts and use cases with a dedicated documentation site and API reference. Tool parameters and limitations are clearly stated, though some advanced configuration details may require further exploration.
Setup experience 14/20
The installation path is clear with support for multiple clients (Claude Desktop, Cursor, ChatGPT). It provides environment variable configuration examples, though obtaining certain API keys may require users to research independently. Support for three transport modes (stdio, HTTP, SSE) increases flexibility.

Static review · not runListed 2026-09-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

  • Developers and analysts who want crypto market and DeFi data inside an AI client
  • MCP users wanting quick access to free market-data sources
  • Users of Claude Desktop, Cursor, or ChatGPT Developer Mode

Not for

  • High-security scenarios requiring on-chain transactions without human review (write operations depend on PRIVATE_KEY)
  • Users seeking a server officially maintained by a blockchain platform
  • Users requiring explicit licensing guarantees (GitHub metadata shows NOASSERTION)

Required permissions

  • Optional RPC_URL to connect to EVM nodes
  • Optional PRIVATE_KEY (secret) for signing transactions
  • Optional ALCHEMY_API_KEY (secret) for enhanced RPC access
  • The npm package executes third-party code via npx

Risks and side effects

  • With PRIVATE_KEY configured, the AI agent can execute real on-chain transactions and potentially lose funds; use a dedicated hot wallet
  • Storing a private key in client environment variables risks leakage
  • npx automatically executes third-party code from npm, a supply-chain risk
  • License metadata is NOASSERTION on GitHub; verify terms before commercial use
  • Many advertised capabilities (e.g., 380+ tools, multi-chain operations) belong to sibling packages in the monorepo and may not be part of this server. server

Setup

Before you start

Runtime:Node.js 18+ · Hosted (no local runtime)

PRIVATE_KEY optionalsecret Wallet private key for signing transactions; needed for write operations (transfers, swaps), optional and only for trading.
ALCHEMY_API_KEY optionalsecret Alchemy API key for enhanced RPC access; free signup at alchemy.com.
COINGECKO_API_KEY optionalsecret CoinGecko API key for market data; free tier works without it, key raises rate limits. Get it at coingecko.com/api.
COINSTATS_API_KEY optionalsecret CoinStats API key for portfolio and price data; register at coinstats.app.
LUNARCRUSH_API_KEY optionalsecret LunarCrush API key to unlock social sentiment features; get it at lunarcrush.com/developers.
CRYPTOPANIC_API_KEY optionalsecret CryptoPanic API key to unlock crypto news; get it at cryptopanic.com/developers.
RUBIC_API_KEY optionalsecret Rubic.exchange API key for cross-chain swap routing.
X402_PRIVATE_KEY optionalsecret EVM private key for the x402 payment protocol so AI agents can pay for APIs automatically.
Other optional settings (5)
RPC_URL optional Default EVM RPC endpoint URL; public RPCs are used by default, or point to Infura/Alchemy etc.
ETHEREUM_RPC_URL optional Custom Ethereum mainnet RPC endpoint, e.g. an Infura URL.
ARBITRUM_RPC_URL optional Custom Arbitrum RPC endpoint, e.g. https://arb1.arbitrum.io/rpc.
BASE_RPC_URL optional Custom Base RPC endpoint, e.g. https://mainnet.base.org.
X402_CHAIN optional Default chain for x402 payments, such as arbitrum, base, ethereum, or polygon.
  1. Ensure Node.js is installed (README indicates 18+).
  2. Add to Claude Desktop or Cursor MCP config: {"mcpServers":{"universal-crypto-mcp":{"command":"npx","args":["-y","@nirholas/universal-crypto-mcp@latest"]}}}.
  3. Optional env vars: RPC_URL (default EVM RPC endpoint), PRIVATE_KEY (secret, for signing transactions), ALCHEMY_API_KEY (secret, enhanced RPC).
  4. For ChatGPT Developer Mode: run npx @nirholas/universal-crypto-mcp@latest --http and set http://localhost:3001/mcp as the app URL. A hosted HTTP endpoint is also available at https://modelcontextprotocol.name/mcp/universal-crypto-mcp.
claude_desktop_config.json
{"mcpServers":{"universal-crypto-mcp":{"command":"npx","args":["-y","@nirholas/universal-crypto-mcp@latest"],"env":{"PRIVATE_KEY":"your_private_key_here (optional)"}}}}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nirholas/universal-crypto-mcp@latest"
      ],
      "env": {
        "PRIVATE_KEY": "your_private_key_here (optional)"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add universal-crypto-mcp -e 'PRIVATE_KEY=your_private_key_here (optional)' -- npx -y @nirholas/universal-crypto-mcp@latest

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

After installing in Claude Desktop or Cursor, the tool list should show the 11 tools such as get_price and get_market_overview; asking "What's the price of Bitcoin?" and getting live data confirms the connection works.

Troubleshooting

  1. Verify Node.js 18+ is installed and npx works
  2. Check environment variable names (RPC_URL, PRIVATE_KEY, ALCHEMY_API_KEY)
  3. If write operations fail, confirm PRIVATE_KEY is configured
  4. After starting HTTP mode, confirm port 3001 and the /mcp path are reachable
  5. If the hosted endpoint fails, test connectivity with the JSON-RPC tools/list curl example from the README

Things to try

Once connected, you can ask your AI assistant things like:

  • What's the current price of Bitcoin and Ethereum in USD?
  • Show me the top 10 trending coins on CoinGecko right now
  • What's the total TVL of Aave across all chains?
  • What's the current gas price on Ethereum?

Tools 11

get_price read-only
Get crypto prices (by coin IDs and fiat currency).
get_market_overview read-only
Get a market overview (with a limit parameter).
get_trending read-only
Get currently trending coins.
search_coins read-only
Search coins by name or keyword.
get_coin_detail read-only
Get details for a single coin.
get_global_stats read-only
Get global crypto market statistics.
get_defi_protocols read-only
Get DeFi protocol data (e.g., TVL).
get_protocol_detail read-only
Get details for a single DeFi protocol.
Show 3 more tools
get_chain_tvl read-only
Get total value locked (TVL) for a chain.
get_gas_prices read-only
Get Ethereum gas prices.
get_token_info read-only
Get token information by contract address.

Use cases

Query crypto prices, market overviews, and trending coins via natural language
View DeFi protocol TVL and chain-level locked value
Check Ethereum gas prices
Look up token info by contract address
Search coins and fetch coin details

Supported clients

Claude Desktop
Cursor
ChatGPT Developer Mode

Listed from the project's documentation, not tested by this site.

Overview

Universal Crypto MCP (io.github.nirholas/universal-crypto-mcp, v0.1.0) is a TypeScript Model Context Protocol server distributed via the npm package @nirholas/universal-crypto-mcp and run with npx. It enables AI agents to interact with EVM-compatible blockchains (Ethereum, Arbitrum, Base, Polygon, BSC, Optimism, and more) and testnets. The npm server supports stdio transport; the repository README also documents HTTP (--http, for ChatGPT Developer Mode) and SSE (--sse) modes, plus a hosted HTTP endpoint at https://modelcontextprotocol.name/mcp/universal-crypto-mcp that exposes 11 read-only market-data tools (get_price, get_market_overview, get_trending, search_coins, get_coin_detail, get_global_stats, get_defi_protocols, get_protocol_detail, get_chain_tvl, get_gas_prices, get_token_info). Documented environment variables include RPC_URL (optional), PRIVATE_KEY (secret, for signing transactions), and ALCHEMY_API_KEY (secret). Note: the repository is a monorepo containing many sibling servers/packages; this profile covers only the server defined in the server. manifest and does not attribute sibling tools to it. The server is maintained by a third-party developer (nich / nirholas) and is not an official server of any blockchain or protocol; the repository license is marked NOASSERTION in GitHub metadata (the README states Apache-2.0).

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →

Source revision ced238d604ae Data synced 2026-10-19 Read the FMRS scoring method