Universal Blockchain MCP

v1.0.0Finance & Fintechstable

Universal MCP server for AI agents to interact with any* blockchain via natural language and plugins. Supports swaps, bridges, gas, staking, lending, and more across Ethereum, Arbitrum, Base, Polygon, BSC, and testnets.

aiai-agentsarbitrumbaseblockchain
Share:
37
Stars
0
Downloads
0
Weekly
0/5

What is Universal Blockchain MCP?

Universal Blockchain MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to universal mcp server for ai agents to interact with any* blockchain via natural language and plugins. supports swaps, bridges, gas, staking, lending, and more across ethereum, arbitrum, base, polygon,...

Universal MCP server for AI agents to interact with any* blockchain via natural language and plugins. Supports swaps, bridges, gas, staking, lending, and more across Ethereum, Arbitrum, Base, Polygon, BSC, and testnets.

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Universal MCP server for AI agents to interact with any* blo

Use Cases

Cross-chain operations
Crypto portfolio management
nirholas

Maintainer

LicenseApache-2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 14, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx universal-crypto

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Universal Blockchain MCP

Universal Crypto MCP is a TypeScript server exposing over 380 blockchain tools that let AI agents interact with EVM chains and other networks through natural language. It supports token swaps, cross-chain bridges, lending, staking, governance, market data, and smart contract deployment across Ethereum, Arbitrum, Base, Polygon, BSC, Optimism, Solana, and more. A private key is optional for read-only market queries but required for write operations like executing trades or sending transactions.

Prerequisites

  • Node.js 18 or higher with npx available
  • A blockchain private key for write operations (swaps, bridges, staking) — read-only queries work without one
  • Optional: CoinGecko, LunarCrush, or CryptoPanic API keys for enhanced market data
  • Claude Desktop, Cursor, or another MCP-compatible client
1

Test the server via the hosted endpoint (no install needed)

Universal Crypto MCP is available as a hosted HTTP endpoint. You can connect directly without any local installation for read-only queries.

2

Configure Claude Desktop with the hosted endpoint

Add the hosted HTTP endpoint to your claude_desktop_config.json to connect immediately without running anything locally.

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/universal-crypto-mcp"
    }
  }
}
3

Or run locally via npx with your private key

For write operations that require signing transactions, run the server locally with your private key. Never expose your private key to a third-party hosted service.

npx @nirholas/universal-crypto-mcp@latest
4

Configure Claude Desktop for the local server

Add the local npx-based server configuration with your private key and optional API keys for enhanced market data services.

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_wallet_private_key",
        "COINGECKO_API_KEY": "optional_coingecko_key",
        "ETHEREUM_RPC_URL": "https://mainnet.infura.io/v3/your_key",
        "ARBITRUM_RPC_URL": "https://arb1.arbitrum.io/rpc",
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}
5

Test with a read-only market query

Start with a safe read-only query to confirm the connection works before performing any write operations that spend gas or move funds.

Universal Blockchain MCP Examples

Client configuration

Full Claude Desktop configuration for the local universal-crypto-mcp server with private key and optional API integrations.

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_wallet_private_key_here",
        "COINGECKO_API_KEY": "your_coingecko_api_key",
        "LUNARCRUSH_API_KEY": "your_lunarcrush_key",
        "CRYPTOPANIC_API_KEY": "your_cryptopanic_key",
        "ETHEREUM_RPC_URL": "https://mainnet.infura.io/v3/your_project_id",
        "ARBITRUM_RPC_URL": "https://arb1.arbitrum.io/rpc",
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

Prompts to try

Example prompts spanning market data, DeFi operations, and cross-chain interactions using the 380+ available tools.

- "What's Bitcoin's current price and 24-hour trading volume?"
- "Swap 0.1 ETH for USDC on Arbitrum"
- "Check if this token contract is a honeypot: 0x..."
- "What are the current Aave lending rates for USDC on Ethereum?"
- "Bridge 100 USDC from Ethereum mainnet to Base"
- "Show me the top trending DeFi tokens by social sentiment"

Troubleshooting Universal Blockchain MCP

Transaction fails with insufficient gas or reverts on-chain

Ensure your wallet has sufficient native token (ETH, MATIC, etc.) for gas on the target chain, plus the tokens you want to swap or bridge. Check that the PRIVATE_KEY corresponds to the correct wallet and network.

Market data tools return errors without API keys

Read-only price queries work without API keys using public endpoints, but CoinGecko advanced data, LunarCrush social sentiment, and CryptoPanic news require their respective API keys set in the env block.

npx download is slow or fails with network errors

Install the package globally first with npm install -g @nirholas/universal-crypto-mcp@latest, then change the command to universal-crypto-mcp with empty args. Alternatively, use the hosted HTTP endpoint for read-only operations.

Frequently Asked Questions about Universal Blockchain MCP

What is Universal Blockchain MCP?

Universal Blockchain MCP is a Model Context Protocol (MCP) server that universal mcp server for ai agents to interact with any* blockchain via natural language and plugins. supports swaps, bridges, gas, staking, lending, and more across ethereum, arbitrum, base, polygon, bsc, and testnets. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Universal Blockchain MCP?

Follow the installation instructions on the Universal Blockchain MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Universal Blockchain MCP?

Universal Blockchain MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Universal Blockchain MCP free to use?

Yes, Universal Blockchain MCP is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "universal-crypto": { "command": "npx", "args": ["-y", "universal-crypto"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Universal Blockchain MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides