Easy Digital Downloads
MCP server for Easy Digital Downloads REST API - sales, customers, products, analytics
What can you do with Easy Digital Downloads?
- 📊 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
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@verygoodplugins/mcp-eddclaude mcp add easy-digital-downloads -- npx -y @verygoodplugins/mcp-edd@1.1.0
{
"mcpServers": {
"easy-digital-downloads": {
"command": "npx",
"args": [
"-y",
"@verygoodplugins/mcp-edd@1.1.0"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
Frequently asked questions
What is Easy Digital Downloads?
MCP server for Easy Digital Downloads REST API - sales, customers, products, analytics
How do I install Easy Digital Downloads?
It runs on your machine. In Claude Code: claude mcp add easy-digital-downloads -- npx -y @verygoodplugins/mcp-edd@1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Easy Digital Downloads need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Easy Digital Downloads open source?
Yes. Its code is on GitHub under the GPL-3.0 license.
Who maintains Easy Digital Downloads?
It is published by verygoodplugins. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.