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

Products

Sales

Customers

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

Statistics

Discounts

Downloads

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 customer@example.com"

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