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

In WordPress admin, go to Downloads → Settings → API
Generate a new API key for your user
Copy the Public Key and Token
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:

Fork the repository
Create a feature branch
Make your changes with tests
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:

Built with 🧡 by Very Good Plugins