Enhance documentation consistency and Tool class annotations (#57)

* use nowdoc for instructions and fix changelog URLs

  - Convert Server instructions to nowdoc format for better LLM-friendly documentation
  - Fix CHANGELOG.md URLs from package-template to mcp repository

* Add missing @return docblock for Tool::toArray() method

  Adds missing @return docblock to the toArray() method in the Tool class
  to maintain consistency with other methods in the codebase and match
  the parent class interface.

* Improve Tool::toArray() return type annotation

Author: mrayjam

CHANGELOG.md

@@ -1,8 +1,8 @@
 # Release Notes
 
-## [Unreleased](https://github.com/laravel/package-template/compare/v0.2.0...main)
+## [Unreleased](https://github.com/laravel/mcp/compare/v0.2.0...main)
 
-## [v0.2.0](https://github.com/laravel/package-template/compare/v0.1.0...v0.2.0) - 2025-09-18
+## [v0.2.0](https://github.com/laravel/mcp/compare/v0.1.0...v0.2.0) - 2025-09-18
 
 - First official "beta" release of Laravel MCP package.
 

src/Server.php

@@ -37,7 +37,9 @@ abstract class Server
 
     protected string $version = '0.0.1';
 
-    protected string $instructions = 'This MCP server lets AI agents interact with our Laravel application.';
+    protected string $instructions = <<<'MARKDOWN'
+        This MCP server lets AI agents interact with our Laravel application.
+    MARKDOWN;
 
     /**
      * @var array<int, string>

src/Server/Tool.php

@@ -42,6 +42,17 @@ public function toMethodCall(): array
         return ['name' => $this->name()];
     }
 
+    /**
+     * Get the tool's array representation.
+     *
+     * @return array{
+     *     name: string,
+     *     title?: string|null,
+     *     description?: string|null,
+     *     inputSchema?: array<string, mixed>,
+     *     annotations?: array<string, mixed>|object
+     * }
+     */
     public function toArray(): array
     {
         $annotations = $this->annotations();