Skip to main content
Glama
r4topunk

Zora Coins MCP Server

by r4topunk
OverviewInspectSchemaRelated ServersScoreDiscussions
JavaScript
Remote

🎨 Zora Coins MCP Server

npm version npm downloads License: MIT TypeScript

A production-ready Model Context Protocol (MCP) server that provides seamless access to the Zora Coins ecosystem. Query coin data, explore markets, manage profiles, and execute trades on Base mainnet through a simple, standardized interface.

✨ Features

🔍 Query Tools (No wallet required)

  • Market Exploration: Discover trending coins, top gainers, highest volume, and newest launches

  • Coin Analytics: Get detailed market data, holder information, and trading history

  • Social Features: Access comments, creator profiles, and community engagement

  • Real-time Data: Live pricing, market caps, and trading volumes

⚡ Write Operations (Wallet required)

  • Create Coins: Deploy new creator coins with custom metadata

  • Trade: Buy/sell coins with ETH or ERC20 tokens

  • Manage: Update coin metadata and payout recipients

🛠️ Developer Experience

  • Type Safe: Built with TypeScript and Zod validation

  • Error Handling: Comprehensive error messages and graceful failures

  • Pagination: Support for large datasets with cursor-based pagination

  • Flexible: Works with any MCP-compatible client (Claude Desktop, Cursor, etc.)

🚀 Quick Start

Installation Options

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

  1. Create environment file:

cp .env.example .env

  1. Configure environment variables:

# Required for enhanced features (get from https://zora.co) ZORA_API_KEY=your_api_key_here # Optional: Custom RPC endpoint BASE_RPC_URL=https://mainnet.base.org # Required for write operations only PRIVATE_KEY=0xYourPrivateKeyHere

  1. Test the server:

zora-coins-mcp

🔧 MCP Client Integration

Claude Desktop

Add to your ~/.claude/mcp.json:

Option 1: Using NPX (Recommended)

{ "mcpServers": { "zora-coins": { "command": "npx", "args": ["zora-coins-mcp"], "env": { "ZORA_API_KEY": "your_api_key_here", "BASE_RPC_URL": "https://mainnet.base.org", "PRIVATE_KEY": "0xYourPrivateKeyHere" } } } }

Option 2: Using Global Installation

{ "mcpServers": { "zora-coins": { "command": "zora-coins-mcp", "env": { "ZORA_API_KEY": "your_api_key_here", "BASE_RPC_URL": "https://mainnet.base.org", "PRIVATE_KEY": "0xYourPrivateKeyHere" } } } }

Cursor IDE

Configure in your MCP settings:

Option 1: Using NPX (Recommended)

{ "name": "zora-coins", "command": ["npx", "zora-coins-mcp"], "env": { "ZORA_API_KEY": "your_api_key_here" } }

Option 2: Using Global Installation

{ "name": "zora-coins", "command": ["zora-coins-mcp"], "env": { "ZORA_API_KEY": "your_api_key_here" } }

Custom Integration

# Run as stdio server with npx npx zora-coins-mcp # Or if globally installed zora-coins-mcp # Development mode with live reload npm run dev

📖 Available Tools

🏥 Health Check

  • zora_health - Server diagnostics and configuration status

🔍 Market Exploration

  • zora_explore_new - Recently created coins

  • zora_explore_top_gainers - Biggest 24h gainers

  • zora_explore_top_volume_24h - Highest trading volume

  • zora_explore_most_valuable - Highest market cap

  • zora_explore_last_traded - Recently traded coins

💰 Coin Data

  • zora_get_coin - Comprehensive coin information

  • zora_get_coins - Batch fetch multiple coins

  • zora_get_coin_holders - Token holder list with balances

  • zora_get_coin_swaps - Recent trading activity

  • zora_get_coin_comments - Community comments

👤 Profile Management

  • zora_get_profile - User profile information

  • zora_get_profile_coins - Coins created by user

  • zora_get_profile_balances - User's coin portfolio

⚡ Trading & Creation (Requires Wallet)

  • zora_create_coin - Deploy new creator coin

  • zora_trade_coin - Buy/sell coins

  • zora_update_coin_uri - Update metadata

  • zora_update_payout_recipient - Change earnings recipient

💡 Usage Examples

Explore Trending Coins

// Get top 5 newest coins await mcp.callTool("zora_explore_new", { count: 5 }); // Find biggest gainers await mcp.callTool("zora_explore_top_gainers", { count: 3 });

Analyze a Specific Coin

// Get detailed coin information await mcp.callTool("zora_get_coin", { address: "0xd769d56f479e9e72a77bb1523e866a33098feec5" }); // Check recent trading activity await mcp.callTool("zora_get_coin_swaps", { address: "0xd769d56f479e9e72a77bb1523e866a33098feec5", first: 10 });

Profile Analysis

// Get profile information await mcp.callTool("zora_get_profile", { identifier: "base" }); // See coins created by user await mcp.callTool("zora_get_profile_coins", { identifier: "jacob", count: 5 });

Trading Operations

// Buy a coin with ETH await mcp.callTool("zora_trade_coin", { sellType: "eth", buyType: "erc20", buyAddress: "0x...", amount: "0.001", slippage: 0.05 }); // Create a new coin await mcp.callTool("zora_create_coin", { name: "My Creator Coin", symbol: "MCC", uri: "ipfs://...", payoutRecipient: "0x..." });

⚙️ Configuration

Environment Variables

Variable

Required

Description

ZORA_API_KEY

Recommended

API key from

zora.co

for enhanced features

BASE_RPC_URL

Optional

Base mainnet RPC endpoint (defaults to public RPC)

CHAIN_ID

Optional

Chain ID (defaults to 8453 for Base)

PRIVATE_KEY

Write ops only

0x-prefixed private key for transactions

PLATFORM_REFERRER

Optional

Address for referral attribution

Getting API Keys

  1. Visit zora.co

  2. Go to Developer Settings

  3. Generate a new API key

  4. Add to your .env file

Note: The server works without an API key but may have rate limits and reduced functionality.

🔒 Security Best Practices

Private Key Safety

  • Never commit private keys to version control

  • Use environment variables or secure key management

  • Consider using a dedicated wallet for trading operations

  • Test with small amounts first

API Key Protection

  • Store API keys securely

  • Rotate keys regularly

  • Monitor usage in Zora dashboard

  • Use different keys for development/production

🛠️ Development

Local Development

# Clone the repository git clone https://github.com/your-username/zora-coins-mcp-server.git cd zora-coins-mcp-server # Install dependencies npm install # Copy environment file cp .env.example .env # Start development server npm run dev

Building

# Build TypeScript npm run build # Clean build directory npm run clean # Build and start npm run build && npm start

Project Structure

zora-coins-mcp-server/ ├── src/ │ └── index.ts # Main server implementation ├── dist/ # Compiled JavaScript ├── .env.example # Environment template ├── package.json # Package configuration ├── tsconfig.json # TypeScript configuration └── README.md # This file

🌐 Supported Networks

  • Base Mainnet (8453) - Full support for all operations

  • Other networks may have limited functionality

📚 Resources

Documentation

Community

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Workflow

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This software is provided "as is" without warranty. Cryptocurrency trading involves risk. Always:

  • Test with small amounts first

  • Understand the risks involved

  • Never invest more than you can afford to lose

  • Do your own research (DYOR)

The Zora Coins on this platform are created for artistic and cultural purposes as collectibles, not as investments or financial instruments.

Built with ❤️ for the Zora ecosystem

Report Issues | Request Features | Join Community

One-click Deploy
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/r4topunk/zora-coins-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server