# wpgoldmine-mcp

An [MCP](https://modelcontextprotocol.io) server for finding **WordPress plugin opportunities** — large,
established plugins weakened by **abandonment, low ratings, or poor support**, i.e. plugins you could
realistically replace or out-build. It lets AI agents (Claude, Cursor, Windsurf, etc.) query the
WordPress.org plugin directory through the lens of "what's a takeable market here?"

Powered by [wpgoldmine.io](https://wpgoldmine.io). All querying runs server-side, so **no local
database or scraping is required.**

## Install / run

```jsonc
// Claude Desktop / any MCP client config
{
  "mcpServers": {
    "wpgoldmine": {
      "command": "npx",
      "args": ["-y", "wpgoldmine-mcp"]
    }
  }
}
```

## Tools

### `list_opportunity_presets`
Lists the curated opportunity angles you can pass as `preset` (e.g. `abandoned-plugins`,
`low-rated-popular`, `beatable-niche`, `unsupported-plugins`, `high-opportunity`,
`newest-opportunities`).

### `find_plugin_opportunities`
Returns a ranked, capped list of plugin opportunities.

| Param | Type | Description |
| --- | --- | --- |
| `preset` | string (optional) | A preset key. Composes with `tag`. |
| `tag` | string (optional) | Narrow to a niche by WordPress.org tag, e.g. `seo`, `forms`, `backup`. |
| `ecosystem` | `wordpress` \| `woocommerce` (optional) | Defaults to `wordpress`. |
| `min_installs` / `max_installs` | number (optional) | Active-install bounds. |
| `max_rating` | number (optional) | Max rating on a 0–100 scale (lower = more dissatisfied users). |

### `get_plugin`
Opportunity snapshot for one plugin by slug: installs, rating, last-updated, support resolution, and
opportunity / abandonment / monetization scores.

**Example agent uses:** "Find abandoned WordPress plugins in the forms niche I could rebuild," "Which
popular SEO plugins have the worst ratings?", "Give me the opportunity score for wp-super-cache."

## Config

- `WPGOLDMINE_API_KEY` — optional. A WP Goldmine account API token (from your account settings) raises
  the result limit and unlocks extra fields. Without it, the server uses the free, capped tier.
- `WPGOLDMINE_API_BASE` — override the API base (default `https://wpgoldmine.io`).

```jsonc
{
  "mcpServers": {
    "wpgoldmine": {
      "command": "npx",
      "args": ["-y", "wpgoldmine-mcp"],
      "env": { "WPGOLDMINE_API_KEY": "wpg_your_token_here" }
    }
  }
}
```

## License

MIT