Skip to main content Home Creators joseconti klytos klytos-mcp-tools
klytos-mcp-tools Guide for adding MCP (Model Context Protocol) tools to Klytos CMS — the PRIMARY interface for AI control. Use when registering new MCP tools, handling tool calls, extending the MCP API, understanding tool annotations, or building AI-controllable features. Everything added to Klytos must be configurable via MCP.
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/joseconti/klytos --skill klytos-mcp-toolsThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository
Guide for developing and maintaining Klytos CMS core. Use when modifying core files, adding MCP tools, fixing bugs, extending the core architecture, changing the build engine, modifying the installer, implementing hooks, or working with storage backends. Covers foundational principles (AI-first, privacy by design, security by default), architecture, boot sequence, manager pattern, MCP tool registration, and security checklist.
klytos-plugin-development Complete guide for developing Klytos CMS plugins including structure, entry points, MCP tools, admin pages, hooks, routes, and best practices. Use when creating, modifying, extending Klytos functionality, adding MCP tools, admin pages, hooks, filters, or debugging plugins.
Related occupations SOC
Based on SOC occupation classification
name Klytos MCP Tools description Guide for adding MCP (Model Context Protocol) tools to Klytos CMS — the PRIMARY interface for AI control. Use when registering new MCP tools, handling tool calls, extending the MCP API, understanding tool annotations, or building AI-controllable features. Everything added to Klytos must be configurable via MCP.
Klytos MCP Tools — Adding AI-Controllable Functionality
GOLDEN RULE
Everything added to Klytos MUST be configurable via MCP. MCP is the PRIMARY interface of this AI-First CMS. The admin panel is secondary. If a feature cannot be controlled by an AI via MCP, it is incomplete.
When to Use This Skill
Use this reference whenever you need to:
Add a new MCP tool to a plugin
Add a new MCP tool to the core
Understand how MCP tools are registered and executed
Build AI-controllable features
MCP Tool Registration (Plugin Pattern)
Plugins register MCP tools using three hooks:
Step 1: Register the Tool (mcp.tools_list)
klytos_add_filter ('mcp.tools_list' , function (array $tools ): array {
$tools [] = [
'name' => 'my_plugin_do_something' ,
'description' => 'Does something useful. Describe clearly what the tool does so the AI knows when to use it.' ,
'inputSchema' => [
'type' => 'object' ,
'properties' => [
'param1'
'type'
'string'
'description'
'First parameter — be descriptive.'
'param2'
'type'
'integer'
'description'
'Second parameter.'
'status'
'type'
'string'
'enum'
'active'
'inactive'
'description'
'Filter by status.'
'required'
'param1'
'annotations'
'title'
'Do Something'
'readOnlyHint'
false
'destructiveHint'
false
'idempotentHint'
false
'openWorldHint'
false
return
$tools
Step 2: Handle Tool Calls (mcp.handle_tool) klytos_add_filter ('mcp.handle_tool' , function (mixed $result , string $toolName , array $params ): mixed {
if ($toolName !== 'my_plugin_do_something' ) {
return $result ;
}
try {
$param1 = klytos_sanitize_text ($params ['param1' ] ?? '' );
$param2 = klytos_sanitize_int ($params ['param2' ] ?? 0 );
if ($param1 === '' ) {
throw new \InvalidArgumentException ('param1 is required' );
}
$data = doSomethingUseful ($param1 , $param2 );
return [
'content' => [
['type' => 'text' , 'text' => json_encode ($data , JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE)],
],
'isError' => false ,
];
} catch (\Exception $e ) {
return [
'content' => [
['type' => 'text' , 'text' => 'Error: ' . $e ->getMessage ()],
],
'isError' => true ,
];
}
}, 10 );
Step 3: Declare in Manifest (klytos-plugin.json) {
"id" : "my-plugin" ,
"name" : "My Plugin" ,
"version" : "1.0.0" ,
"mcp_tools" : [ "my_plugin_do_something" ]
}
MCP Tool Registration (Core Pattern) For core tools, use the ToolRegistry directly:
$registry ->register (
'klytos_my_feature' , // Tool name
'Does something in the core.' , // Description
[ // Schema properties
'param1' => ['type' => 'string' , 'description' => 'Parameter description' ],
],
function (array $params , App $app ): mixed {
$result = $app ->getMyManager ()->doSomething ($params ['param1' ]);
return ['success' => true , 'data' => $result ];
},
[
'readOnlyHint' => false ,
'destructiveHint' => false ,
'idempotentHint' => true ,
],
['param1' ]
);
Tool Annotations Annotation Type Description readOnlyHintbool true = does NOT modify state (safe to call anytime)destructiveHintbool true = may delete or irreversibly modify dataidempotentHintbool true = safe to call multiple times with same paramsopenWorldHintbool true = accepts arbitrary/unknown input parameters
Examples
['readOnlyHint' => true , 'destructiveHint' => false , 'idempotentHint' => true ]
['readOnlyHint' => false , 'destructiveHint' => false , 'idempotentHint' => false ]
['readOnlyHint' => false , 'destructiveHint' => true , 'idempotentHint' => true ]
['readOnlyHint' => false , 'destructiveHint' => false , 'idempotentHint' => true ]
Response Format All MCP tools MUST return this format:
[
'content' => [
['type' => 'text' , 'text' => 'Human-readable result or JSON data' ],
],
'isError' => false ,
]
[
'content' => [
['type' => 'text' , 'text' => 'Error: description of what went wrong' ],
],
'isError' => true ,
]
For structured data, return JSON in the text field:
return [
'content' => [
['type' => 'text' , 'text' => json_encode ([
'success' => true ,
'items' => $items ,
'total' => count ($items ),
], JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE)],
],
'isError' => false ,
];
MCP Hooks Hook Type Arguments Description mcp.tools_listfilter array $toolsRegister new tools mcp.handle_toolfilter mixed $result, string $toolName, array $paramsHandle tool calls mcp.tool_responsefilter array $response, string $toolNameModify responses before sending mcp.tool_calledaction string $toolName, array $paramsAudit: tool was called
Core MCP Tools Catalog (60+)
Pages
klytos_create_page — Create new page/custom post type entryklytos_update_page — Update existing pageklytos_delete_page — Delete page by slugklytos_get_page — Get page by slugklytos_list_pages — List pages with filters
Site Configuration
klytos_get_site_config — Get global configklytos_set_site_config — Update global config
Theme
klytos_get_theme — Get theme configurationklytos_set_theme — Update full themeklytos_set_colors — Update color paletteklytos_set_fonts — Update fontsklytos_set_layout — Update layout settings
Users
klytos_list_users — List usersklytos_create_user — Create userklytos_update_user — Update userklytos_reset_user_password — Reset passwordklytos_force_logout_user — Force logout
Custom Post Types
klytos_create_post_type — Create post typeklytos_update_post_type — Update post typeklytos_delete_post_type — Delete post typeklytos_get_post_type / klytos_list_post_typesklytos_add_taxonomy / klytos_update_taxonomy / klytos_delete_taxonomyklytos_add_term / klytos_update_term / klytos_delete_term / klytos_list_terms
Custom Fields
klytos_get_field_types — List 27 field typesklytos_add_custom_field / klytos_update_custom_field / klytos_remove_custom_fieldklytos_set_bulk_field_values — Set values on entries
Menus
klytos_get_menu / klytos_set_menuklytos_add_menu_item / klytos_remove_menu_item
Templates
klytos_create_page_template / klytos_get_page_template / klytos_list_page_templatesklytos_add_block_to_template / klytos_remove_block_from_template
Blocks
klytos_create_block / klytos_update_block / klytos_get_block / klytos_list_blocks / klytos_delete_block
Assets
klytos_upload_asset / klytos_list_assets / klytos_delete_asset
Build
klytos_build_site — Build entire static siteklytos_build_page — Build single pageklytos_preview_page — Live previewklytos_get_build_status
Scheduler
klytos_schedule_single_action / klytos_schedule_recurring_actionklytos_cancel_scheduled_action / klytos_list_scheduled_actions / klytos_get_scheduler_status
Webhooks
klytos_create_webhook / klytos_list_webhooks / klytos_delete_webhookklytos_list_webhook_events / klytos_test_webhook
Consent Manager
klytos_get_consent_config / klytos_set_consent_config — Read/update consent configurationklytos_list_consent_declarations / klytos_add_consent_declaration / klytos_delete_consent_declaration — Manage plugin cookie/script declarationsklytos_get_consent_audit — Full audit report grouped by category
Version History
klytos_list_versions / klytos_get_version / klytos_restore_version / klytos_diff_versions
Plugins
klytos_list_plugins / klytos_activate_plugin / klytos_deactivate_plugin
Analytics
klytos_get_analytics / klytos_get_top_pages
Tasks
klytos_list_tasks / klytos_get_task / klytos_create_task / klytos_update_task / klytos_complete_task
AI
klytos_generate_image / klytos_list_ai_imagesklytos_ai_get_config / klytos_ai_list_providers / klytos_ai_get_usage
Guides
klytos_list_guides / klytos_get_guide
Complete Plugin Example with MCP <?php
declare (strict_types=1 );
klytos_add_filter ('mcp.tools_list' , function (array $tools ): array {
$tools [] = [
'name' => 'analytics_export_generate' ,
'description' => 'Generate an analytics export for a date range. Returns CSV data.' ,
'inputSchema' => [
'type' => 'object' ,
'properties' => [
'start_date' => ['type' => 'string' , 'description' => 'Start date (YYYY-MM-DD)' ],
'end_date' => ['type' => 'string' , 'description' => 'End date (YYYY-MM-DD)' ],
'format' => ['type' => 'string' , 'enum' => ['csv' , 'json' ], 'description' => 'Export format' ],
],
'required' => ['start_date' , 'end_date' ],
],
'annotations' => ['readOnlyHint' => true , 'title' => 'Export Analytics' ],
];
return $tools ;
});
klytos_add_filter ('mcp.handle_tool' , function (mixed $result , string $name , array $params ): mixed {
if ($name !== 'analytics_export_generate' ) return $result ;
$startDate = klytos_sanitize_text ($params ['start_date' ] ?? '' );
$endDate = klytos_sanitize_text ($params ['end_date' ] ?? '' );
$format = $params ['format' ] ?? 'json' ;
$analytics = klytos_app ()->getAnalyticsManager ();
$data = $analytics ->getRange ($startDate , $endDate );
if ($format === 'csv' ) {
$csv = "date,page,views\n" ;
foreach ($data as $row ) {
$csv .= "{$row['date']} ,{$row['page']} ,{$row['views']} \n" ;
}
return ['content' => [['type' => 'text' , 'text' => $csv ]], 'isError' => false ];
}
return [
'content' => [['type' => 'text' , 'text' => json_encode ($data , JSON_PRETTY_PRINT)]],
'isError' => false ,
];
}, 10 );
klytos_add_filter ('admin.sidebar_items' , function (array $items ): array {
$items [] = [
'id' => 'analytics-export' ,
'title' => 'Export Analytics' ,
'url' => klytos_admin_url ('plugins/analytics-export/admin/export.php' ),
'icon' => 'fa-solid fa-file-export' ,
'position' => 61 ,
'section' => 'system' ,
'capability' => 'analytics.view' ,
];
return $items ;
});
Security Checklist for MCP Tools
Source Files
Tool registry: core/mcp/tool-registry.php
MCP server: core/mcp/server.php
JSON-RPC parser: core/mcp/json-rpc.php
Auth for MCP: core/mcp/token-auth.php
Rate limiter: core/mcp/rate-limiter.php
All tool definitions: core/mcp/tools/ (21 files)
