Sokket – Site Connector for MCP Documentation

Welcome to the documentation for Sokket – Site Connector for MCP, the self-hosted MCP (Model Context Protocol) server for WordPress by BeautifulPlugins. It turns your site into an endpoint that Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, and any other MCP-compatible AI client can connect to — with the tools and permissions you control.

Everything here applies to the free plugin from WordPress.org. Pages covering the Pro add-on are marked as Pro.

New here? Start with Installation and then the Getting Started guide — it takes you from a fresh install to a connected AI client in about ten minutes.

The one thing to know first: this plugin never calls an AI provider and stores no AI API key. It only receives connections from clients you configure. See Security & Privacy.

Setup

• Installation — requirements, install, activate, and update.
• Getting Started — enable the server, create a token, and connect your first client.
• Settings — every screen and option explained: General, Access, OAuth, and Connect your AI client.

Connecting

• Connecting Your AI Client — exact setup for Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, and generic clients.
• Tokens & Permissions — bearer tokens, the tool allowlist, the read-only ceiling, capability checks, and Application Passwords.
• OAuth 2.1 Connections — sign-in based connections, the consent screen, registered clients, and revoking access.

Everyday Use

• Tool Reference — all 20 tools, what each one does, its arguments, and the capability it requires.
• Audit Log — what is recorded, what deliberately isn’t, and how to read it.

Security

• Security & Privacy — the threat model, the three permission gates, upload hardening, rate limiting, and the no-outbound-calls guarantee.

Pro

• Pro Features — file, database, WP-CLI, plugin/theme, and user tools, plus the advanced audit log.

For Developers & Help

• Developer Reference — the sokket_register_tools filter, tool definition schema, every hook, and the transport details.
• FAQ & Troubleshooting — common questions and fixes for connection problems.

Can’t find what you need?

Search this documentation first — most answers are a page away. If you’re still stuck, open a support ticket and include your WordPress version, the plugin version, the AI client you’re connecting, and what you expected to happen. We read every ticket.