feat: Add MCP tool to assign a Mantis issue to the current user

Co-Authored-By: Claude Opus 4.8 <[email protected]>

Author: marcreichel

src/Service/MantisConnector.php

@@ -278,6 +278,31 @@ final public function patchUpstreamField(MantisIssue $issue): bool
         }
     }
 
+    /**
+     * @throws JsonException
+     */
+    final public function assignIssue(int $issueId, int $handlerId): bool
+    {
+        $body = json_encode([
+            'handler' => [
+                'id' => $handlerId,
+            ],
+        ], JSON_THROW_ON_ERROR);
+
+        try {
+            $this->client->patch(
+                'issues/' . $issueId,
+                [
+                    'body' => $body,
+                ],
+            );
+
+            return true;
+        } catch (Exception | GuzzleException) {
+            return false;
+        }
+    }
+
     /**
      * @param array{
      *     id: int,

src/Service/Mcp/AssignIssueToMeTool.php

@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Artemeon\M2G\Service\Mcp;
+
+use Artemeon\M2G\Helper\IssueIdParser;
+use Artemeon\M2G\Service\MantisConnector;
+use HelgeSverre\Toon\Toon;
+use InvalidArgumentException;
+use Mcp\Schema\Content\TextContent;
+use Mcp\Schema\Result\CallToolResult;
+use Mcp\Schema\Tool;
+use Mcp\Schema\ToolAnnotations;
+use Mcp\Server\ClientGateway;
+
+class AssignIssueToMeTool implements McpTool
+{
+    public const NAME = 'mantis-assign-issue-to-me';
+
+    public function __construct(private readonly MantisConnector $mantisConnector)
+    {
+    }
+
+    public function getDefinition(): Tool
+    {
+        return new Tool(
+            name: self::NAME,
+            title: 'Assign Mantis Issue To Me',
+            inputSchema: [
+                'type' => 'object',
+                'properties' => [
+                    'id' => [
+                        'type' => 'integer',
+                        'description' => 'The numeric Mantis issue ID.',
+                        'minimum' => 1,
+                    ],
+                    'url' => [
+                        'type' => 'string',
+                        'description' => 'A Mantis issue URL (e.g. https://mantis.example.com/view.php?id=12345). The numeric id is extracted from the ?id= query parameter.',
+                    ],
+                ],
+                'required' => [],
+            ],
+            description: 'Assign a Mantis ticket (by ID or URL) to the current user (the owner of the configured API token).',
+            annotations: new ToolAnnotations(
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            ),
+        );
+    }
+
+    public function execute(array $arguments, ClientGateway $gateway): CallToolResult
+    {
+        /** @var int|string|null $id */
+        $id = $arguments['id'] ?? null;
+        /** @var string|null $url */
+        $url = $arguments['url'] ?? null;
+
+        try {
+            $issueId = IssueIdParser::parse($id, $url);
+        } catch (InvalidArgumentException $e) {
+            return CallToolResult::error([new TextContent($e->getMessage())]);
+        }
+
+        $user = $this->mantisConnector->fetchCurrentUser();
+        if ($user === null) {
+            return CallToolResult::error([
+                new TextContent('Unable to determine the current Mantis user.'),
+            ]);
+        }
+
+        if (!$this->mantisConnector->assignIssue($issueId, $user->id)) {
+            return CallToolResult::error([
+                new TextContent(sprintf('Failed to assign Mantis issue %d to %s.', $issueId, $user->realName ?? $user->name)),
+            ]);
+        }
+
+        $payload = [
+            'issue_id' => $issueId,
+            'assigned_to' => $user->realName ?? $user->name,
+        ];
+
+        return CallToolResult::success([new TextContent(Toon::encode($payload))]);
+    }
+}

src/Service/McpServer.php

@@ -4,6 +4,7 @@
 
 namespace Artemeon\M2G\Service;
 
+use Artemeon\M2G\Service\Mcp\AssignIssueToMeTool;
 use Artemeon\M2G\Service\Mcp\AttachmentTool;
 use Artemeon\M2G\Service\Mcp\CurrentUserResource;
 use Artemeon\M2G\Service\Mcp\IssueAttachmentsTool;
@@ -57,6 +58,7 @@ private function tools(): array
             new UnassignedIssuesTool($this->mantisConnector),
             new SyncToGithubTool($this->issueSyncService),
             new AttachmentTool($this->mantisConnector),
+            new AssignIssueToMeTool($this->mantisConnector),
         ];
     }