Skip to content

Returns everything the MCP settings screen shows: whether the server is on, its endpoint and name, the adapter's state, the tool count and the FluentHub connection details.

The tool count is what this site has switched on rather than what the calling admin may run, and the Pro count is zero on a free site, where Pro's tools are present only as upsell stubs. adapter.active is the field that matters: it is true only when an MCP adapter plugin is active and the WordPress Abilities API is available. hub is null unless FluentHub is installed and reports a usable state.

Endpoint ​

  • Method: GET

  • Path: /settings/mcp

  • Edition: Core

  • Controller: McpSettingsController@get

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

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

  • Site administrators only.

  • It answers normally with MCP switched off and with no adapter installed — the settings routes are registered either way.

  • is_local_dev is true for the usual local hostnames and private addresses, which the screen uses to explain why a remote AI client cannot reach the site.

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.

GET Get MCP Settings​

GET
/settings/mcp

Returns everything the MCP settings screen shows: whether the server is on, its endpoint and name, the adapter's state, the tool count and the FluentHub connection details.

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

Authorizations​

ApplicationPasswords

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

Type
API Key (header: Authorization)

Responses​

Successful response

application/json
JSON
{
  
"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

Samples​

Powered by VitePress OpenAPI

FluentCommunity developer documentation