# FactDesk [Verified owner] [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/313Automations/factdesk  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/factdesk

## Description
A free, read-only MCP server for WordPress that lets AI assistants search and read public pages, posts, custom post types, and WooCommerce product details without API keys or external services.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What FactDesk does

FactDesk adds an MCP endpoint to a WordPress site and makes selected information available to connected AI assistants. It can describe the site, search public pages and posts, include enabled public custom post types, return page or post content as cleaned Markdown, and list shared content in batches of 50.

WooCommerce support covers product discovery and product details. Agents can search by terms, category, price range, or stock status, then retrieve the product information shown by the shop, including regular and sale prices, availability, options, variations, descriptions, ratings, and images.

All exposed operations are read-only. Agents cannot edit content, delete records, place orders, or send messages through FactDesk.

## How it works

After activation, WordPress serves the MCP endpoint at:

`https://your-site.com/wp-json/factdesk/v1/mcp`

The server uses MCP Streamable HTTP with plain JSON responses and no sessions. It supports protocol versions 2025-11-25, 2025-06-18, 2025-03-26, and 2024-11-05.

FactDesk limits its responses to information available to a logged-out visitor. Draft, private, scheduled, and password-protected content is excluded. Content marked `noindex` through Yoast SEO, Rank Math, SEOPress, or The SEO Framework is also excluded, as are products hidden from the WooCommerce catalog. Site owners can additionally hide content using the editor’s “Hide from AI agents” setting or by ID in the plugin settings.

The plugin publishes a server card at `/.well-known/mcp/server-card.json` for discovery by MCP directories and clients. It can also create an `llms.txt` file containing main pages, recent posts, and product categories; an existing `llms.txt` file is preserved.

## Setup and configuration

Install FactDesk from WordPress under **Plugins > Add New**, or download it from WordPress.org, then activate it. Open **Settings > FactDesk**, select the content types to share, add a sentence describing the business, and save the configuration. Use **Test the server** to run the setup checks, then provide the endpoint URL to an MCP client.

Composer installation is also available:

```bash
composer require 313automations/factdesk
```

The plugin requires WordPress 6.4 or later and PHP 7.4 or later. No API keys, paid account, or external service configuration is required.

## Tools and capabilities

- Return the site name, description, language, selected main-menu pages, and chosen contact details.
- Search pages, posts, and enabled public custom post types with short match summaries.
- Convert shared page and post content to Markdown while retaining headings, lists, tables, and links and removing menus and scripts.
- List shared pages and posts, 50 items per response.
- Search WooCommerce products by text, category, price range, or stock.
- Retrieve WooCommerce product fields such as pricing, availability, variations, descriptions, ratings, and images.

Developers can customize behavior through filters including `factdesk_post_available`, `factdesk_post_markdown`, `factdesk_tools`, `factdesk_call_tool`, `factdesk_site_info`, `factdesk_server_card`, `factdesk_llms_txt`, `factdesk_rate_limit`, and `factdesk_client_ip`.

## Limitations and notes

FactDesk is intended for public, read-only access. A per-address rate limit defaults to 60 requests per minute, requests larger than 64 KB are refused, and large batches are rejected. The server does not track users, call remote services, or send site data elsewhere.

The content available to an agent depends on the sharing settings and the visibility rules described above. WooCommerce tools apply only to product information exposed by the shop catalog. The project is licensed under GPL-2.0-or-later.

_Full upstream README: https://allmcps.com/mcp/factdesk/readme_

