MCP Server

AI Assistant Integration

Connect Claude, Cursor, or any MCP-compatible AI assistant directly to your Ponzinomics project. Read docs, manage quests, check leaderboards, and deploy sites — all through natural language.

1. Installation

bash

npm install -g @ponzinomics/mcp
# or
pnpm add -g @ponzinomics/mcp

2. Authentication

The MCP server reads credentials in this priority:

Environment variables: PONZINOMICS_API_KEY + PONZINOMICS_PROJECT_ID
CLI credentials: ~/.ponzinomics/credentials.json — shared with the CLI after running ponzinomics login

3. Connect to Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "ponzinomics": {
      "command": "npx",
      "args": ["-y", "@ponzinomics/mcp"],
      "env": {
        "PONZINOMICS_API_KEY": "your-api-key",
        "PONZINOMICS_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json

Available Tools

projects

List and inspect projects

quests

Create, update, and list quests

leaderboard

Query rankings and stats

points

Award, deduct, and check balances

builder

Deploy and configure sites

Search documentation