The Moralis MCP Server connects natural language prompts to blockchain insights, enabling AI models to query blockchain data through a wrapper for the Moralis REST API.
Key capabilities:
Wallet Analytics: Retrieve NFT ownership, transaction history, balances, net worth, DeFi positions, and active chains
Example: "Show me the NFTs owned by vitalik.eth on Base"
Token Intelligence: Access token prices, holdings, metadata, historical data, and market metrics
Example: "What's the current price of PEPE and Ethereum?"
NFT Insights: Get collection metadata, transfers, floor prices, ownership distribution, and stats
Example: "Analyze the current holder distribution of SPX6900"
Blockchain Data: Query raw block details, transaction contents, pair-specific exchange data, and trending assets
Infrastructure: Supports multiple AI models (OpenAI, Claude, open-source LLMs), custom prompts, and extendable functionality
Allows installation and execution of the Moralis MCP server via NPM, making it accessible through the command 'npx @moralisweb3/api-mcp-server'.
Provides a TypeScript-based implementation of a wrapper to the Moralis Web3 API, enabling access to blockchain data including NFT information, token balances, wallet transactions, and DeFi positions across various chains.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Moralis MCP Server what's the current price of Ethereum?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
The Moralis MCP Server is a local or cloud-deployable engine that connects natural language prompts to real blockchain insights — allowing AI models to query wallet activity, token metrics, dapp usage, and more without custom code or SQL.
Built on top of the Model Context Protocol, this server makes it easy for LLMs to talk to Moralis APIs in a consistent, explainable, and extensible way.
🔗 Fully pluggable: swap LLMs, customize retrieval logic, or extend with your own tools
🧱 Works with OpenAI, Claude, and open-source models
🧠 Powers agents, devtools, bots, dashboards, and beyond
Related MCP server: Trello MCP Server
🤖 AI agents & assistants: “What’s this wallet’s trading history?”
📈 Devtools: on-chain QA, testing, CLI integrations
📊 Dashboards: natural language to charts/data
📉 Monitoring: alerting & summarization for tokens/dapps
🧠 Trading bots: LLM-driven strategies with real blockchain grounding
To use this MCP server with Moralis APIs, you'll need an API key:
Go to Moralis developer portal
Sign up and log in
Navigate to your API Keys page from the main menu
Copy your key and configure it in your config file (see next section), or set it in your environment:
export MORALIS_API_KEY=<your_api_key>⚠️ Note: Some features and endpoints require a Moralis paid plan. For full access and production-grade performance, we recommend signing up for a paid tier.
To connect the MCP server to a compatible client (e.g. Claude Desktop, OpenAI-compatible agents, VS Code extensions, etc.), configure the client to launch the server as a subprocess.
Most clients support a simple config file - for example, you might create a file like mcp.json in the client’s configuration directory with the following:
{
"mcpServers": {
"serverName": {
"command": "npx @moralisweb3/api-mcp-server",
"args": [],
"env": {
"MORALIS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}This setup can be adapted for any client that supports MCP servers. Replace the example values with those specific to your use case.
To install Moralis API Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @MoralisWeb3/moralis-mcp-server --client claudeThe server accepts an optional --transport argument to specify the transport type. The available transport types are:
stdio: Communicates over standard input/output (default).
web: Starts a HTTP server for communication.
streamable-http: Starts an HTTP server with streamable endpoints.
Using the default stdio transport:
moralis-api-mcp --transport stdioUsing the web transport:
moralis-api-mcp --transport web This will start a HTTP server. You can send requests to the server using tools like curl or Postman.
Using the streamable-http transport:
moralis-api-mcp --transport streamable-http This will start an HTTP server. You can send requests to the server using tools like curl or Postman.
Ensure that the required environment variables (e.g., MORALIS_API_KEY) are set before starting the server.
For custom configurations, you can pass additional arguments or environment variables as needed.
Refer to the documentation for more details on each transport type.
Install dependencies:
npm installBuild the server:
npm run buildFor development with auto-rebuild:
npm run watchSince MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspectorThe Inspector will provide a URL to access debugging tools in your browser.
Here are some example prompts you can use with your AI agent through the MCP server:
- What’s the current price of PEPE and Ethereum?
- What is the current trading sentiment for TOSHI on Base — bullish or bearish?
- Show me the NFTs owned by `vitalik.eth` on Base.
- What tokens does wallet `0xab71...4321` hold?
- When was wallet 0xabc...123 first and last seen active on Ethereum, Base, and Polygon?
- Show me the complete transaction history for 0xabc...123 across Ethereum, Base, and BNB Chain.
- What is the current net worth in USD of wallet 0xabc...123?
- Find wallet addresses that are likely associated with Coinbase.
- Analyze the current holder distribution of SPX6900 — include whales, small holders, and recent growth trends.
- Show me PEPE’s daily OHLC data for the past 30 days and provide a summary of the trend — is it bullish or bearish?These prompts are parsed and mapped to structured Moralis API calls using the MCP method registry.
💡 You can also build custom prompts based on any supported method.
The Moralis MCP Server wraps and translates prompts into Moralis REST API calls. You can explore the underlying API surface here:
This documentation covers endpoints for:
Token pricing
Wallet activity
NFT metadata and ownership
Transfers and transactions
And more
Get the contents of a block given the block hash.
Inputs: block_number_or_hash (required), chain, include.
Find the closest block to a specific date on a blockchain.
Inputs: chain, date.
Fetch detailed DeFi positions for a given wallet and protocol.
Inputs: address (required), protocol (required), chain.
Get a concise overview of a wallet’s DeFi positions across all protocols.
Inputs: address (required), chain.
Summarize a wallet’s DeFi activity, including total USD value, unclaimed rewards and active protocols.
Inputs: address (required), chain.
Retrieve comprehensive details for a specific token, including metadata and stats. For more detailed tokens stats we recommended to use getTokenAnalytics or getMultipleTokenAnalytics. For pair stats, we recommend to use getPairStats.
Inputs: chain (required), token_address (required).
Fetch entities belonging to a specific category. Each entity returns name, logo, description, external links, total addresses and more.
Inputs: categoryId (required), limit.
Retrieve details for a specific entity using its unique ID. Returns name, logo, description, external links and related addresses.
Inputs: entityId (required).
List available categories for blockchain entities.
Inputs: limit.
Fetch a list of tokens across multiple chains, filtered and ranked by dynamic on-chain metrics like volume, price change, liquidity, holder composition, and more. Supports advanced filters (e.g. “top 10 whales hold <40%”), category-based inclusion/exclusion (e.g. “exclude stablecoins”), and time-based analytics. Ideal for token discovery, investor research, risk analysis, and portfolio tools. Each token returned includes detailed trading metrics as well as on-chain and off-chain metadata.
Inputs: requestBody (required).
Track changes in the holder base of an ERC20 token over time. Supports timeseries data for total holders as well as change metrics such as holder distribution and holder acquisition.
Inputs: tokenAddress (required), fromDate (required), toDate (required), timeFrame (required), +3 more.
Get NFT collections by their 24 hour trading volume. Currently only supports Ethereum.
Inputs: no named parameters.
Get the most recent block number for a specified blockchain.
Inputs: chain (required).
Get NFT metadata for one or many NFTs. Accepts an array of up to 25 tokens, each requiring token_address and token_id. Each NFT returned includes on-chain metadata as well as off-chain metadata, floor prices, rarity and more where available.
Inputs: requestBody (required), chain.
Fetch analytics for multiple tokens, including buy volume, sell volume, buyers, sellers, transactions, liquidity and FDV trends over time. Accepts an array of up to 200 tokens, each requiring chain and tokenAddress.
Inputs: requestBody (required).
Retrieve the current or historical prices for multiple ERC20 tokens in the blockchain’s native currency and USD. Accepts an array of up to 100 tokens, each requiring token_address and optional fields such as to_block or exchange. Each token returned includes on-chain metadata, as well as off-chain metadata, logos, spam status and more. Additional options to exclude low-liquidity tokens and inactive tokens.
Inputs: requestBody (required), chain, include, max_token_inactivity, +1 more.
Retrieve native token balances (e.g. ETH) for one or many wallet addresses in single request.
Inputs: wallet_addresses (required), chain, to_block.
Retrieve metadata (name, symbol) for up to 25 NFT contracts in one call. Also returns off-chain metadata, floor prices and more where available.
Inputs: requestBody (required), chain, include_prices.
Find NFTs in a contract matching specific traits, perfect for attribute-based searches.
Inputs: address (required), requestBody (required), chain, limit, +4 more.
Get summary stats by NFT collection including total NFT transfers, total tokens and total owners.
Inputs: address (required), chain.
Fetch sale prices for NFTs in a contract over a specified number of days. Returns the last sale, lowest sale, highest sale, average sale and total trades within the specified period.
Inputs: address (required), chain, days.
Get NFT transfers for a contract, with options to filter by date, token, or other parameters.
Inputs: address (required), chain, from_block, to_block, +7 more.
Get floor price for a given collection. Refreshes every 30 minutes.
Inputs: address (required), chain.
Get timeseries historical floor prices for a given NFT collection. Refreshes every 30 minutes.
Inputs: interval (required), address (required), chain, cursor.
Fetch metadata for a specific NFT. Includes on-chain metadata as well as off-chain metadata, floor prices, rarity and more where available.
Inputs: address (required), token_id (required), chain, format, +3 more.
Fetch sale prices for a specific NFT over a specified number of days. Returns the last sale, lowest sale, highest sale, average sale and total trades within the specified period.
Inputs: address (required), token_id (required), chain, days.
Get NFT trades for a given contract with the ability to filter by marketplace.
Inputs: address (required), chain, from_block, to_block, +6 more.
Get NFT trades for a specific wallet address.
Inputs: address (required), chain, from_block, to_block, +5 more.
Explore the distinct traits of NFTs in a contract, showcasing their unique attributes.
Inputs: address (required), chain.
Retrieve OHLCV (Open, High, Low, Close, Volume) candlestick data for a token pair.
Inputs: address (required), timeframe (required), currency (required), fromDate (required), +4 more.
Access key statistics for a token pair, such as price, buyers, sellers, liquidity, volume and more.
Inputs: address (required), chain.
Identify sniper wallets that bought a token within a specified timeframe (blocksAfterCreation). Each wallet returned includes detailed information about how much was bought, sold as well as PnL stats and more.
Inputs: address (required), chain, blocksAfterCreation.
Fetch swap transactions (buy, sell, add/remove liquidity) for a specific token pair.
Inputs: address (required), chain, cursor, limit, +6 more.
Get all swap transactions (buy/sell) for a specific ERC20 token.
Inputs: address (required), chain, cursor, limit, +6 more.
List all swap transactions (buy/sell) for a specific wallet. Optionally filter by tokenAddress for specific token swaps.
Inputs: address (required), chain, tokenAddress, cursor, +7 more.
Fetch timeseries buy volume, sell volume, liquidity and FDV for multiple tokens. Accepts an array of up to 200 tokens, each requiring chain and tokenAddress.
Inputs: timeframe (required), requestBody (required).
Fetch timeseries volume, liquidity and FDV for a specific blockchain.
Inputs: timeframe (required), chain.
Fetch timeseries buy volume, sell volume, liquidity and FDV for a specific category. Optionally filter by chain.
Inputs: timeframe (required), categoryId (required), chain.
Returns total holders for a given token, as well as aggregated stats holder supply, holder trends, holder distribution and holder acquisition metrics.
Inputs: tokenAddress (required), chain.
Retrieve metadata (name, symbol, decimals, logo) for an ERC20 token contract, as well as off-chain metadata, total supply, categories, logos, spam status and more.
Inputs: addresses (required), chain.
Identify the major holders of an ERC20 token and understand their ownership percentages. Includes known entities, exchanges and wallet labels.
Inputs: token_address (required), chain, limit, cursor, +1 more.
List supported trading pairs for a specific ERC20 token. Each pair returned includes price, liquidity, volume and more.
Inputs: token_address (required), chain (required), limit, cursor.
Retrieve a score for a specific token along with detailed metrics including price, volume, liquidity, transaction counts, and supply information.
Inputs: tokenAddress (required), chain.
Get all ERC20 token transfers for a contract, ordered by block number (newest first).
Inputs: address (required), chain, from_block, to_block, +5 more.
Get cryptocurrencies by their market cap.
Inputs: no named parameters.
Get cryptocurrencies with the highest 24 hour trading volume.
Inputs: no named parameters.
List the top ERC20 tokens ranked by market cap. Currently only supports Ethereum. For more flexibility, we recommend to use getFilteredTokens.
Inputs: no named parameters.
Get top ERC20 tokens by price movements (winners and losers). Currently only supports Ethereum. For more flexibility, we recommend to use getFilteredTokens or getTopGainersTokens and getTopLosersTokens.
Inputs: no named parameters.
Identify tokens with the highest price increases over a period.
Inputs: chain, min_market_cap, security_score, time_frame.
List tokens with the largest price decreases over a period.
Inputs: chain, min_market_cap, security_score, time_frame.
Get top NFT collections by their current market cap. Currently only supports Ethereum.
Inputs: no named parameters.
List the most profitable wallets that have traded a specific ERC20 token.
Inputs: address (required), days, chain.
Get the ABI-decoded contents of a transaction by the given transaction hash.
Inputs: transaction_hash (required), chain, include.
List top tokens trending based on trading activity, volume, liquidity and more. By default this returns cross-chain results, including Solana. Optionally filter by chain for single chain results.
Inputs: chain, limit.
Get unique wallet addresses owning NFTs from a contract.
Inputs: address (required), chain, limit, cursor.
Access volume, buyers, sellers and transaction stats for a blockchain, grouped by category. Filter by chain.
Inputs: chain.
Retrieve volume, active wallets and transaction stats for a blockchain over various time periods. Returns data for all chains in a single request.
Inputs: no named parameters.
List the blockchain networks a wallet is active on, including their first and last seen timestamps. Options to query cross-chain using the chains parameter.
Inputs: address (required), chains.
List active ERC20 token approvals for a wallet, showing which contracts have access.
Inputs: address (required), chain, limit, cursor.
Get the complete decoded transaction history for a given wallet. All transactions are parsed, decoded, categorized and summarized into human-readable records.
Inputs: address (required), chain, from_block, to_block, +7 more.
Calculate the total net worth of a wallet in USD, with options to exclude spam tokens for accuracy. Options to query cross-chain using the chains parameter, as well as additional options to exclude spam tokens, low-liquidity tokens and inactive tokens.
Inputs: address (required), chains, exclude_spam, exclude_unverified_contracts, +2 more.
Fetch all NFT Collections held by a specified wallet address. Each Collection returned includes on-chain metadata as well as off-chain metadata, floor prices and more where available.
Inputs: address (required), chain, include_prices, limit, +3 more.
Fetch all NFTs held by a specified wallet address. Use token_addresses to filter by one or many specific contract(s). Each NFT returned includes on-chain metadata as well as off-chain metadata, floor prices, rarity and more where available.
Inputs: address (required), chain, format, limit, +6 more.
Get a detailed profit and loss breakdown by token for a given wallet, over a specified timeframe (days). Optionally filter by token_addresses for specific tokens.
Inputs: address (required), days, chain, token_addresses.
Get a profit and loss summary for a given wallet, over a specified timeframe (days).
Inputs: address (required), days, chain.
Retrieve key statistics for a wallet, such as total transaction count and activity.
Inputs: address (required), chain.
Fetch ERC20 and native token balances for a given wallet address, including their USD prices. Each token returned includes on-chain metadata, as well as off-chain metadata, logos, spam status and more. Additional options to exclude spam tokens, low-liquidity tokens and inactive tokens.
Inputs: address (required), chain, to_block, token_addresses, +7 more.
Convert an Ethereum address to its associated ENS domain, if registered.
Inputs: address (required).
Resolve an ENS domain to its associated Ethereum address.
Inputs: domain (required).
Find entities, organizations, addresses or wallets linked to blockchain addresses. Results are categorised into 3 arrays: entities, addresses, categories.
Inputs: query (required), limit.
Search for tokens using their contract address, pair address, name, or symbol. Cross-chain by default with support to filter by chains. Additional options to sortBy various metrics, such as market cap, liquidity or volume.
Inputs: query (required), chains, limit, isVerifiedContract, +2 more.
Gets native balance owned by the given address
Inputs: network (required), address (required).
Get aggregated statistics across supported pairs of a token.
Inputs: network (required), address (required).
Get the list of bonding tokens by given exchange.
Inputs: network (required), exchange (required), cursor, limit.
Gets the candlesticks for a specific pair address
Inputs: network (required), address (required), fromDate (required), toDate (required), +4 more.
Get the list of graduated tokens by given exchange.
Inputs: network (required), exchange (required), cursor, limit.
Get token holders overtime for a given tokens
Inputs: network (required), address (required), timeFrame (required), fromDate (required), +3 more.
Gets the token price (usd and native) for a given contract address and network.
Inputs: network (required), requestBody (required).
Get the list of new tokens by given exchange.
Inputs: network (required), exchange (required), cursor, limit.
Gets the contract level metadata (mint, standard, name, symbol, metaplex) for the given contract
Inputs: network (required), address (required), mediaItems.
Gets NFTs owned by the given address
Inputs: network (required), address (required), nftMetadata, mediaItems, +2 more.
Gets the stats for a specific pair address
Inputs: network (required), pairAddress (required).
Gets all the native and token balances of the given address
Inputs: network (required), address (required), nftMetadata, mediaItems, +1 more.
Get all snipers.
Inputs: network (required), pairAddress (required), blocksAfterCreation.
Gets token balances owned by the given address
Inputs: network (required), address (required), excludeSpam.
Get all swap related transactions (buy, sell, add liquidity & remove liquidity) for a specific pair address.
Inputs: network (required), pairAddress (required), limit, cursor, +4 more.
Get all swap related transactions (buy, sell) for a specific token address.
Inputs: network (required), address (required), limit, cursor, +4 more.
Get all swap related transactions (buy, sell) for a specific wallet address.
Inputs: network (required), address (required), limit, cursor, +5 more.
Get the token bonding status for a given network and contract (if relevant).
Inputs: network (required), address (required).
Get the summary of holders for a given token token.
Inputs: network (required), address (required).
Get the global token metadata for a given network and contract (mint, standard, name, symbol, metaplex).
Inputs: network (required), address (required).
Get the supported pairs for a specific token address.
Inputs: network (required), address (required), cursor, limit.
Gets the token price (usd and native) for a given contract address and network.
Inputs: network (required), address (required).
Get paginated top holders for a given token.
Inputs: network (required), address (required), cursor, limit.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 94 tools
The tools are organized into clear categories (EVM and Solana) with distinct purposes within each, such as block data, token analytics, NFT operations, and wallet queries. However, there is significant overlap in functionality, especially between similar tools like evm_getmultipletokenanalytics and evm_gettimeseriestokenanalytics, or multiple NFT-related tools that could cause confusion in selection without careful reading of descriptions.
The naming follows a highly consistent pattern throughout, using a clear prefix (evm_ or solana_) followed by a descriptive verb_noun format (e.g., evm_getblock, solana_getportfolio). This consistency makes it easy to predict tool purposes and navigate the large set without ambiguity in naming conventions.
With 94 tools, the count is excessive for a single server, making it overwhelming and difficult for agents to manage effectively. While the tools cover a broad blockchain domain, the sheer volume suggests poor scoping, as many tools could be consolidated or split into more focused servers to improve usability.
The tool set provides comprehensive coverage for blockchain data, including blocks, tokens, NFTs, wallets, swaps, and analytics across EVM and Solana chains. It supports full CRUD-like operations for querying, analyzing, and monitoring, with no apparent gaps that would hinder agent workflows in this domain.
Moralis MCP — wraps the Moralis Web3 Data API (moralis.com)
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Market Data App MCP — wraps the Market Data App API (marketdata.app)
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…