1: <?php
2:
3: declare(strict_types=1);
4:
5: /**
6: * This file is part of the Nexus MCP SDK package.
7: *
8: * (c) 2026 John Paul E. Balandan, CPA <paulbalandan@gmail.com>
9: *
10: * For the full copyright and license information, please view
11: * the LICENSE file that was distributed with this source code.
12: */
13:
14: namespace Nexus\Mcp\Server\Attribute;
15:
16: use Nexus\Mcp\Core\Schema\Icon;
17: use Nexus\Mcp\Core\Schema\Tool\ToolAnnotations;
18: use Nexus\Mcp\Core\Schema\Tool\ToolExecution;
19:
20: /**
21: * Marks a method as an MCP tool, registered through `ServerBuilder::register()`.
22: */
23: #[\Attribute(\Attribute::TARGET_METHOD)]
24: final readonly class AsTool
25: {
26: /**
27: * @param null|list<Icon> $icons
28: * @param null|array<string, mixed> $outputSchema
29: * @param null|array<string, mixed> $meta
30: */
31: public function __construct(
32: public ?string $name = null,
33: public ?string $title = null,
34: public ?string $description = null,
35: public ?ToolAnnotations $annotations = null,
36: public ?ToolExecution $execution = null,
37: public ?array $icons = null,
38: public ?array $outputSchema = null,
39: public ?array $meta = null,
40: ) {
41: }
42: }
43: