CMS Tool API schema
Public API version 1.4.10.
MCP server
Connect an MCP client to CMS Tool data and operations.
Connection
The MCP server is an extension of the API and uses the same OAuth access tokens and permission-based scopes.
Send JSON-RPC 2.0 messages by POST to https://api.cms-tool.net/api/mcp with Content-Type application/json and an Authorization Bearer header.
OAuth protected resource metadata
Session sequence
Call initialize first, send notifications/initialized, then use tools/list and tools/call. The server also supports ping and notifications/cancelled.
The supported MCP protocol version is 2025-11-25.
Available tools
Request only the scopes required by the tools your client will call.
| Tool | Scope | Limit | Purpose |
|---|---|---|---|
| get_database_schema_metadata | mcp/get_database_schema_metadata:read | 30/minute, 4 concurrent | Get current planning instructions and database metadata before building a report or product update plan. |
| get_website_metadata | mcp/get_website_metadata:read | 30/minute, 4 concurrent | Get website categories, pages, and site metadata used by a plan. |
| generate_report | mcp/generate_report:read | 10/minute, 2 concurrent | Validate and run a report plan. |
| preview_product_update | mcp/preview_product_update:read | 6/minute, 1 concurrent | Validate a product update and return its proposed before and after values. |
| execute_product_update | mcp/execute_product_update:write | 4/minute, 1 concurrent | Apply a product update that has been previewed. |
Tool calls
Call get_database_schema_metadata with purpose report or product_update before constructing the corresponding plan. Use the returned instructions and metadata as the current contract.
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_database_schema_metadata","arguments":{"purpose":"report"}}}Rate limits
Tools have per-user request and concurrency limits. Successful calls can include RateLimit response headers and rate_limit metadata. A limited request returns HTTP 429 with Retry-After.
/api/mcp
Process authenticated MCP JSON-RPC requests.
Machine-readable documentation
This documentation is also available as JSON or Markdown at the same URL. Request JSON with Accept: application/json or Markdown with Accept: text/markdown.