Universal Crypto Agent

v1.0.0Finance & Fintechstable

Enables AI agents to interact with any EVM-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like Ethereum, BSC, Polygon

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

What is Universal Crypto Agent?

Universal Crypto Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai agents to interact with any evm-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tr...

Enables AI agents to interact with any EVM-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like Ethereum, BSC, Polygon

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

Features

  • Enables AI agents to interact with any EVM-compatible blockc

Use Cases

EVM blockchain interaction
Token swaps and bridges
DeFi operations
nirholas

Maintainer

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

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx universal-crypto-mcp

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 Crypto Agent

Universal Crypto MCP is a comprehensive blockchain interaction layer that gives AI agents access to over 380 tools covering 20+ EVM-compatible networks including Ethereum, Arbitrum, Base, BSC, Polygon, and more. It supports token swaps via DEX aggregators like 1inch and 0x, DeFi protocols such as Aave and Lido, cross-chain bridges via LayerZero and Stargate, real-time market data from CoinGecko and DefiLlama, security scanning with honeypot detection, and portfolio tracking — all accessible through natural language. Teams building autonomous crypto agents or simply wanting to query DeFi data from Claude can plug this in without managing multiple separate integrations.

Prerequisites

  • Node.js 18+ and npx available in PATH
  • An MCP-compatible client such as Claude Desktop or Cursor
  • Optional: CoinGecko API key, LunarCrush API key, CryptoPanic API key for enhanced data
  • Optional: EVM wallet private key for executing on-chain write operations (swaps, transfers)
1

Install or run directly via npx

The package is published as @nirholas/universal-crypto-mcp. You can run it directly with npx without a prior install step, or install it globally for faster startup.

npx @nirholas/universal-crypto-mcp
2

Create an optional .env file for API keys

The server works without API keys for many features, but adding vendor keys unlocks richer data. Place a .env file in your working directory or pass env vars through the MCP config.

COINGECKO_API_KEY=your_key
LUNARCRUSH_API_KEY=your_key
CRYPTOPANIC_API_KEY=your_key
PRIVATE_KEY=your_wallet_private_key
ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/your_id
3

Add the server to Claude Desktop config

Edit claude_desktop_config.json to register the MCP server. The PRIVATE_KEY is optional and only needed if you want the agent to sign and submit blockchain transactions.

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "COINGECKO_API_KEY": "your_key",
        "PRIVATE_KEY": "your_wallet_private_key_optional"
      }
    }
  }
}
4

Alternative: use the hosted HTTP endpoint

A public deployment is available if you want to try the server without any local install. Add the HTTP URL directly to your MCP client configuration.

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

Restart Claude Desktop and test with a market data query

After restarting, test with a read-only query first to confirm connectivity before attempting any write operations that would require a private key.

Universal Crypto Agent Examples

Client configuration

Claude Desktop configuration using npx to run the latest published package. Only COINGECKO_API_KEY is shown; add PRIVATE_KEY only if you need transaction signing.

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "COINGECKO_API_KEY": "your_coingecko_api_key",
        "ETHEREUM_RPC_URL": "https://mainnet.infura.io/v3/your_project_id"
      }
    }
  }
}

Prompts to try

Example prompts covering market data, security analysis, DeFi TVL queries, and cross-chain operations.

- "What is the current price of Bitcoin and Ethereum in USD?"
- "What's the total TVL of Aave across all supported chains?"
- "Is this token address safe to buy? 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE"
- "Swap 0.1 ETH for USDC on Arbitrum using the best available route"
- "Show me the top DeFi protocols by TVL on Polygon right now"
- "What's the gas price on Ethereum vs Arbitrum right now?"

Troubleshooting Universal Crypto Agent

Server starts but swap execution fails with 'private key required'

Write operations like token swaps require a funded wallet private key. Set PRIVATE_KEY in the env section of your MCP config. Never commit this key to version control — use a dedicated hot wallet with only the funds you need.

Market data tools return rate-limit errors

The free CoinGecko public API has strict rate limits. Register at coingecko.com/en/api for a free API key and add it as COINGECKO_API_KEY in your config to get higher rate limits.

npx takes a long time to start on each Claude Desktop launch

Install the package globally once with 'npm install -g @nirholas/universal-crypto-mcp' and then change the command in your config from 'npx' to 'universal-crypto-mcp' to skip the download step.

Frequently Asked Questions about Universal Crypto Agent

What is Universal Crypto Agent?

Universal Crypto Agent is a Model Context Protocol (MCP) server that enables ai agents to interact with any evm-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like ethereum, bsc, polygon It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Universal Crypto Agent?

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

Which AI clients work with Universal Crypto Agent?

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

Is Universal Crypto Agent free to use?

Yes, Universal Crypto Agent 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-mcp": { "command": "npx", "args": ["-y", "universal-crypto-mcp"] } } }

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

Read the full setup guide →

Ready to use Universal Crypto Agent?

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