io.github.Bishop81/wpgoldmine-mcp
Find WordPress plugin opportunities: abandoned, low-rated, or poorly-supported plugins to replace.
Open source Open in the app JSON README (API)
About
Find WordPress plugin opportunities: abandoned, low-rated, or poorly-supported plugins to replace.
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- bishop81
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-06-27T22:59:01Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:42
- Updated
- 2026-08-29 03:01:42
- Origin id
io.github.Bishop81/wpgoldmine-mcp
README
# 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