mcp-edd

MCP server for Easy Digital Downloads REST API - access sales data, customers, products, and analytics from your EDD store.

Features

• 📊 Sales Analytics - Revenue, transaction counts, date ranges
• 👥 Customer Data - Purchase history, lifetime value
• 🛍️ Product Catalog - Pricing tiers, licensing info
• 🏷️ Discount Codes - Usage stats and configuration
• 📥 Download Logs - File download tracking
• 🔒 Type Safety - Full Zod schema validation

Installation

Quick Install (Claude Desktop)

Download the Desktop Extension for one-click installation:

Release page (download .mcpb asset)

Double-click the downloaded file to install. You'll be prompted for your API credentials.

npm Install

npm install -g @verygoodplugins/mcp-edd

Or add to your Claude Desktop configuration directly (see below).

Configuration

Environment Variables

Set these environment variables before running the server:

export EDD_API_URL="https://your-store.com/edd-api/"
export EDD_API_KEY="your-api-public-key"
export EDD_API_TOKEN="your-api-token"

Or create a .env file in your working directory.

Getting API Credentials

1. In WordPress admin, go to Downloads → Settings → API
2. Generate a new API key for your user
3. Copy the Public Key and Token
4. Your API URL is https://your-site.com/edd-api/

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "edd": {
      "command": "npx",
      "args": ["-y", "@verygoodplugins/mcp-edd"],
      "env": {
        "EDD_API_URL": "https://your-store.com/edd-api/",
        "EDD_API_KEY": "your-api-public-key",
        "EDD_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Setup / Diagnostics

| Tool | Description | |------|-------------| | edd_validate_connection | Validate your Store API URL and credentials |

Products

| Tool | Description | |------|-------------| | edd_list_products | List all products with pricing and stats | | edd_get_product | Get detailed product info by ID |

Sales

| Tool | Description | |------|-------------| | edd_list_sales | List recent sales with filters | | edd_get_sale | Get sale by ID or purchase key |

Customers

| Tool | Description | |------|-------------| | edd_list_customers | List customers with purchase stats | | edd_get_customer | Get customer by ID or email |

Note: edd_list_customers returns the EDD customer ID as id (usable with edd_get_customer(customerId=...)) and includes userId when available.

Statistics

| Tool | Description | |------|-------------| | edd_get_stats | Get earnings/sales totals | | edd_get_stats_by_date | Get daily stats for date range | | edd_get_stats_by_product | Get stats breakdown by product |

Discounts

| Tool | Description | |------|-------------| | edd_list_discounts | List all discount codes | | edd_get_discount | Get discount details by ID |

Downloads

| Tool | Description | |------|-------------| | edd_get_download_logs | Get file download history |

Example Usage

Once configured, you can ask Claude:

• "Show me this month's sales revenue"
• "List the top 10 customers by lifetime value"
• "How many licenses were sold for WP Fusion last month?"
• "Show me all active discount codes"
• "Get the purchase history for [email protected]"

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test                    # Unit tests
npm run test:integration    # Integration tests (requires credentials)
npm run test:all           # All tests

# Lint
npm run lint

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Submit a pull request

API Reference

This server wraps the EDD REST API. See their documentation for detailed endpoint information.

License

GPL-3.0 - see LICENSE for details.

Support

For issues, questions, or suggestions:

• Open an issue on GitHub
• Contact Very Good Plugins

Built with 🧡 by Very Good Plugins