settings.example.json

{
  "_comment": "MainWP MCP Server Settings - Copy this file to settings.json and customize. All fields are optional. Environment variables take precedence over settings file values. Authentication requires either username+appPassword OR apiToken. If both are provided, Basic Auth (username+appPassword) takes precedence over apiToken. Set schemaVerbosity to 'compact' to reduce token usage by ~30%.",

  "dashboardUrl": "https://dashboard.example.com",

  "username": "admin",
  "appPassword": "xxxx xxxx xxxx xxxx xxxx xxxx",

  "apiToken": "your-mainwp-token-here",

  "skipSslVerify": false,
  "allowHttp": false,
  "safeMode": false,
  "requireUserConfirmation": true,

  "rateLimit": 60,
  "requestTimeout": 30000,
  "maxResponseSize": 10485760,
  "maxSessionData": 52428800,

  "allowedTools": ["list_sites_v1", "get_site_v1"],
  "blockedTools": ["delete_site_v1"],
  "schemaVerbosity": "standard",
  "responseFormat": "compact",
  "abilityNamespaces": ["mainwp"],

  "retryEnabled": true,
  "maxRetries": 2,
  "retryBaseDelay": 1000,
  "retryMaxDelay": 2000
}