{
  "markdown": "# mcp-edd\n\nMCP server for [Easy Digital Downloads](https://easydigitaldownloads.com/) REST API - access sales data, customers, products, and analytics from your EDD store.\n\n[![npm version](https://img.shields.io/npm/v/@verygoodplugins/mcp-edd.svg)](https://www.npmjs.com/package/@verygoodplugins/mcp-edd)\n[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](LICENSE)\n\n## Features\n\n- 📊 **Sales Analytics** - Revenue, transaction counts, date ranges\n- 👥 **Customer Data** - Purchase history, lifetime value\n- 🛍️ **Product Catalog** - Pricing tiers, licensing info\n- 🏷️ **Discount Codes** - Usage stats and configuration\n- 📥 **Download Logs** - File download tracking\n- 🔒 **Type Safety** - Full Zod schema validation\n\n## Installation\n\n### Quick Install (Claude Desktop)\n\nDownload the Desktop Extension for one-click installation:\n\n**[Release page (download .mcpb asset)](https://github.com/verygoodplugins/mcp-edd/releases/latest)**\n\nDouble-click the downloaded file to install. You'll be prompted for your API credentials.\n\n### npm Install\n\n```bash\nnpm install -g @verygoodplugins/mcp-edd\n```\n\nOr add to your Claude Desktop configuration directly (see below).\n\n## Configuration\n\n### Environment Variables\n\nSet these environment variables before running the server:\n\n```bash\nexport EDD_API_URL=\"https://your-store.com/edd-api/\"\nexport EDD_API_KEY=\"your-api-public-key\"\nexport EDD_API_TOKEN=\"your-api-token\"\n```\n\nOr create a `.env` file in your working directory.\n\n### Getting API Credentials\n\n1. In WordPress admin, go to **Downloads → Settings → API**\n2. Generate a new API key for your user\n3. Copy the **Public Key** and **Token**\n4. Your API URL is `https://your-site.com/edd-api/`\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"edd\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@verygoodplugins/mcp-edd\"],\n      \"env\": {\n        \"EDD_API_URL\": \"https://your-store.com/edd-api/\",\n        \"EDD_API_KEY\": \"your-api-public-key\",\n        \"EDD_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Setup / Diagnostics\n\n| Tool | Description |\n|------|-------------|\n| `edd_validate_connection` | Validate your Store API URL and credentials |\n\n### Products\n\n| Tool | Description |\n|------|-------------|\n| `edd_list_products` | List all products with pricing and stats |\n| `edd_get_product` | Get detailed product info by ID |\n\n### Sales\n\n| Tool | Description |\n|------|-------------|\n| `edd_list_sales` | List recent sales with filters |\n| `edd_get_sale` | Get sale by ID or purchase key |\n\n### Customers\n\n| Tool | Description |\n|------|-------------|\n| `edd_list_customers` | List customers with purchase stats |\n| `edd_get_customer` | Get customer by ID or email |\n\nNote: `edd_list_customers` returns the EDD **customer** ID as `id` (usable with `edd_get_customer(customerId=...)`) and includes `userId` when available.\n\n### Statistics\n\n| Tool | Description |\n|------|-------------|\n| `edd_get_stats` | Get earnings/sales totals |\n| `edd_get_stats_by_date` | Get daily stats for date range |\n| `edd_get_stats_by_product` | Get stats breakdown by product |\n\n### Discounts\n\n| Tool | Description |\n|------|-------------|\n| `edd_list_discounts` | List all discount codes |\n| `edd_get_discount` | Get discount details by ID |\n\n### Downloads\n\n| Tool | Description |\n|------|-------------|\n| `edd_get_download_logs` | Get file download history |\n\n## Example Usage\n\nOnce configured, you can ask Claude:\n\n- \"Show me this month's sales revenue\"\n- \"List the top 10 customers by lifetime value\"\n- \"How many licenses were sold for WP Fusion last month?\"\n- \"Show me all active discount codes\"\n- \"Get the purchase history for customer@example.com\"\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run tests\nnpm test                    # Unit tests\nnpm run test:integration    # Integration tests (requires credentials)\nnpm run test:all           # All tests\n\n# Lint\nnpm run lint\n```\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes with tests\n4. Submit a pull request\n\n## API Reference\n\nThis server wraps the [EDD REST API](https://easydigitaldownloads.com/categories/docs/api-reference/). See their documentation for detailed endpoint information.\n\n## License\n\nGPL-3.0 - see [LICENSE](LICENSE) for details.\n\n## Support\n\nFor issues, questions, or suggestions:\n\n- [Open an issue on GitHub](https://github.com/verygoodplugins/mcp-edd/issues)\n- [Contact Very Good Plugins](https://verygoodplugins.com/contact/?utm_source=github)\n\n---\n\nBuilt with 🧡 by [Very Good Plugins](https://verygoodplugins.com/?utm_source=github)\n",
  "bytes": 4735,
  "sha": "f21f15153c31cd5714ef55cf41c71b2b0fe5077a531473cb32227d3fe3d5832e",
  "repo_slug": "verygoodplugins/mcp-edd",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_verygoodplugins_mcp_edd_b5cf3034/readme"
}