Moralis MCP Server

Moralis MCP servers enable AI models to query on-chain data — wallet activity, token metrics, NFTs, and dapp usage — via the Moralis Web3 APIs.

GitHub starsnpm versionnpm downloads

Overview

The Moralis MCP Server connects natural language prompts to real blockchain insights by wrapping Moralis Web3 REST APIs. It lets AI agents retrieve wallet activity, token metrics, NFTs, market data, and more without custom code or SQL, using a consistent MCP tool interface.

Created by:

Developed by Moralis

Key Features

🔗

Unified Web3 Data

Wallet, token, NFT, DeFi, price and blockchain endpoints in one server

🧠

Prompt-to-API Mapping

Natural language mapped to structured Moralis API calls via MCP methods

📊

Wallet & Token Insights

Trading history, balances, approvals, swaps, net worth, and stats

🌐

Flexible Transport

Supports stdio, web, and streamable HTTP transports

Available Tools

Quick Reference

ToolPurposeCategory
wallet_historyGet full wallet historyWallet
wallet_tokensBalances & prices for walletWallet
nft_ownedNFTs owned by wallet/domainNFT
token_priceCurrent token pricePrice
wallet_net_worthWallet net worth in USDWallet
transactions_verboseDecoded wallet transactionsBlockchain

Detailed Usage

wallet_history

Get the complete wallet history across supported chains.

use_mcp_tool({
  server_name: "moralis",
  tool_name: "wallet_history",
  arguments: {
    address: "0xabc...123",
    chain: "ethereum"
  }
});

Returns normalized transactions, transfers, NFTs and ERC20 activity.

token_price

Get current price for a token contract on a specific chain.

use_mcp_tool({
  server_name: "moralis",
  tool_name: "token_price",
  arguments: {
    tokenAddress: "0x6982...pepe",
    chain: "ethereum"
  }
});

Supports multiple chains and stablecoin pricing.

nft_owned

List NFTs owned by a wallet (supports ENS resolution).

use_mcp_tool({
  server_name: "moralis",
  tool_name: "nft_owned",
  arguments: {
    addressOrDomain: "vitalik.eth",
    chain: "base"
  }
});

Returns collections, tokens, metadata and transfer stats.

wallet_net_worth

Compute wallet net worth in USD across holdings.

use_mcp_tool({
  server_name: "moralis",
  tool_name: "wallet_net_worth",
  arguments: {
    address: "0xabc...123",
    chain: "ethereum"
  }
});

Aggregates native, ERC20, and NFT valuations where available.

Installation

{
  "mcpServers": {
    "moralis": {
      "command": "npx",
      "args": [
        "-y",
        "@moralisweb3/api-mcp-server"
      ],
      "env": {
        "MORALIS_API_KEY": "your_api_key"
      }
    }
  }
}

API Key:

Set MORALIS_API_KEY in your environment. Some endpoints require a paid plan.

Common Use Cases

1. Wallet Trading History

use_mcp_tool({
  server_name: "moralis",
  tool_name: "wallet_history",
  arguments: { address: "0xabc...123", chain: "ethereum" }
});

2. NFTs Owned by Domain

use_mcp_tool({
  server_name: "moralis",
  tool_name: "nft_owned",
  arguments: { addressOrDomain: "vitalik.eth", chain: "base" }
});

3. Wallet Net Worth

use_mcp_tool({
  server_name: "moralis",
  tool_name: "wallet_net_worth",
  arguments: { address: "0xabc...123", chain: "ethereum" }
});

4. Token OHLC Trend

use_mcp_tool({
  server_name: "moralis",
  tool_name: "token_ohlc",
  arguments: { tokenAddress: "0x6982...pepe", chain: "ethereum", periodDays: 30 }
});

Server Transport

Moralis MCP supports multiple transports:

# stdio (default)
moralis-api-mcp --transport stdio

# HTTP server
moralis-api-mcp --transport web

# HTTP server with streamable endpoints
moralis-api-mcp --transport streamable-http

Environment:

Ensure MORALIS_API_KEY is set before starting the server.

Sources