aimeos/ai-admin-mcp

Framework-neutral MCP tools for Aimeos administration

dev-master 2026-07-18 10:58 UTC

Requires

• php: ^8.2
• aimeos/aimeos-core: dev-master
• aimeos/prisma: dev-master
• nyholm/psr7: ~1.2

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ~10.0||~11.0||~12.0

LGPL-3.0-or-later

• admin
• ai
• aimeos
• mcp

Published on Packagist.org on 2026-07-18 11:00 UTC

README

aimeos/ai-admin-mcp provides framework-neutral administrative tools for Aimeos. Each tool is bound to an Aimeos context, validates model-supplied arguments with aimeos/prisma, checks Aimeos permissions and returns structured PHP arrays.

The package contains no MCP transport, MCP SDK or framework integration. Consumers obtain the enabled tools from the catalog and adapt them to their server runtime:

$tools = \Aimeos\Admin\Mcp\Tools::create( $context );

foreach( $tools as $tool ) {
	$definition = [
		'name' => $tool->name(),
		'description' => $tool->description(),
		'inputSchema' => $tool->schema()->toArray(),
		'annotations' => $tool->annotations(),
	];
	$result = $tool->execute( $arguments );
}

Tool names use lower-case words separated by hyphens, for example product-search, catalog-tree and locale-language-save.

The built-in catalog covers AI, attribute, catalog, coupon and coupon code, customer, group, index, locale, language, currency, site, media, order, plugin, price, product, review, rule, service, stock, subscription, supplier and text. Depending on the domain, tools provide get, find, search, aggregate, save, delete, provider configuration and tree operations.

Set admin/mcp/tools to a list of tool class names to replace the built-in catalog. Permissions are configured below admin/mcp/resource; rejected arguments and authorization failures are reported as Aimeos\Admin\Mcp\Exception instances.