# Factosys MCP

![PHP >= 8.0](https://img.shields.io/badge/PHP-%3E%3D%208.0-777BB4?logo=php&logoColor=white)
![WordPress >= 6.7](https://img.shields.io/badge/WordPress-%3E%3D%206.7-21759B?logo=wordpress&logoColor=white)
![License GPL-2.0-or-later](https://img.shields.io/badge/License-GPL--2.0--or--later-blue)

**Factosys MCP** is a product of [Factosys Peru S.A.C.](https://factosysperu.com/) (Trujillo, Perú) — software a medida, sistemas, web y TI. Fork of [WP MCP Ultimate](https://github.com/AgriciDaniel/wp-mcp-ultimate) (v2.1.0): a self-contained WordPress MCP server so any AI agent can manage posts, media, users, plugins, and more. No other plugins needed.

Contact: [contacto@factosysperu.com](mailto:contacto@factosysperu.com) · [factosysperu.com](https://factosysperu.com/)

> **Compatibility:** The canonical MCP REST route is `mcp/factosys-mcp` (e.g. `/wp-json/mcp/factosys-mcp`). The legacy route `mcp/wp-mcp-ultimate` still works as an alias.

## Quick Start

### Instalar desde ZIP

1. Usa el archivo `dist/factosys-mcp.zip` (o regenera: `powershell -File scripts/build-zip.ps1`).
2. En WordPress: **Plugins → Añadir nuevo → Subir plugin**.
3. Si ya falló una instalación anterior, borra primero la carpeta `wp-content/plugins/factosys-mcp-2.1.0-factosys.0/` (FTP o administrador de archivos).
4. Activa **Factosys MCP**.
5. Ve a **Herramientas → Factosys MCP**, genera la clave y pega el snippet en Cursor / Claude / VS Code.

### Desarrollo

Copia o clona el repo en `wp-content/plugins/factosys-mcp/` y activa el plugin.

**Authentication:** Application Passwords work everywhere. For clients that require OAuth (e.g. Claude Web custom connectors), the plugin bundles an OAuth 2.1 authorization server with PKCE and dynamic client registration. See [docs/SETUP.md](docs/SETUP.md) and [SECURITY.md](SECURITY.md).

## Features

- WordPress abilities across content, media, users, plugins, menus, widgets, comments, options, and system management
- MCP protocol support with streamable HTTP transport
- Application Password auth and bundled OAuth 2.1 (PKCE + dynamic client registration)
- Admin dashboard with API key management and connection testing
- Config snippets for Claude Code, Claude Desktop, and Cursor
- Conflict detection for legacy plugins (MCP Adapter, MCP Expose Abilities, Abilities API)
- Abilities API polyfill for WordPress < 6.9

## Architecture (summary)

| Layer | Role |
| --- | --- |
| WordPress Abilities | Domain operations (posts, media, users, …) registered via the Abilities API |
| Meta-tools | `wp-mcp-ultimate/discover-abilities`, `get-ability-info`, `execute-ability` — the only tools listed to MCP clients |
| MCP Adapter (bundled) | Protocol handlers, HTTP transport, session handling |
| Admin UI | Tools > Factosys MCP — keys, health checks, client config |
| OAuth (optional) | `/.well-known/oauth-*` and `/wp-mcp-oauth/` for clients that need OAuth |

Technical identifiers (meta-tool IDs, filter prefixes, PHP namespace `WpMcpUltimate`, constants `WP_MCP_ULTIMATE_*`, text domain, admin slug, AJAX actions) are intentionally unchanged from upstream for client and upgrade stability. The REST route is `mcp/factosys-mcp` (legacy `mcp/wp-mcp-ultimate` alias).

## Requirements

- PHP 8.0 or higher
- WordPress 6.7 or higher

## Documentation

- [Setup Guide](docs/SETUP.md) — installation and configuration
- [Abilities Reference](docs/ABILITIES.md) — abilities list and capabilities

## Credit

Maintained by **Factosys Peru S.A.C.** Based on **WP MCP Ultimate** by [Agrici Daniel](https://github.com/AgriciDaniel/wp-mcp-ultimate), which builds on the WordPress AI team’s work, **MCP Adapter**, and **MCP Expose Abilities** (Bjorn Solstad).

Licensed under **GPL-2.0-or-later**. See [LICENSE](LICENSE) for the full text.

## License

GPL-2.0-or-later. See [LICENSE](LICENSE).