3Dawn MCP Server

What is this?

The 3Dawn MCP Server exposes the full 3Dawn platform to any AI assistant via the Model Context Protocol (MCP).

Connect it to Claude, ChatGPT, Cursor, or any MCP client and ask your AI to:

"Generate a cartoon robot 3D model and mint it as an NFT" "List all assets in my wallet and put the best one on the marketplace for 0.1 ETH" "What drops are active right now? How much have I earned from embeds?"

Transport: Streamable HTTP — works with remote Claude.ai integrations and local clients.

🛠️ Available Tools

🎨 Generation

📦 Assets

🛒 Marketplace

🎰 Drops

👤 User & Earnings

📊 Platform

🚀 Quick Start

Prerequisites

• Python 3.11+

• pip

Install

git clone https://github.com/3DawnRH/3dawn-mcp.git
cd 3dawn-mcp
pip install -r requirements.txt

Configure

cp .env.example .env

Edit .env:

# Required — point at the live platform or your self-hosted instance
3DAWN_API_URL=https://3dawn.xyz

# Optional — override the default port (8000)
# PORT=8000

✅ No API keys needed to run the MCP server itself. The server talks to the public 3Dawn REST API.

Run

python server.py

The server listens on http://0.0.0.0:8000/mcp (Streamable HTTP transport).

🔌 Connect to Claude.ai

1. Go to Claude.ai → Settings → Integrations → Add MCP Server

2. Enter your server URL: https://your-host:8000/mcp

3. Click Connect

For local testing, use a tunnel:

# Using ngrok
ngrok http 8000
# Then add the ngrok URL to Claude

🔌 Connect to Cursor / Local Clients

Add to your ~/.cursor/mcp.json (or equivalent):

{
  "mcpServers": {
    "3dawn": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

💡 Example Prompts

Once connected to Claude or another AI:

Generate a sci-fi spaceship 3D model in realistic style for my wallet 0x1234…

Browse the 3Dawn marketplace and find the cheapest ETH listing. Show me its 3D model.

How many total assets have been created on 3Dawn? What are the top creators earning?

List all my assets at wallet 0xABCD… and tell me which ones are listed for sale.

Check the embed analytics for asset ID 42 — how much has it earned so far?

🏗️ Architecture

3dawn-mcp/
├── server.py       # FastMCP server — all 18 tools defined here
├── client.py       # Async HTTP client wrapping the 3Dawn REST API
├── requirements.txt
└── .env.example

Dependencies:

🧪 Testing Tools Manually

# Install MCP inspector
npx @modelcontextprotocol/inspector http://localhost:8000/mcp

Or use curl:

# List all tools
curl http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

🔧 Self-Hosting 3Dawn

To point the MCP server at your own 3Dawn instance:

3DAWN_API_URL=https://your-3dawn-instance.com

See 3dawn-app for self-hosting instructions.

🤝 Contributing

See CONTRIBUTING.md. PRs welcome — especially new tools!

🔐 Security

See SECURITY.md for vulnerability reporting.

📄 License

MIT — see LICENSE