Skip to content

Switches the MCP server on or off.

Takes settings.active as the exact string yes or no; anything else is rejected. The value is stored in FluentCommunity's own options and the response is the full settings screen payload with a message.

Endpoint ​

  • Method: POST

  • Path: /settings/mcp

  • Edition: Core

  • Controller: McpSettingsController@save

  • Route source: fluent-community/Modules/Mcp/Http/mcp_api.php:10

  • Controller source: fluent-community/Modules/Mcp/Http/Controllers/McpSettingsController.php

  • Site administrators only, and the switch saves as soon as it is toggled — there is no separate save step.

  • Turning it on neither installs nor checks for an adapter. Without one the MCP endpoint does not exist at all, so check adapter.active in the response rather than assuming the server is reachable.

  • Abilities are registered on the next request, not this one.

  • A missing or out-of-range value answers 422.

Reconstructed sample

This endpoint belongs to a module that is not active on the reference install (or needs a file upload), so the payload below was reconstructed by reading the controller rather than recorded. Field names and types follow the source; values are illustrative.

POST Save MCP Settings​

POST
/settings/mcp

Switches the MCP server on or off.

Controller: McpSettingsController@save
Route source: fluent-community/Modules/Mcp/Http/mcp_api.php:10

Authorizations​

ApplicationPasswords

WordPress Application Passwords — use Basic auth with username:application_password.

Type
API Key (header: Authorization)

Request Body​

application/json
JSON
{
  
"settings": {
  
},
  
"active": "string"
}

Responses​

Successful response

application/json
JSON
{
  
"message": "string",
  
"settings": {
  
  
"active": "string"
  
},
  
"endpoint_url": "string",
  
"server_name": "string",
  
"adapter": {
  
  
"installed": true,
  
  
"active": true,
  
  
"provider": "string",
  
  
"version": "string",
  
  
"abilities_api": true,
  
  
"can_auto_install": true,
  
  
"download_url": "string"
  
},
  
"hub": "string",
  
"tools": {
  
  
"total": 0,
  
  
"pro": 0
  
},
  
"pro_active": true,
  
"app_passwords_url": "string",
  
"plugins_url": "string",
  
"current_user_login": "string",
  
"is_local_dev": true
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

FluentCommunity developer documentation