zora

This MCP server integrates the Zora Protocol SDK with Coinbase AgentKit to enable AI-driven on-chain interactions through MCP clients like Claude. It exposes tooling to query Zora protocol data (e.g., top tokens by volume, token information, new or valuable tokens), and to perform trades or swaps via natural language commands. Clients configure the server in their MCP config, supply their wallet and network credentials, and then issue natural language instructions such as retrieving token data, listing top movers, or swapping assets. The server translates these requests into Zora protocol SDK calls and on-chain actions, returning results to the user through the MCP client interface. Typical commands you can express include: getting top tokens by volume on Zora, obtaining token information by address, listing newly minted coins on Zora, querying last traded tokens, and performing swaps or trades using your available balance.

Prerequisites:

• Node.js (recommended LTS version) and npm installed on your system
• Access to the internet to install npm packages

Installation steps:

1. Install the MCP server globally so it can be invoked as a command:

npm install -g @6missedcalls-ai/zora-mcp-server

2. Verify the zora-mcp-server binary is available:

zora-mcp-server --help

3. If you are developing locally from the repository instead of using the global package, clone the project and install locally:

git clone https://github.com/6missedcalls/zora-mcp.git
cd zora-mcp
npm install

4. Build the MCP server (if a build step exists in your workflow):

npm run build

5. Run or configure the MCP server in your MCP configuration (see mcp_config for example) and provide necessary environment variables for credentials and network access.

Tips and common issues:

• Ensure environment variables are securely provided in your MCP client configuration, especially API keys and private keys.
• The server expects NETWORK_ID to point to your desired Ethereum-compatible network (e.g., base-mainnet for Base).
• When using the local build, point the MCP config to the built index.js path, as shown in the README example.
• If you encounter auth or API key issues with Zora or Coinbase AgentKit, verify that keys are valid and have the required permissions.
• If you upgrade the MCP server or SDKs, re-run npm install to fetch compatible dependencies.
• For debugging, enable verbose logging in your MCP client to inspect the translated SDK calls and on-chain interactions.