Zora Coins

You can run a production-ready MCP server that exposes Zora Coins data and trading functionality through a simple, standardized interface. It lets you query markets, coin data, profiles, and comments without wallets for read operations, while enabling write actions like creating coins and trades with proper authentication. Use an MCP client to connect, explore data, and perform transactions in a structured, type-safe way.

How to use

You connect to the Zora Coins MCP server from your MCP client (such as Claude Desktop or Cursor IDE) and invoke tools to explore data, fetch coin information, manage profiles, or place trades. Start with read-only actions to discover markets and coin analytics, then move to write operations when you have a wallet ready. Use the same server endpoint across your client to ensure consistent behavior and validation, since the server validates inputs and provides clear error messages when something goes wrong.

How to install

# Option 1: NPX (Recommended - No Installation Required)
# Run directly with npx - always uses latest version
npx zora-coins-mcp

# Option 2: NPX with Full Package Name
# Alternative NPX syntax
npx zora-coins-mcp-server

# Option 3: Global Installation
# Install globally for persistent use
npm install -g zora-coins-mcp-server

# Then run with either command
zora-coins-mcp
# or
zora-coins-mcp-server

# Basic setup
cp .env.example .env

# Configure environment variables in your .env file:
# ZORA_API_KEY=your_api_key_here
# BASE_RPC_URL=https://mainnet.base.org
# PRIVATE_KEY=0xYourPrivateKeyHere

# Test the server
zora-coins-mcp

Additional setup and configuration

Create an environment file to supply API keys and network details, then start the MCP server with the command above. If you plan to perform write operations, ensure you have a private key set in PRIVATE_KEY and that you follow security best practices for key management.

Configuration and security notes

Configure optional network and security settings to suit your deployment. The API key boosts feature access and rate limits, while the RPC URL directs where on the Base network you send transactional data. Never expose private keys in public code or logs, and rotate API keys regularly to maintain security.

Development and testing

For local development, you can run the server in dev mode if the project exposes a dev script. Use the standard npm workflow to install dependencies, copy the environment example, and start the server. Test read operations first, then validate write operations with small amounts in a safe test environment.

Project structure and files

Key files include the main server implementation and configuration templates. The environment template (.env.example) helps you prepare your own environment settings, while source code and build scripts support local development and production builds.

Available tools

zora_health

Server health check and diagnostics to verify readiness and configuration status

zora_explore_new

List recently created coins for quick discovery

zora_explore_top_gainers

Identify coins with the biggest 24h gains to spot momentum

zora_explore_top_volume_24h

Show coins with the highest trading volume in the last 24 hours

zora_explore_most_valuable

Rank coins by market capitalization to gauge significance

zora_explore_last_traded

List coins that were recently traded to observe activity

zora_get_coin

Fetch comprehensive information for a single coin by address or identifier

zora_get_coins

Fetch data for multiple coins in a single call

zora_get_coin_holders

Retrieve the list of holders with their balances for a coin

zora_get_coin_swaps

Get recent trading activity for a coin, with pagination support

zora_get_coin_comments

Access community comments associated with a coin

zora_get_profile

Fetch user profile information by identifier

zora_get_profile_coins

Get coins created by a user profile

zora_get_profile_balances

Show a user's coin portfolio and balances

zora_create_coin

Deploy a new creator coin with metadata and payout settings (requires wallet)