[Mate] Add mcp:tools:call command for tool execution via JSON input

[wachterjohannes]

Q	A
Bug fix?	no
New feature?	yes
Docs?	no
Issues	N/A
License	MIT

Summary

This PR adds a new mcp:tools:call command that enables executing MCP tools directly from the command line with JSON input parameters. This complements the existing mcp:tools:list and mcp:tools:inspect commands, providing a complete CLI workflow for tool discovery, inspection, and execution.

Features

• Execute MCP tools with JSON parameter input
• Automatic JSON schema validation against tool input schemas
• Two output formats:
  • Pretty format (default): Human-readable output with clear headers, descriptions, and formatted results
  • JSON format: Machine-parseable output for scripting and automation
• Validate-only mode for testing parameters without execution
• Comprehensive error handling for invalid tools, malformed JSON, and schema validation failures
• Clear execution headers showing tool name, description, and extension

Usage Examples

Execute tool with parameters

$ vendor/bin/mate mcp:tools:call monolog-search '{"term": "about"}'

Executing Tool: monolog-search
==============================

 Search log entries by text term with optional level, channel, environment, and date filters
 Extension: symfony/ai-monolog-mate-extension

Result
------

 {"datetime":"2026-01-16T18:28:19+00:00","channel":"console","level":"CRITICAL","message":"Error thrown while running command \"about --profiler\". Message: \"The \"--profiler\" option does not exist.\"","context":{...},"source_file":"dev.log","line_number":21}
 {"datetime":"2026-01-16T18:28:19+00:00","channel":"console","level":"DEBUG","message":"Command \"about --profiler\" exited with code \"1\"","context":{...},"source_file":"dev.log","line_number":22}

Execute tool with empty parameters

$ vendor/bin/mate mcp:tools:call php-version "{}"

Executing Tool: php-version
===========================

 Get the version of PHP
 Extension: symfony/ai-mate

Result
------

 8.4.15

JSON output format

$ vendor/bin/mate mcp:tools:call php-version '{}' --format=json
"8.4.15"
``

### Validate parameters without execution

```bash
$ vendor/bin/mate mcp:tools:call monolog-search '{"term": "test"}' --validate-only

 [OK] Validation successful

Implementation Details

• Reuses the same capability collection system as mcp:tools:list and mcp:tools:inspect
• Validates JSON input against tool input schemas (required fields and type checking)
• Properly handles schema default values for optional parameters
• Resolves tool handlers from the Symfony DI container
• Supports both ClassName::method and ClassName (for __invoke) handler formats
• Includes comprehensive test coverage (5 test cases)

[wachterjohannes]

this is currently needed to run the newest versions of mate (requires 0.3)

[chr-hertel]

if this is only for development, i would rather not add this

it get's split into https://github.com/symfony/ai-demo as well - which currently only runs on ^0.2 versions of mate - so that issue is not relevant there i guess

[chr-hertel]

unrelated - please revert here

[chr-hertel]

that custom isAssociativeArray is similar but inverted to array_is_list?

Suggested change

	if ($this->isAssociativeArray($result)) {
	$io->definitionList(...array_map(fn ($key, $value) => [$key => $this->formatValue($value)], array_keys($result), $result));
	} else {
	foreach ($result as $item) {
	$io->text($this->formatValue($item));
	}
	}
	if (array_is_list($result)) {
	foreach ($result as $item) {
	$io->text($this->formatValue($item));
	}
	} else {
	$io->definitionList(...array_map(fn ($key, $value) => [$key => $this->formatValue($value)], array_keys($result), $result));
	}

[chr-hertel]

Not sure about this - from a theory point of view. You're skipping almost the entire SDK infrastructure and features for tools - which raises a couple of issues for tools that:

• rely on RequestContext as argument
• interact with the client-side for sampling or elicitations

I would recommend to go through the entire stack there.