Everything you need to run Smart MCP.

The AI works through a registry of tools. Every tool needs the right WordPress capability, and medium or high risk actions pause until you approve them. The free plugin has 68 tools and is complete on its own. Nothing in it is locked or limited.

• Chat with your site in WP Admin: streaming answers, saved conversations you can rename, and a model switch per conversation.
• Connect AI apps such as Claude Desktop, Claude Code, ChatGPT, Cursor and VS Code with an API key or OAuth.
• Content and media: posts, pages, comments, media, menus and taxonomies.
• Block editor and Site Editor: read and edit blocks, use patterns, update block theme templates. Every change keeps a revision.
• Elementor: build pages with native widgets, and full Elementor 4 design with tokens, global classes, per-device styles and animations.
• Divi 5 (with Smart MCP Pro): build pages, Theme Builder headers and footers, Library items, global colors and presets, and change every Divi theme setting.
• Checks its own work: empty headings and buttons, missing alt text, heading order, broken internal links and hand-typed colors.
• Undo a whole conversation: every post or page changed in a chat gets a restore point. Ask the AI to undo and it all goes back.
• Safe edits for live pages: bigger changes happen on a private draft copy with a preview link and go live only when you say so.
• Telegram bot: chat with your site from Telegram.
• System check: compares your hosting with what the chat needs and tests live replies, so you know what to change before long tasks.

1. 1Install Smart MCP from the WordPress Plugins screen, or upload the smarto-smart-mcp folder to /wp-content/plugins/.
2. 2Activate the plugin.
3. 3Go to WP Admin > Smart MCP > Getting Started and add your AI provider API key.
4. 4Click Test connection, then save.
5. 5Open WP Admin > Smart MCP > Chat and ask something, for example "List my five latest posts".

The WP Admin menu has these pages: Chat, Getting Started, Connect, AI Providers, Settings, Context, Audit Log and Telegram Bot. Each page shows a header with the page name, whether an AI provider is set up, and whether the MCP server is on.

Open Smart MCP > Chat and click System check. It compares your server with what the chat needs. When something needs attention, a banner on the Chat page says so.

Run live reply test sends a reply in small parts for 30 seconds, like a long AI task. It shows whether replies arrive live and whether your host keeps the connection open, and names the host or proxy it detects.

1. 1Open Smart MCP > AI Providers.
2. 2Under "API keys", paste a key for each provider you want to use and save.
3. 3Click Test connection. It shows how many models are available.
4. 4Under "AI for the Chat page and Telegram", pick a provider and a model.

Keys are encrypted at rest and never shown again in full. Use Replace to enter a new one or Remove to delete it. Each provider shows a status: In use, Key saved or Not set up. You can still switch the model for a single conversation on the Chat page.

1. 1Open Smart MCP > Connect.
2. 2Turn on the MCP server and Enable external access. External access is off by default.
3. 3Optionally turn on OAuth 2.0 authorization endpoints.
4. 4Choose the credential: an API key (simplest, paste it into the client config) or an OAuth client (sign in through the browser, no key to copy).
5. 5Generate it and copy it right away. The key or secret is shown once.
6. 6Choose your AI client from the list and follow its steps: one-click install where available, or manual configuration.

Your endpoint and discovery file:

https://your-site.com/wp-json/smart-mcp/v1/mcp
https://your-site.com/wp-json/smart-mcp/v1/.well-known/mcp.json

Setup guides are included for Claude Desktop, Claude Code, Claude.ai, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Windsurf, Zed, Cline, Roo, Kilo Code, OpenCode, Amazon Q and Antigravity.

External apps can work with posts, pages, Elementor and block editor design, media, comments, taxonomies, store content and read-only site information. They cannot install, activate or update plugins and themes, manage users, change site settings or modify site code. That work is part of Smart MCP Pro.

By default, requests run as a non-administrative user who can edit posts, for example an Editor. Under Connect > Account used by AI clients you can choose that account or create a dedicated Editor account.

If your site has only an administrator account, tick the confirmation box under Use my administrator account and turn it on. AI apps then create, edit and delete content under your name, but stay limited to the same content tools an Editor can use. Every action is recorded in the Audit Log and you can turn it off at any time.

Reading and other low-risk actions always run. On Smart MCP > Settings, the permission policy decides what happens to changes and risky actions:

Critical tools are the most powerful tools, added by extensions such as Smart MCP Pro (for example running PHP). When off, they are blocked on the Chat page and for AI apps. The Telegram bot has its own switch.

On the Chat page and in Telegram, an action that needs approval shows an Approve button right where you chat. Claude, ChatGPT and other apps cannot show that button, so their requests wait on the Settings page under Waiting for approval. Approving runs the action right away.

Smart MCP > Context shows the system context the AI receives and lets you add your own site-specific instructions, for example your tone of voice or what never to touch. They apply in every conversation. You can switch them off without losing the text.

Smart MCP > Audit Log records what the AI did, including actions from external apps. Users who are allowed to can export or clear it.

The Smart MCP > Telegram Bot page has a status badge (Setup needed or Bot ready) and four steps.

Step 1: Connect your bot

1. 1In Telegram open @BotFather, the official bot for creating bots.
2. 2Send /newbot, then choose a name and a username that ends in "bot", for example mysite_helper_bot.
3. 3BotFather replies with a token like 123456789:AAH.... Copy it.
4. 4Paste it into Bot token, keep Bot is on enabled and click Save and connect.

Saving checks the token with Telegram and connects the webhook for you. The token is stored on your site and only its first 6 and last 4 characters are ever shown. Use Replace token to change it.

Step 2: Connect the webhook. The webhook is how Telegram delivers your messages to your site. It connects automatically when you save the token. The page shows Connected, Connected without the security check, or Not connected, with buttons to Connect or Reconnect webhook, Disconnect webhook and Test bot.

https://your-site.com/wp-json/smart-mcp/v1/telegram/webhook

Step 3: Link your chat. Send any message such as "hi" to your bot. Your chat appears on the page within a few seconds (it stays offered for 30 minutes). Click Link this chat. Or enter your numeric chat ID: send a message to @userinfobot, which replies with your ID, then click Link chat ID.

Step 4: How the bot works (optional). Choose the AI provider and model for Telegram, the permission policy, and the Critical tools switch. By default the bot uses the same AI and permissions as the Chat page.

While the AI works, the bot shows as typing, and the answer arrives as one message. There are no extra status messages in the chat.

The bot remembers the conversation until you clear it. Anyone who is not the linked chat gets "This bot is private." The bot answers as a WordPress user with content permissions, such as an Editor.

1. 1Token. It must look like 123456789:AAH.... If the page says the saved token is not a Telegram bot token, your browser may have filled in a password. Paste the token from BotFather again. If it says the token has not been checked, click Save.
2. 2Bot is on. When off, the bot ignores every message.
3. 3Webhook. It must say Connected. If it says Not connected or Connected without the security check, click Connect webhook or Reconnect webhook. Read "Last error reported by Telegram" if one is shown, and click Test bot.
4. 4Linked chat. If the bot says "This bot is not linked to your site yet", send it a message and click Link this chat. If the saved chat ID is not a number, link the chat again.
5. 5"This bot is private". You are writing from a chat that is not the linked one.
6. 6No user found. The bot needs a WordPress user with content permissions. Create an Editor.
7. 7AI key. Make sure a provider key is saved on AI Providers, otherwise the bot cannot answer.
8. 8HTTPS. Telegram must be able to reach your site over HTTPS. A local site on localhost cannot receive Telegram messages.
9. 9Long jobs. They can stop at your host's time limit. Send /new and ask for smaller steps, or use Smart MCP Pro background jobs.

• On AI Providers, select the provider and a model, add the API key and click Test connection. "No models returned. Check the API key." means the key is wrong or has no access.
• For the Custom provider, add the base URL of your OpenAI-compatible server. Keys are not shown again; use Replace to enter a new one.
• Keep the Chat page open while the AI works. The waiting line shows how long it has been working; long tasks can take a few minutes.

• On Connect, the MCP server and Enable external access must be on. Use the endpoint https://your-site.com/wp-json/smart-mcp/v1/mcp.
• Actions that need approval from an external app wait on Settings > Waiting for approval. Approve them there.
• External apps can only do content work. Plugin, theme, user and settings actions need Smart MCP Pro.
• Open the Audit Log to see what the app did.

Pro installs next to the free plugin and adds 58 tools (126 in total), plus 9 Divi tools on sites that run Divi 5. They appear in the AI chat and in AI apps automatically, and a Skills page shows up in the Smart MCP menu.

1. 1Install and activate the free Smart MCP plugin first.
2. 2Install Smart MCP Pro on the Plugins screen, or upload its folder to /wp-content/plugins/, then activate it.
3. 3Activate your license (see the next section). Until then Pro features are locked.
4. 4The advanced tools and the Skills page appear in the Smart MCP menu.

If WP Smarto cannot be reached, nothing is changed. Try again in a moment. Your licenses and site limits are in your account dashboard on wpsmarto.com.

A skill is a SKILL.md file stored as a post, so it is easy to back up, version and share. Open Smart MCP > Skills to create, edit, enable or disable, trash and restore skills.

• Upload and download skills as .md files. The frontmatter needs a title and a description, and the body can be up to 1 MB.
• Share a skill by exporting it as one markdown file and importing it on another site.
• Slugs and titles must be unique.
• Built-in skills are offered only for plugins that are active on your site: Elementor and its addon packs, Divi, Beaver Builder, GenerateBlocks, Kadence Blocks, Spectra, popular themes, WooCommerce, Code Snippets, Weglot, SEO, form and custom field plugins.

When Divi 5 is active (the Divi theme, the Divi Builder plugin or Extra), Pro adds 9 Divi tools. Ask in plain words, for example "build a landing page with a hero, three features and a pricing table" or "make all buttons rounded and use our brand blue".

• Every layout is rendered with Divi before it is saved. If something would break the page, nothing is saved and the AI is told what to fix.
• Page changes can be undone from chat like any other change. Colors, variables, presets and theme settings are backed up before each change and can be restored.
• A page you have open in the Visual Builder is never changed. Close it first.
• Turn the Divi tools on or off per channel with the Divi switch on the Connect and Settings pages.

• Big pages are built in steps, one or two sections at a time, so long jobs do not time out in the chat.
• Landing pages can use Divi's Blank Page template, which hides the theme header and footer.
• The AI checks the CSS Divi generates to make sure every style took effect, and gets clear help when a setting has the wrong shape.

In the free plugin a job runs inside one request. With Pro, the webhook saves the job and answers right away, and each AI step runs in its own short request. The bot shows as typing until the answer arrives.

• Send /stop to cancel. Steps that already finished stay done.
• If the server stops a step, send "continue" and the bot checks where it stopped and carries on.
• The switch is Run jobs in the background on the Telegram Bot page under "Long jobs (Pro)". It is on by default.

The free plugin limits external apps to content work. With Pro you can generate a WordPress Application Password on the Connect page and give it to the app. The app sends it as HTTP Basic authentication and acts as your WordPress user, including administrator access.

• Every Pro tool runs under the same capability checks and approval flow.
• New PHP files are written to a sandbox directory. If one causes a fatal error, the loader detects it and skips the file instead of breaking your site.
• Dangerous PHP functions are blocked before code runs, and a time limit stops runaway code.
• Critical tools, such as running PHP, need their own switch on the Settings page.

• Pro tools or the Skills page are missing. The free plugin must be active, then Pro, then the license activated.
• Pro features are locked. Verify the license. If your site slots are used up, deactivate an old site first.
• A tool such as running PHP is blocked. Turn on Critical tools on Smart MCP > Settings. For Telegram it is a separate switch on the Telegram Bot page.
• A skill upload fails. It must be a .md file with frontmatter that starts and ends with ---, has a title and a description, and is under 1 MB.
• The Divi tools are missing. They need Divi 5. On Divi 4 only a detection tool is offered. Also check the Divi switch on the Connect or Settings page.
• The AI says a Divi page is open in an editor. Close the Visual Builder on that page, wait a minute, and ask again.
• Divi says it could not render a layout. Nothing was saved. The AI gets the reason and can retry with the right settings.