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 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