+ */
+ protected function getMissingDependencies(array $context = [], array $args = []): array
+ {
+ $sessionId = $context['session_id'] ?? 'anonymous';
+
+ return app(ToolDependencyService::class)->getMissingDependencies(
+ sessionId: $sessionId,
+ toolName: $this->name(),
+ context: $context,
+ args: $args,
+ );
+ }
+
+ /**
+ * Record this tool call for dependency tracking.
+ *
+ * @param array $context The execution context
+ * @param array $args The tool arguments
+ */
+ protected function recordToolCall(array $context = [], array $args = []): void
+ {
+ $sessionId = $context['session_id'] ?? 'anonymous';
+
+ app(ToolDependencyService::class)->recordToolCall(
+ sessionId: $sessionId,
+ toolName: $this->name(),
+ args: $args,
+ );
+ }
+
+ /**
+ * Create a dependency error response.
+ */
+ protected function dependencyError(MissingDependencyException $e): array
+ {
+ return [
+ 'error' => 'dependency_not_met',
+ 'message' => $e->getMessage(),
+ 'missing' => array_map(
+ fn (ToolDependency $dep) => [
+ 'type' => $dep->type->value,
+ 'key' => $dep->key,
+ 'description' => $dep->description,
+ ],
+ $e->missingDependencies
+ ),
+ 'suggested_order' => $e->suggestedOrder,
+ ];
+ }
+}
diff --git a/src/php/src/Mcp/Tools/ContentTools.php b/src/php/src/Mcp/Tools/ContentTools.php
new file mode 100644
index 0000000..1ae32f5
--- /dev/null
+++ b/src/php/src/Mcp/Tools/ContentTools.php
@@ -0,0 +1,633 @@
+get('action');
+ $workspaceSlug = $request->get('workspace');
+
+ // Resolve workspace
+ $workspace = $this->resolveWorkspace($workspaceSlug);
+ if (! $workspace && in_array($action, ['list', 'read', 'create', 'update', 'delete'])) {
+ return Response::text(json_encode([
+ 'error' => 'Workspace is required. Provide a workspace slug.',
+ ]));
+ }
+
+ return match ($action) {
+ 'list' => $this->listContent($workspace, $request),
+ 'read' => $this->readContent($workspace, $request),
+ 'create' => $this->createContent($workspace, $request),
+ 'update' => $this->updateContent($workspace, $request),
+ 'delete' => $this->deleteContent($workspace, $request),
+ 'taxonomies' => $this->listTaxonomies($workspace, $request),
+ default => Response::text(json_encode([
+ 'error' => 'Invalid action. Available: list, read, create, update, delete, taxonomies',
+ ])),
+ };
+ }
+
+ /**
+ * Resolve workspace from slug.
+ */
+ protected function resolveWorkspace(?string $slug): ?Workspace
+ {
+ if (! $slug) {
+ return null;
+ }
+
+ return Workspace::where('slug', $slug)
+ ->orWhere('id', $slug)
+ ->first();
+ }
+
+ /**
+ * Check entitlements for content operations.
+ */
+ protected function checkEntitlement(Workspace $workspace, string $action): ?array
+ {
+ $entitlements = app(EntitlementService::class);
+
+ // Check if workspace has content MCP access
+ $result = $entitlements->can($workspace, 'content.mcp_access');
+
+ if ($result->isDenied()) {
+ return ['error' => $result->reason ?? 'Content MCP access not available in your plan.'];
+ }
+
+ // For create operations, check content limits
+ if ($action === 'create') {
+ $limitResult = $entitlements->can($workspace, 'content.items');
+ if ($limitResult->isDenied()) {
+ return ['error' => $limitResult->reason ?? 'Content item limit reached.'];
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * List content items for a workspace.
+ */
+ protected function listContent(Workspace $workspace, Request $request): Response
+ {
+ $query = ContentItem::forWorkspace($workspace->id)
+ ->native()
+ ->with(['author', 'taxonomies']);
+
+ // Filter by type (post/page)
+ if ($type = $request->get('type')) {
+ $query->where('type', $type);
+ }
+
+ // Filter by status
+ if ($status = $request->get('status')) {
+ if ($status === 'published') {
+ $query->published();
+ } elseif ($status === 'scheduled') {
+ $query->scheduled();
+ } else {
+ $query->where('status', $status);
+ }
+ }
+
+ // Search
+ if ($search = $request->get('search')) {
+ $query->where(function ($q) use ($search) {
+ $q->where('title', 'like', "%{$search}%")
+ ->orWhere('content_html', 'like', "%{$search}%")
+ ->orWhere('excerpt', 'like', "%{$search}%");
+ });
+ }
+
+ // Pagination
+ $limit = min($request->get('limit', 20), 100);
+ $offset = $request->get('offset', 0);
+
+ $total = $query->count();
+ $items = $query->orderByDesc('updated_at')
+ ->skip($offset)
+ ->take($limit)
+ ->get();
+
+ $result = [
+ 'items' => $items->map(fn (ContentItem $item) => [
+ 'id' => $item->id,
+ 'slug' => $item->slug,
+ 'title' => $item->title,
+ 'type' => $item->type,
+ 'status' => $item->status,
+ 'excerpt' => Str::limit($item->excerpt, 200),
+ 'author' => $item->author?->name,
+ 'categories' => $item->categories->pluck('name')->all(),
+ 'tags' => $item->tags->pluck('name')->all(),
+ 'word_count' => str_word_count(strip_tags($item->content_html ?? '')),
+ 'publish_at' => $item->publish_at?->toIso8601String(),
+ 'created_at' => $item->created_at->toIso8601String(),
+ 'updated_at' => $item->updated_at->toIso8601String(),
+ ]),
+ 'total' => $total,
+ 'limit' => $limit,
+ 'offset' => $offset,
+ ];
+
+ return Response::text(json_encode($result, JSON_PRETTY_PRINT));
+ }
+
+ /**
+ * Read full content of an item.
+ */
+ protected function readContent(Workspace $workspace, Request $request): Response
+ {
+ $identifier = $request->get('identifier');
+
+ if (! $identifier) {
+ return Response::text(json_encode(['error' => 'identifier (slug or ID) is required']));
+ }
+
+ $query = ContentItem::forWorkspace($workspace->id)->native();
+
+ // Find by ID, slug, or wp_id
+ if (is_numeric($identifier)) {
+ $item = $query->where('id', $identifier)
+ ->orWhere('wp_id', $identifier)
+ ->first();
+ } else {
+ $item = $query->where('slug', $identifier)->first();
+ }
+
+ if (! $item) {
+ return Response::text(json_encode(['error' => 'Content not found']));
+ }
+
+ // Load relationships
+ $item->load(['author', 'taxonomies', 'revisions' => fn ($q) => $q->latest()->limit(5)]);
+
+ // Return as markdown with frontmatter for AI context
+ $format = $request->get('format', 'json');
+
+ if ($format === 'markdown') {
+ $markdown = $this->contentToMarkdown($item);
+
+ return Response::text($markdown);
+ }
+
+ $result = [
+ 'id' => $item->id,
+ 'slug' => $item->slug,
+ 'title' => $item->title,
+ 'type' => $item->type,
+ 'status' => $item->status,
+ 'excerpt' => $item->excerpt,
+ 'content_html' => $item->content_html,
+ 'content_markdown' => $item->content_markdown,
+ 'author' => [
+ 'id' => $item->author?->id,
+ 'name' => $item->author?->name,
+ ],
+ 'categories' => $item->categories->map(fn ($t) => [
+ 'id' => $t->id,
+ 'slug' => $t->slug,
+ 'name' => $t->name,
+ ])->all(),
+ 'tags' => $item->tags->map(fn ($t) => [
+ 'id' => $t->id,
+ 'slug' => $t->slug,
+ 'name' => $t->name,
+ ])->all(),
+ 'seo_meta' => $item->seo_meta,
+ 'publish_at' => $item->publish_at?->toIso8601String(),
+ 'revision_count' => $item->revision_count,
+ 'recent_revisions' => $item->revisions->map(fn ($r) => [
+ 'id' => $r->id,
+ 'revision_number' => $r->revision_number,
+ 'change_type' => $r->change_type,
+ 'created_at' => $r->created_at->toIso8601String(),
+ ])->all(),
+ 'created_at' => $item->created_at->toIso8601String(),
+ 'updated_at' => $item->updated_at->toIso8601String(),
+ ];
+
+ return Response::text(json_encode($result, JSON_PRETTY_PRINT));
+ }
+
+ /**
+ * Create new content.
+ */
+ protected function createContent(Workspace $workspace, Request $request): Response
+ {
+ // Check entitlements
+ $entitlementError = $this->checkEntitlement($workspace, 'create');
+ if ($entitlementError) {
+ return Response::text(json_encode($entitlementError));
+ }
+
+ // Validate required fields
+ $title = $request->get('title');
+ if (! $title) {
+ return Response::text(json_encode(['error' => 'title is required']));
+ }
+
+ $type = $request->get('type', 'post');
+ if (! in_array($type, ['post', 'page'])) {
+ return Response::text(json_encode(['error' => 'type must be post or page']));
+ }
+
+ $status = $request->get('status', 'draft');
+ if (! in_array($status, ['draft', 'publish', 'future', 'private'])) {
+ return Response::text(json_encode(['error' => 'status must be draft, publish, future, or private']));
+ }
+
+ // Generate slug
+ $slug = $request->get('slug') ?: Str::slug($title);
+ $baseSlug = $slug;
+ $counter = 1;
+
+ // Ensure unique slug within workspace
+ while (ContentItem::forWorkspace($workspace->id)->where('slug', $slug)->exists()) {
+ $slug = $baseSlug.'-'.$counter++;
+ }
+
+ // Parse markdown content if provided
+ $content = $request->get('content', '');
+ $contentHtml = $request->get('content_html');
+ $contentMarkdown = $request->get('content_markdown', $content);
+
+ // Convert markdown to HTML if only markdown provided
+ if ($contentMarkdown && ! $contentHtml) {
+ $contentHtml = Str::markdown($contentMarkdown);
+ }
+
+ // Handle scheduling
+ $publishAt = null;
+ if ($status === 'future') {
+ $publishAt = $request->get('publish_at');
+ if (! $publishAt) {
+ return Response::text(json_encode(['error' => 'publish_at is required for scheduled content']));
+ }
+ $publishAt = \Carbon\Carbon::parse($publishAt);
+ }
+
+ // Create content item
+ $item = ContentItem::create([
+ 'workspace_id' => $workspace->id,
+ 'content_type' => ContentType::NATIVE,
+ 'type' => $type,
+ 'status' => $status,
+ 'slug' => $slug,
+ 'title' => $title,
+ 'excerpt' => $request->get('excerpt'),
+ 'content_html' => $contentHtml,
+ 'content_markdown' => $contentMarkdown,
+ 'seo_meta' => $request->get('seo_meta'),
+ 'publish_at' => $publishAt,
+ 'last_edited_by' => Auth::id(),
+ ]);
+
+ // Handle categories
+ if ($categories = $request->get('categories')) {
+ $categoryIds = $this->resolveOrCreateTaxonomies($workspace, $categories, 'category');
+ $item->taxonomies()->attach($categoryIds);
+ }
+
+ // Handle tags
+ if ($tags = $request->get('tags')) {
+ $tagIds = $this->resolveOrCreateTaxonomies($workspace, $tags, 'tag');
+ $item->taxonomies()->attach($tagIds);
+ }
+
+ // Create initial revision
+ $item->createRevision(Auth::user(), ContentRevision::CHANGE_EDIT, 'Created via MCP');
+
+ // Record usage
+ $entitlements = app(EntitlementService::class);
+ $entitlements->recordUsage($workspace, 'content.items', 1, Auth::user(), [
+ 'source' => 'mcp',
+ 'content_id' => $item->id,
+ ]);
+
+ return Response::text(json_encode([
+ 'ok' => true,
+ 'item' => [
+ 'id' => $item->id,
+ 'slug' => $item->slug,
+ 'title' => $item->title,
+ 'type' => $item->type,
+ 'status' => $item->status,
+ 'url' => $this->getContentUrl($workspace, $item),
+ ],
+ ], JSON_PRETTY_PRINT));
+ }
+
+ /**
+ * Update existing content.
+ */
+ protected function updateContent(Workspace $workspace, Request $request): Response
+ {
+ $identifier = $request->get('identifier');
+
+ if (! $identifier) {
+ return Response::text(json_encode(['error' => 'identifier (slug or ID) is required']));
+ }
+
+ $query = ContentItem::forWorkspace($workspace->id)->native();
+
+ if (is_numeric($identifier)) {
+ $item = $query->find($identifier);
+ } else {
+ $item = $query->where('slug', $identifier)->first();
+ }
+
+ if (! $item) {
+ return Response::text(json_encode(['error' => 'Content not found']));
+ }
+
+ // Build update data
+ $updateData = [];
+
+ if ($request->has('title')) {
+ $updateData['title'] = $request->get('title');
+ }
+
+ if ($request->has('excerpt')) {
+ $updateData['excerpt'] = $request->get('excerpt');
+ }
+
+ if ($request->has('content') || $request->has('content_markdown')) {
+ $contentMarkdown = $request->get('content_markdown') ?? $request->get('content');
+ $updateData['content_markdown'] = $contentMarkdown;
+ $updateData['content_html'] = $request->get('content_html') ?? Str::markdown($contentMarkdown);
+ }
+
+ if ($request->has('content_html') && ! $request->has('content_markdown')) {
+ $updateData['content_html'] = $request->get('content_html');
+ }
+
+ if ($request->has('status')) {
+ $status = $request->get('status');
+ if (! in_array($status, ['draft', 'publish', 'future', 'private'])) {
+ return Response::text(json_encode(['error' => 'status must be draft, publish, future, or private']));
+ }
+ $updateData['status'] = $status;
+
+ if ($status === 'future' && $request->has('publish_at')) {
+ $updateData['publish_at'] = \Carbon\Carbon::parse($request->get('publish_at'));
+ }
+ }
+
+ if ($request->has('seo_meta')) {
+ $updateData['seo_meta'] = $request->get('seo_meta');
+ }
+
+ if ($request->has('slug')) {
+ $newSlug = $request->get('slug');
+ if ($newSlug !== $item->slug) {
+ // Check uniqueness
+ if (ContentItem::forWorkspace($workspace->id)->where('slug', $newSlug)->where('id', '!=', $item->id)->exists()) {
+ return Response::text(json_encode(['error' => 'Slug already exists']));
+ }
+ $updateData['slug'] = $newSlug;
+ }
+ }
+
+ $updateData['last_edited_by'] = Auth::id();
+
+ // Update item
+ $item->update($updateData);
+
+ // Handle categories
+ if ($request->has('categories')) {
+ $categoryIds = $this->resolveOrCreateTaxonomies($workspace, $request->get('categories'), 'category');
+ $item->categories()->sync($categoryIds);
+ }
+
+ // Handle tags
+ if ($request->has('tags')) {
+ $tagIds = $this->resolveOrCreateTaxonomies($workspace, $request->get('tags'), 'tag');
+ $item->tags()->sync($tagIds);
+ }
+
+ // Create revision
+ $changeSummary = $request->get('change_summary', 'Updated via MCP');
+ $item->createRevision(Auth::user(), ContentRevision::CHANGE_EDIT, $changeSummary);
+
+ $item->refresh()->load(['author', 'taxonomies']);
+
+ return Response::text(json_encode([
+ 'ok' => true,
+ 'item' => [
+ 'id' => $item->id,
+ 'slug' => $item->slug,
+ 'title' => $item->title,
+ 'type' => $item->type,
+ 'status' => $item->status,
+ 'revision_count' => $item->revision_count,
+ 'url' => $this->getContentUrl($workspace, $item),
+ ],
+ ], JSON_PRETTY_PRINT));
+ }
+
+ /**
+ * Delete content (soft delete).
+ */
+ protected function deleteContent(Workspace $workspace, Request $request): Response
+ {
+ $identifier = $request->get('identifier');
+
+ if (! $identifier) {
+ return Response::text(json_encode(['error' => 'identifier (slug or ID) is required']));
+ }
+
+ $query = ContentItem::forWorkspace($workspace->id)->native();
+
+ if (is_numeric($identifier)) {
+ $item = $query->find($identifier);
+ } else {
+ $item = $query->where('slug', $identifier)->first();
+ }
+
+ if (! $item) {
+ return Response::text(json_encode(['error' => 'Content not found']));
+ }
+
+ // Create final revision before delete
+ $item->createRevision(Auth::user(), ContentRevision::CHANGE_EDIT, 'Deleted via MCP');
+
+ // Soft delete
+ $item->delete();
+
+ return Response::text(json_encode([
+ 'ok' => true,
+ 'deleted' => [
+ 'id' => $item->id,
+ 'slug' => $item->slug,
+ 'title' => $item->title,
+ ],
+ ], JSON_PRETTY_PRINT));
+ }
+
+ /**
+ * List taxonomies (categories and tags).
+ */
+ protected function listTaxonomies(Workspace $workspace, Request $request): Response
+ {
+ $type = $request->get('type'); // category or tag
+
+ $query = ContentTaxonomy::where('workspace_id', $workspace->id);
+
+ if ($type) {
+ $query->where('type', $type);
+ }
+
+ $taxonomies = $query->orderBy('name')->get();
+
+ $result = [
+ 'taxonomies' => $taxonomies->map(fn ($t) => [
+ 'id' => $t->id,
+ 'type' => $t->type,
+ 'slug' => $t->slug,
+ 'name' => $t->name,
+ 'description' => $t->description,
+ ])->all(),
+ 'total' => $taxonomies->count(),
+ ];
+
+ return Response::text(json_encode($result, JSON_PRETTY_PRINT));
+ }
+
+ /**
+ * Resolve or create taxonomies from slugs/names.
+ */
+ protected function resolveOrCreateTaxonomies(Workspace $workspace, array $items, string $type): array
+ {
+ $ids = [];
+
+ foreach ($items as $item) {
+ $taxonomy = ContentTaxonomy::where('workspace_id', $workspace->id)
+ ->where('type', $type)
+ ->where(function ($q) use ($item) {
+ $q->where('slug', $item)
+ ->orWhere('name', $item);
+ })
+ ->first();
+
+ if (! $taxonomy) {
+ // Create new taxonomy
+ $taxonomy = ContentTaxonomy::create([
+ 'workspace_id' => $workspace->id,
+ 'type' => $type,
+ 'slug' => Str::slug($item),
+ 'name' => $item,
+ ]);
+ }
+
+ $ids[] = $taxonomy->id;
+ }
+
+ return $ids;
+ }
+
+ /**
+ * Convert content item to markdown with frontmatter.
+ */
+ protected function contentToMarkdown(ContentItem $item): string
+ {
+ $frontmatter = [
+ 'title' => $item->title,
+ 'slug' => $item->slug,
+ 'type' => $item->type,
+ 'status' => $item->status,
+ 'author' => $item->author?->name,
+ 'categories' => $item->categories->pluck('name')->all(),
+ 'tags' => $item->tags->pluck('name')->all(),
+ 'created_at' => $item->created_at->toIso8601String(),
+ 'updated_at' => $item->updated_at->toIso8601String(),
+ ];
+
+ if ($item->publish_at) {
+ $frontmatter['publish_at'] = $item->publish_at->toIso8601String();
+ }
+
+ if ($item->seo_meta) {
+ $frontmatter['seo'] = $item->seo_meta;
+ }
+
+ $yaml = "---\n";
+ foreach ($frontmatter as $key => $value) {
+ if (is_array($value)) {
+ $yaml .= "{$key}: ".json_encode($value)."\n";
+ } else {
+ $yaml .= "{$key}: {$value}\n";
+ }
+ }
+ $yaml .= "---\n\n";
+
+ // Prefer markdown content, fall back to stripping HTML
+ $content = $item->content_markdown ?? strip_tags($item->content_html ?? '');
+
+ return $yaml.$content;
+ }
+
+ /**
+ * Get the public URL for content.
+ */
+ protected function getContentUrl(Workspace $workspace, ContentItem $item): string
+ {
+ $domain = $workspace->domain ?? config('app.url');
+ $path = $item->type === 'post' ? "/blog/{$item->slug}" : "/{$item->slug}";
+
+ return "https://{$domain}{$path}";
+ }
+
+ public function schema(JsonSchema $schema): array
+ {
+ return [
+ 'action' => $schema->string('Action: list, read, create, update, delete, taxonomies'),
+ 'workspace' => $schema->string('Workspace slug (required for most actions)')->nullable(),
+ 'identifier' => $schema->string('Content slug or ID (for read, update, delete)')->nullable(),
+ 'type' => $schema->string('Content type: post or page (for list filter or create)')->nullable(),
+ 'status' => $schema->string('Content status: draft, publish, future, private')->nullable(),
+ 'search' => $schema->string('Search term for list action')->nullable(),
+ 'limit' => $schema->integer('Max items to return (default 20, max 100)')->nullable(),
+ 'offset' => $schema->integer('Offset for pagination')->nullable(),
+ 'format' => $schema->string('Output format: json or markdown (for read action)')->nullable(),
+ 'title' => $schema->string('Content title (for create/update)')->nullable(),
+ 'slug' => $schema->string('URL slug (for create/update)')->nullable(),
+ 'excerpt' => $schema->string('Content excerpt/summary')->nullable(),
+ 'content' => $schema->string('Content body as markdown (for create/update)')->nullable(),
+ 'content_html' => $schema->string('Content body as HTML (optional, auto-generated from markdown)')->nullable(),
+ 'content_markdown' => $schema->string('Content body as markdown (alias for content)')->nullable(),
+ 'categories' => $schema->array('Array of category slugs or names')->nullable(),
+ 'tags' => $schema->array('Array of tag strings')->nullable(),
+ 'seo_meta' => $schema->array('SEO metadata: {title, description, keywords}')->nullable(),
+ 'publish_at' => $schema->string('ISO datetime for scheduled publishing (status=future)')->nullable(),
+ 'change_summary' => $schema->string('Summary of changes for revision history (update action)')->nullable(),
+ ];
+ }
+}
diff --git a/src/php/src/Mcp/Tools/GetStats.php b/src/php/src/Mcp/Tools/GetStats.php
new file mode 100644
index 0000000..42ae06d
--- /dev/null
+++ b/src/php/src/Mcp/Tools/GetStats.php
@@ -0,0 +1,30 @@
+ 6,
+ 'active_users' => 128,
+ 'page_views_30d' => 12500,
+ 'server_load' => '23%',
+ ];
+
+ return Response::text(json_encode($stats, JSON_PRETTY_PRINT));
+ }
+
+ public function schema(JsonSchema $schema): array
+ {
+ return [];
+ }
+}
diff --git a/src/php/src/Mcp/Tools/ListRoutes.php b/src/php/src/Mcp/Tools/ListRoutes.php
new file mode 100644
index 0000000..7afa3ff
--- /dev/null
+++ b/src/php/src/Mcp/Tools/ListRoutes.php
@@ -0,0 +1,32 @@
+getRoutes())
+ ->map(fn ($route) => [
+ 'uri' => $route->uri(),
+ 'methods' => $route->methods(),
+ 'name' => $route->getName(),
+ ])
+ ->values()
+ ->toArray();
+
+ return Response::text(json_encode($routes, JSON_PRETTY_PRINT));
+ }
+
+ public function schema(JsonSchema $schema): array
+ {
+ return [];
+ }
+}
diff --git a/src/php/src/Mcp/Tools/ListSites.php b/src/php/src/Mcp/Tools/ListSites.php
new file mode 100644
index 0000000..bd4b627
--- /dev/null
+++ b/src/php/src/Mcp/Tools/ListSites.php
@@ -0,0 +1,32 @@
+ 'BioHost', 'domain' => 'link.host.uk.com', 'type' => 'WordPress'],
+ ['name' => 'SocialHost', 'domain' => 'social.host.uk.com', 'type' => 'Laravel'],
+ ['name' => 'AnalyticsHost', 'domain' => 'analytics.host.uk.com', 'type' => 'Node.js'],
+ ['name' => 'TrustHost', 'domain' => 'trust.host.uk.com', 'type' => 'WordPress'],
+ ['name' => 'NotifyHost', 'domain' => 'notify.host.uk.com', 'type' => 'Go'],
+ ['name' => 'MailHost', 'domain' => 'hostmail.cc', 'type' => 'MailCow'],
+ ];
+
+ return Response::text(json_encode($sites, JSON_PRETTY_PRINT));
+ }
+
+ public function schema(JsonSchema $schema): array
+ {
+ return [];
+ }
+}
diff --git a/src/php/src/Mcp/Tools/ListTables.php b/src/php/src/Mcp/Tools/ListTables.php
new file mode 100644
index 0000000..ce3accb
--- /dev/null
+++ b/src/php/src/Mcp/Tools/ListTables.php
@@ -0,0 +1,28 @@
+map(fn ($table) => array_values((array) $table)[0])
+ ->toArray();
+
+ return Response::text(json_encode($tables, JSON_PRETTY_PRINT));
+ }
+
+ public function schema(JsonSchema $schema): array
+ {
+ return [];
+ }
+}
diff --git a/src/php/src/Mcp/Tools/QueryDatabase.php b/src/php/src/Mcp/Tools/QueryDatabase.php
new file mode 100644
index 0000000..4a31144
--- /dev/null
+++ b/src/php/src/Mcp/Tools/QueryDatabase.php
@@ -0,0 +1,417 @@
+validator = $this->createValidator();
+ $this->auditService = $auditService ?? app(QueryAuditService::class);
+ $this->executionService = $executionService ?? app(QueryExecutionService::class);
+ }
+
+ public function handle(Request $request): Response
+ {
+ $query = $request->input('query');
+ $explain = $request->input('explain', false);
+
+ // Extract context from request for audit logging
+ $workspaceId = $this->getWorkspaceId($request);
+ $userId = $this->getUserId($request);
+ $userIp = $this->getUserIp($request);
+ $sessionId = $request->input('session_id');
+
+ if (empty($query)) {
+ return $this->errorResponse('Query is required');
+ }
+
+ // Validate the query - log blocked queries
+ try {
+ $this->validator->validate($query);
+ } catch (ForbiddenQueryException $e) {
+ $this->auditService->recordBlocked(
+ query: $query,
+ bindings: [],
+ reason: $e->reason,
+ workspaceId: $workspaceId,
+ userId: $userId,
+ userIp: $userIp,
+ context: ['session_id' => $sessionId]
+ );
+
+ return $this->errorResponse($e->getMessage());
+ }
+
+ // Check for blocked tables
+ $blockedTable = $this->checkBlockedTables($query);
+ if ($blockedTable !== null) {
+ $this->auditService->recordBlocked(
+ query: $query,
+ bindings: [],
+ reason: "Access to blocked table: {$blockedTable}",
+ workspaceId: $workspaceId,
+ userId: $userId,
+ userIp: $userIp,
+ context: ['session_id' => $sessionId, 'blocked_table' => $blockedTable]
+ );
+
+ return $this->errorResponse(
+ sprintf("Access to table '%s' is not permitted", $blockedTable)
+ );
+ }
+
+ try {
+ $connection = $this->getConnection();
+
+ // If explain is requested, run EXPLAIN first
+ if ($explain) {
+ return $this->handleExplain($connection, $query, $workspaceId, $userId, $userIp, $sessionId);
+ }
+
+ // Execute query with tier-based limits, timeout, and audit logging
+ $result = $this->executionService->execute(
+ query: $query,
+ connection: $connection,
+ workspaceId: $workspaceId,
+ userId: $userId,
+ userIp: $userIp,
+ context: [
+ 'session_id' => $sessionId,
+ 'explain_requested' => false,
+ ]
+ );
+
+ // Build response with data and metadata
+ $response = [
+ 'data' => $result['data'],
+ 'meta' => $result['meta'],
+ ];
+
+ // Add warning if results were truncated
+ if ($result['meta']['truncated']) {
+ $response['warning'] = $result['meta']['warning'];
+ }
+
+ return Response::text(json_encode($response, JSON_PRETTY_PRINT));
+ } catch (QueryTimeoutException $e) {
+ return $this->errorResponse(
+ 'Query timed out: '.$e->getMessage().
+ ' Consider adding more specific filters or indexes.'
+ );
+ } catch (\Exception $e) {
+ // Log the actual error for debugging but return sanitised message
+ report($e);
+
+ return $this->errorResponse('Query execution failed: '.$this->sanitiseErrorMessage($e->getMessage()));
+ }
+ }
+
+ public function schema(JsonSchema $schema): array
+ {
+ return [
+ 'query' => $schema->string('SQL SELECT query to execute. Only read-only SELECT queries are permitted.'),
+ 'explain' => $schema->boolean('If true, runs EXPLAIN on the query instead of executing it. Useful for query optimisation and debugging.')->default(false),
+ ];
+ }
+
+ /**
+ * Create the SQL validator with configuration.
+ */
+ private function createValidator(): SqlQueryValidator
+ {
+ $useWhitelist = Config::get('mcp.database.use_whitelist', true);
+ $customPatterns = Config::get('mcp.database.whitelist_patterns', []);
+
+ $validator = new SqlQueryValidator(null, $useWhitelist);
+
+ foreach ($customPatterns as $pattern) {
+ $validator->addWhitelistPattern($pattern);
+ }
+
+ return $validator;
+ }
+
+ /**
+ * Get the database connection to use.
+ *
+ * @throws \RuntimeException If the configured connection is invalid
+ */
+ private function getConnection(): ?string
+ {
+ $connection = Config::get('mcp.database.connection');
+
+ // If configured connection doesn't exist, throw exception
+ if ($connection && ! Config::has("database.connections.{$connection}")) {
+ throw new \RuntimeException(
+ "Invalid MCP database connection '{$connection}' configured. ".
+ "Please ensure 'database.connections.{$connection}' exists in your database configuration."
+ );
+ }
+
+ return $connection;
+ }
+
+ /**
+ * Check if the query references any blocked tables.
+ */
+ private function checkBlockedTables(string $query): ?string
+ {
+ $blockedTables = Config::get('mcp.database.blocked_tables', []);
+
+ foreach ($blockedTables as $table) {
+ // Check for table references in various formats
+ $patterns = [
+ '/\bFROM\s+`?'.preg_quote($table, '/').'`?\b/i',
+ '/\bJOIN\s+`?'.preg_quote($table, '/').'`?\b/i',
+ '/\b'.preg_quote($table, '/').'\./i', // table.column format
+ ];
+
+ foreach ($patterns as $pattern) {
+ if (preg_match($pattern, $query)) {
+ return $table;
+ }
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Extract workspace ID from request context.
+ */
+ private function getWorkspaceId(Request $request): ?int
+ {
+ // Try to get from request context or metadata
+ $workspaceId = $request->input('workspace_id');
+ if ($workspaceId !== null) {
+ return (int) $workspaceId;
+ }
+
+ // Try from auth context
+ if (function_exists('workspace') && workspace()) {
+ return workspace()->id;
+ }
+
+ return null;
+ }
+
+ /**
+ * Extract user ID from request context.
+ */
+ private function getUserId(Request $request): ?int
+ {
+ // Try to get from request context
+ $userId = $request->input('user_id');
+ if ($userId !== null) {
+ return (int) $userId;
+ }
+
+ // Try from auth
+ if (auth()->check()) {
+ return auth()->id();
+ }
+
+ return null;
+ }
+
+ /**
+ * Extract user IP from request context.
+ */
+ private function getUserIp(Request $request): ?string
+ {
+ // Try from request metadata
+ $ip = $request->input('user_ip');
+ if ($ip !== null) {
+ return $ip;
+ }
+
+ // Try from HTTP request
+ if (request()) {
+ return request()->ip();
+ }
+
+ return null;
+ }
+
+ /**
+ * Sanitise database error messages to avoid leaking sensitive information.
+ */
+ private function sanitiseErrorMessage(string $message): string
+ {
+ // Remove specific database paths, credentials, etc.
+ $message = preg_replace('/\/[^\s]+/', '[path]', $message);
+ $message = preg_replace('/at \d+\.\d+\.\d+\.\d+/', 'at [ip]', $message);
+
+ // Truncate long messages
+ if (strlen($message) > 200) {
+ $message = substr($message, 0, 200).'...';
+ }
+
+ return $message;
+ }
+
+ /**
+ * Handle EXPLAIN query execution.
+ */
+ private function handleExplain(
+ ?string $connection,
+ string $query,
+ ?int $workspaceId = null,
+ ?int $userId = null,
+ ?string $userIp = null,
+ ?string $sessionId = null
+ ): Response {
+ $startTime = microtime(true);
+
+ try {
+ // Run EXPLAIN on the query
+ $explainResults = DB::connection($connection)->select("EXPLAIN {$query}");
+ $durationMs = (int) ((microtime(true) - $startTime) * 1000);
+
+ // Also try to get extended information if MySQL/MariaDB
+ $warnings = [];
+ try {
+ $warnings = DB::connection($connection)->select('SHOW WARNINGS');
+ } catch (\Exception $e) {
+ // SHOW WARNINGS may not be available on all databases
+ }
+
+ $response = [
+ 'explain' => $explainResults,
+ 'query' => $query,
+ ];
+
+ if (! empty($warnings)) {
+ $response['warnings'] = $warnings;
+ }
+
+ // Add helpful interpretation
+ $response['interpretation'] = $this->interpretExplain($explainResults);
+
+ // Log the EXPLAIN query
+ $this->auditService->recordSuccess(
+ query: "EXPLAIN {$query}",
+ bindings: [],
+ durationMs: $durationMs,
+ rowCount: count($explainResults),
+ workspaceId: $workspaceId,
+ userId: $userId,
+ userIp: $userIp,
+ context: ['session_id' => $sessionId, 'explain_requested' => true]
+ );
+
+ return Response::text(json_encode($response, JSON_PRETTY_PRINT));
+ } catch (\Exception $e) {
+ $durationMs = (int) ((microtime(true) - $startTime) * 1000);
+
+ $this->auditService->recordError(
+ query: "EXPLAIN {$query}",
+ bindings: [],
+ errorMessage: $e->getMessage(),
+ durationMs: $durationMs,
+ workspaceId: $workspaceId,
+ userId: $userId,
+ userIp: $userIp,
+ context: ['session_id' => $sessionId, 'explain_requested' => true]
+ );
+
+ report($e);
+
+ return $this->errorResponse('EXPLAIN failed: '.$this->sanitiseErrorMessage($e->getMessage()));
+ }
+ }
+
+ /**
+ * Provide human-readable interpretation of EXPLAIN results.
+ */
+ private function interpretExplain(array $explainResults): array
+ {
+ $interpretation = [];
+
+ foreach ($explainResults as $row) {
+ $rowAnalysis = [];
+
+ // Convert stdClass to array for easier access
+ $rowArray = (array) $row;
+
+ // Check for full table scan
+ if (isset($rowArray['type']) && $rowArray['type'] === 'ALL') {
+ $rowAnalysis[] = 'WARNING: Full table scan detected. Consider adding an index.';
+ }
+
+ // Check for filesort
+ if (isset($rowArray['Extra']) && str_contains($rowArray['Extra'], 'Using filesort')) {
+ $rowAnalysis[] = 'INFO: Using filesort. Query may benefit from an index on ORDER BY columns.';
+ }
+
+ // Check for temporary table
+ if (isset($rowArray['Extra']) && str_contains($rowArray['Extra'], 'Using temporary')) {
+ $rowAnalysis[] = 'INFO: Using temporary table. Consider optimizing the query.';
+ }
+
+ // Check rows examined
+ if (isset($rowArray['rows']) && $rowArray['rows'] > 10000) {
+ $rowAnalysis[] = sprintf('WARNING: High row count (%d rows). Query may be slow.', $rowArray['rows']);
+ }
+
+ // Check if index is used
+ if (isset($rowArray['key']) && $rowArray['key'] !== null) {
+ $rowAnalysis[] = sprintf('GOOD: Using index: %s', $rowArray['key']);
+ }
+
+ if (! empty($rowAnalysis)) {
+ $interpretation[] = [
+ 'table' => $rowArray['table'] ?? 'unknown',
+ 'analysis' => $rowAnalysis,
+ ];
+ }
+ }
+
+ return $interpretation;
+ }
+
+ /**
+ * Create an error response.
+ */
+ private function errorResponse(string $message): Response
+ {
+ return Response::text(json_encode(['error' => $message]));
+ }
+}
diff --git a/src/php/src/Mcp/View/Blade/admin/analytics/dashboard.blade.php b/src/php/src/Mcp/View/Blade/admin/analytics/dashboard.blade.php
new file mode 100644
index 0000000..10a44b0
--- /dev/null
+++ b/src/php/src/Mcp/View/Blade/admin/analytics/dashboard.blade.php
@@ -0,0 +1,233 @@
+
+
+
+
+ Tool Usage Analytics
+ Monitor MCP tool usage patterns, performance, and errors
+
+
+
+ 7 Days
+ 14 Days
+ 30 Days
+
+ Refresh
+
+
+
+
+
+ @include('mcp::admin.analytics.partials.stats-card', [
+ 'label' => 'Total Calls',
+ 'value' => number_format($this->overview['total_calls']),
+ 'color' => 'default',
+ ])
+
+ @include('mcp::admin.analytics.partials.stats-card', [
+ 'label' => 'Error Rate',
+ 'value' => $this->overview['error_rate'] . '%',
+ 'color' => $this->overview['error_rate'] > 10 ? 'red' : ($this->overview['error_rate'] > 5 ? 'yellow' : 'green'),
+ ])
+
+ @include('mcp::admin.analytics.partials.stats-card', [
+ 'label' => 'Avg Response',
+ 'value' => $this->formatDuration($this->overview['avg_duration_ms']),
+ 'color' => $this->overview['avg_duration_ms'] > 5000 ? 'yellow' : 'default',
+ ])
+
+ @include('mcp::admin.analytics.partials.stats-card', [
+ 'label' => 'Total Errors',
+ 'value' => number_format($this->overview['total_errors']),
+ 'color' => $this->overview['total_errors'] > 0 ? 'red' : 'default',
+ ])
+
+ @include('mcp::admin.analytics.partials.stats-card', [
+ 'label' => 'Unique Tools',
+ 'value' => $this->overview['unique_tools'],
+ 'color' => 'default',
+ ])
+
+
+
+
+
+
+ Overview
+
+
+ All Tools
+
+
+ Errors
+
+
+ Combinations
+
+
+
+
+ @if($tab === 'overview')
+
+
+
+
+ Top 10 Most Used Tools
+
+
+ @if($this->popularTools->isEmpty())
+
No tool usage data available
+ @else
+
+ @php $maxCalls = $this->popularTools->first()->totalCalls ?: 1; @endphp
+ @foreach($this->popularTools as $tool)
+
+
+ {{ $tool->toolName }}
+
+
+
+ {{ number_format($tool->totalCalls) }}
+
+
+ {{ $tool->errorRate }}%
+
+
+ @endforeach
+
+ @endif
+
+
+
+
+
+
+ Tools with Highest Error Rates
+
+
+ @if($this->errorProneTools->isEmpty())
+
All tools are healthy - no significant errors
+ @else
+
+ @foreach($this->errorProneTools as $tool)
+
+ @endforeach
+
+ @endif
+
+
+
+ @endif
+
+ @if($tab === 'tools')
+
+
+
+ All Tools
+ {{ $this->sortedTools->count() }} tools
+
+
+ @include('mcp::admin.analytics.partials.tool-table', ['tools' => $this->sortedTools])
+
+
+ @endif
+
+ @if($tab === 'errors')
+
+
+
+ Error Analysis
+
+
+ @if($this->errorProneTools->isEmpty())
+
+
✓
+ All tools are healthy - no significant errors detected
+
+ @else
+
+ @foreach($this->errorProneTools as $tool)
+
+ @endforeach
+
+ @endif
+
+
+ @endif
+
+ @if($tab === 'combinations')
+
+
+
+ Popular Tool Combinations
+ Tools frequently used together in the same session
+
+
+ @if($this->toolCombinations->isEmpty())
+
No tool combination data available yet
+ @else
+
+ @foreach($this->toolCombinations as $combo)
+
+
+ {{ $combo['tool_a'] }}
+ +
+ {{ $combo['tool_b'] }}
+
+
+ {{ number_format($combo['occurrences']) }} times
+
+
+ @endforeach
+
+ @endif
+
+
+ @endif
+
+ {{ $label }}
+ {{ $value }}
+ @if($subtext)
+ {{ $subtext }}
+ @endif
+
diff --git a/src/php/src/Mcp/View/Blade/admin/analytics/partials/tool-table.blade.php b/src/php/src/Mcp/View/Blade/admin/analytics/partials/tool-table.blade.php
new file mode 100644
index 0000000..a03c517
--- /dev/null
+++ b/src/php/src/Mcp/View/Blade/admin/analytics/partials/tool-table.blade.php
@@ -0,0 +1,100 @@
+@props(['tools'])
+
+
+
+
+
+
+ Tool Name
+ @if($sortColumn === 'toolName')
+ {{ $sortDirection === 'asc' ? '▲' : '▼' }}
+ @endif
+
+
+
+
+ Total Calls
+ @if($sortColumn === 'totalCalls')
+ {{ $sortDirection === 'asc' ? '▲' : '▼' }}
+ @endif
+
+
+
+
+ Errors
+ @if($sortColumn === 'errorCount')
+ {{ $sortDirection === 'asc' ? '▲' : '▼' }}
+ @endif
+
+
+
+
+ Error Rate
+ @if($sortColumn === 'errorRate')
+ {{ $sortDirection === 'asc' ? '▲' : '▼' }}
+ @endif
+
+
+
+
+ Avg Duration
+ @if($sortColumn === 'avgDurationMs')
+ {{ $sortDirection === 'asc' ? '▲' : '▼' }}
+ @endif
+
+
+
+ Min / Max
+
+
+ Actions
+
+
+
+
+ @forelse($tools as $tool)
+
+
+
+ {{ $tool->toolName }}
+
+
+
+ {{ number_format($tool->totalCalls) }}
+
+
+ {{ number_format($tool->errorCount) }}
+
+
+
+ {{ $tool->errorRate }}%
+
+
+
+ {{ $this->formatDuration($tool->avgDurationMs) }}
+
+
+ {{ $this->formatDuration($tool->minDurationMs) }} / {{ $this->formatDuration($tool->maxDurationMs) }}
+
+
+
+ View Details
+
+
+
+ @empty
+
+
+ No tool usage data available
+
+
+ @endforelse
+
+
diff --git a/src/php/src/Mcp/View/Blade/admin/analytics/tool-detail.blade.php b/src/php/src/Mcp/View/Blade/admin/analytics/tool-detail.blade.php
new file mode 100644
index 0000000..3166aaa
--- /dev/null
+++ b/src/php/src/Mcp/View/Blade/admin/analytics/tool-detail.blade.php
@@ -0,0 +1,183 @@
+
+
+
+
+
+
{{ $toolName }}
+
Detailed usage analytics for this tool
+
+
+
+ 7 Days
+ 14 Days
+ 30 Days
+
+ Refresh
+
+
+
+
+
+
+ Total Calls
+ {{ number_format($this->stats->totalCalls) }}
+
+
+
+ Error Rate
+
+ {{ $this->stats->errorRate }}%
+
+
+
+
+ Total Errors
+
+ {{ number_format($this->stats->errorCount) }}
+
+
+
+
+ Avg Duration
+ {{ $this->formatDuration($this->stats->avgDurationMs) }}
+
+
+
+ Min Duration
+ {{ $this->formatDuration($this->stats->minDurationMs) }}
+
+
+
+ Max Duration
+ {{ $this->formatDuration($this->stats->maxDurationMs) }}
+
+
+
+
+
+
+ Usage Trend
+
+
+ @if(empty($this->trends) || array_sum(array_column($this->trends, 'calls')) === 0)
+
No usage data available for this period
+ @else
+
+ @php
+ $maxCalls = max(array_column($this->trends, 'calls')) ?: 1;
+ @endphp
+ @foreach($this->trends as $day)
+
+
{{ $day['date_formatted'] }}
+
+
+ @php
+ $callsWidth = ($day['calls'] / $maxCalls) * 100;
+ $errorsWidth = $day['calls'] > 0 ? ($day['errors'] / $day['calls']) * $callsWidth : 0;
+ $successWidth = $callsWidth - $errorsWidth;
+ @endphp
+
+
+
{{ $day['calls'] }}
+
+
+ @if($day['calls'] > 0)
+
+ {{ round($day['error_rate'], 1) }}%
+
+ @else
+ -
+ @endif
+
+
+ @endforeach
+
+
+
+ @endif
+
+
+
+
+
+
+ Response Time Distribution
+
+
+
+
+
Fastest
+
{{ $this->formatDuration($this->stats->minDurationMs) }}
+
+
+
Average
+
{{ $this->formatDuration($this->stats->avgDurationMs) }}
+
+
+
Slowest
+
{{ $this->formatDuration($this->stats->maxDurationMs) }}
+
+
+
+
+
+
+
+
+ Daily Breakdown
+
+
+
+
+
+ Date
+ Calls
+ Errors
+ Error Rate
+ Avg Duration
+
+
+
+ @forelse($this->trends as $day)
+ @if($day['calls'] > 0)
+
+ {{ $day['date'] }}
+ {{ number_format($day['calls']) }}
+ {{ number_format($day['errors']) }}
+
+
+ {{ round($day['error_rate'], 1) }}%
+
+
+ {{ $this->formatDuration($day['avg_duration_ms']) }}
+
+ @endif
+ @empty
+
+
+ No data available for this period
+
+
+ @endforelse
+
+
+
+
+
+
+ @if(session('message'))
+
+
{{ session('message') }}
+
+ @endif
+
+
+
+
+
+ {{ __('mcp::mcp.keys.title') }}
+
+
+ {{ __('mcp::mcp.keys.description') }}
+
+
+
+ {{ __('mcp::mcp.keys.actions.create') }}
+
+
+
+
+
+ @if($keys->isEmpty())
+
+
+
+
{{ __('mcp::mcp.keys.empty.title') }}
+
+ {{ __('mcp::mcp.keys.empty.description') }}
+
+
+ {{ __('mcp::mcp.keys.actions.create_first') }}
+
+
+ @else
+
+
+
+
+ {{ __('mcp::mcp.keys.table.name') }}
+
+
+ {{ __('mcp::mcp.keys.table.key') }}
+
+
+ {{ __('mcp::mcp.keys.table.scopes') }}
+
+
+ {{ __('mcp::mcp.keys.table.last_used') }}
+
+
+ {{ __('mcp::mcp.keys.table.expires') }}
+
+
+ {{ __('mcp::mcp.keys.table.actions') }}
+
+
+
+
+ @foreach($keys as $key)
+
+
+ {{ $key->name }}
+
+
+
+ {{ $key->prefix }}_****
+
+
+
+
+ @foreach($key->scopes ?? [] as $scope)
+
+ {{ $scope }}
+
+ @endforeach
+
+
+
+ {{ $key->last_used_at?->diffForHumans() ?? __('mcp::mcp.keys.status.never') }}
+
+
+ @if($key->expires_at)
+ @if($key->expires_at->isPast())
+ {{ __('mcp::mcp.keys.status.expired') }}
+ @else
+ {{ $key->expires_at->diffForHumans() }}
+ @endif
+ @else
+ {{ __('mcp::mcp.keys.status.never') }}
+ @endif
+
+
+
+ {{ __('mcp::mcp.keys.actions.revoke') }}
+
+
+
+ @endforeach
+
+
+ @endif
+
+
+
+
+
+
+
+
+
+ {{ __('mcp::mcp.keys.auth.description') }}
+
+
+
+
{{ __('mcp::mcp.keys.auth.header_recommended') }}
+
Authorization: Bearer hk_abc123_****
+
+
+
{{ __('mcp::mcp.keys.auth.header_api_key') }}
+
X-API-Key: hk_abc123_****
+
+
+
+
+
+
+
+
+
+ {{ __('mcp::mcp.keys.example.description') }}
+
+
curl -X POST https://mcp.host.uk.com/api/v1/tools/call \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "server": "commerce",
+ "tool": "product_list",
+ "arguments": {}
+ }'
+
+
+
+
+
+
+
{{ __('mcp::mcp.keys.create_modal.title') }}
+
+
+
+
+
{{ __('mcp::mcp.keys.create_modal.name_label') }}
+
+ @error('newKeyName')
+
{{ $message }}
+ @enderror
+
+
+
+
+
+
+
+ {{ __('mcp::mcp.keys.create_modal.expiry_label') }}
+
+ {{ __('mcp::mcp.keys.create_modal.expiry_never') }}
+ {{ __('mcp::mcp.keys.create_modal.expiry_30') }}
+ {{ __('mcp::mcp.keys.create_modal.expiry_90') }}
+ {{ __('mcp::mcp.keys.create_modal.expiry_1year') }}
+
+
+
+
+
+ {{ __('mcp::mcp.keys.create_modal.cancel') }}
+ {{ __('mcp::mcp.keys.create_modal.create') }}
+
+
+
+
+
+
+
+
+
+
{{ __('mcp::mcp.keys.new_key_modal.title') }}
+
+
+
+
+ {{ __('mcp::mcp.keys.new_key_modal.warning') }} {{ __('mcp::mcp.keys.new_key_modal.warning_detail') }}
+
+
+
+
+
{{ $newPlainKey }}
+
+
+
+
+
+ {{ __('mcp::mcp.keys.new_key_modal.done') }}
+
+
+
+ {{-- Header --}}
+
+
+ {{ __('MCP Audit Log') }}
+ Immutable audit trail for tool executions with hash chain integrity
+
+
+
+ Verify Integrity
+
+
+ Export
+
+
+
+
+ {{-- Stats Cards --}}
+
+
+
Total Entries
+
+ {{ number_format($this->stats['total']) }}
+
+
+
+
Success Rate
+
+ {{ $this->stats['success_rate'] }}%
+
+
+
+
Failed Calls
+
+ {{ number_format($this->stats['failed']) }}
+
+
+
+
Sensitive Calls
+
+ {{ number_format($this->stats['sensitive_calls']) }}
+
+
+
+
+ {{-- Filters --}}
+
+
+
+
+ All tools
+ @foreach ($this->tools as $toolName)
+ {{ $toolName }}
+ @endforeach
+
+
+ All workspaces
+ @foreach ($this->workspaces as $ws)
+ {{ $ws->name }}
+ @endforeach
+
+
+ All statuses
+ Success
+ Failed
+
+
+ All sensitivity
+ Sensitive only
+ Normal only
+
+
+
+ @if($search || $tool || $workspace || $status || $sensitivity || $dateFrom || $dateTo)
+
Clear
+ @endif
+
+
+ {{-- Audit Log Table --}}
+
+
+ ID
+ Time
+ Tool
+ Workspace
+ Status
+ Sensitivity
+ Actor
+ Duration
+
+
+
+ @forelse ($this->entries as $entry)
+
+
+ #{{ $entry->id }}
+
+
+ {{ $entry->created_at->format('M j, Y H:i:s') }}
+
+
+ {{ $entry->tool_name }}
+ {{ $entry->server_id }}
+
+
+ @if($entry->workspace)
+ {{ $entry->workspace->name }}
+ @else
+ -
+ @endif
+
+
+
+ {{ $entry->success ? 'Success' : 'Failed' }}
+
+
+
+ @if($entry->is_sensitive)
+
+ Sensitive
+
+ @else
+ -
+ @endif
+
+
+ {{ $entry->getActorDisplay() }}
+ @if($entry->actor_ip)
+ {{ $entry->actor_ip }}
+ @endif
+
+
+ {{ $entry->getDurationForHumans() }}
+
+
+
+ View
+
+
+
+ @empty
+
+
+
+
+
+
No audit entries found
+
Audit logs will appear here as tools are executed.
+
+
+ @endforelse
+
+
+
+ @if($this->entries->hasPages())
+
+ {{ $this->entries->links() }}
+
+ @endif
+
+ {{-- Entry Detail Modal --}}
+ @if($this->selectedEntry)
+
+
+
+ Audit Entry #{{ $this->selectedEntry->id }}
+
+
+ {{-- Integrity Status --}}
+ @php
+ $integrity = $this->selectedEntry->getIntegrityStatus();
+ @endphp
+
+
+
+ {{ $integrity['valid'] ? 'Integrity Verified' : 'Integrity Issues Detected' }}
+
+
+ @if(!$integrity['valid'])
+
+ @foreach($integrity['issues'] as $issue)
+ {{ $issue }}
+ @endforeach
+
+ @endif
+
+
+ {{-- Entry Details --}}
+
+
+
Tool
+
{{ $this->selectedEntry->tool_name }}
+
+
+
Server
+
{{ $this->selectedEntry->server_id }}
+
+
+
Timestamp
+
{{ $this->selectedEntry->created_at->format('Y-m-d H:i:s.u') }}
+
+
+
Duration
+
{{ $this->selectedEntry->getDurationForHumans() }}
+
+
+
Status
+
+
+ {{ $this->selectedEntry->success ? 'Success' : 'Failed' }}
+
+
+
+
+
Actor
+
{{ $this->selectedEntry->getActorDisplay() }}
+
+
+
+ @if($this->selectedEntry->is_sensitive)
+
+
+ Sensitive Tool
+
+
+ {{ $this->selectedEntry->sensitivity_reason ?? 'This tool is flagged as sensitive.' }}
+
+
+ @endif
+
+ @if($this->selectedEntry->error_message)
+
+
Error
+
+ @if($this->selectedEntry->error_code)
+
+ {{ $this->selectedEntry->error_code }}
+
+ @endif
+
+ {{ $this->selectedEntry->error_message }}
+
+
+
+ @endif
+
+ @if($this->selectedEntry->input_params)
+
+
Input Parameters
+
{{ json_encode($this->selectedEntry->input_params, JSON_PRETTY_PRINT) }}
+
+ @endif
+
+ @if($this->selectedEntry->output_summary)
+
+
Output Summary
+
{{ json_encode($this->selectedEntry->output_summary, JSON_PRETTY_PRINT) }}
+
+ @endif
+
+ {{-- Hash Chain Info --}}
+
+
Hash Chain
+
+
+ Entry Hash:
+ {{ $this->selectedEntry->entry_hash }}
+
+
+ Previous Hash:
+ {{ $this->selectedEntry->previous_hash ?? '(first entry)' }}
+
+
+
+
+ @endif
+
+ {{-- Integrity Verification Modal --}}
+ @if($showIntegrityModal && $integrityStatus)
+
+
+
+ Integrity Verification
+
+
+
+
+
+
+
+ {{ $integrityStatus['valid'] ? 'Audit Log Verified' : 'Integrity Issues Detected' }}
+
+
+ {{ number_format($integrityStatus['verified']) }} of {{ number_format($integrityStatus['total']) }} entries verified
+
+
+
+
+
+ @if(!$integrityStatus['valid'] && !empty($integrityStatus['issues']))
+
+
Issues Found:
+
+ @foreach($integrityStatus['issues'] as $issue)
+
+
+ Entry #{{ $issue['id'] }}: {{ $issue['type'] }}
+
+
+ {{ $issue['message'] }}
+
+
+ @endforeach
+
+
+ @endif
+
+
+
+ Close
+
+
+
+ @endif
+
+ {{-- Export Modal --}}
+ @if($showExportModal)
+
+
+
+ Export Audit Log
+
+
+
+
+ Export the audit log with current filters applied. The export includes integrity verification metadata.
+
+
+
+ Export Format
+
+ JSON (with integrity metadata)
+ CSV (data only)
+
+
+
+
+
Current Filters:
+
+ @if($tool)
+ Tool: {{ $tool }}
+ @endif
+ @if($workspace)
+ Workspace: {{ $this->workspaces->firstWhere('id', $workspace)?->name }}
+ @endif
+ @if($dateFrom || $dateTo)
+ Date: {{ $dateFrom ?: 'start' }} to {{ $dateTo ?: 'now' }}
+ @endif
+ @if($sensitivity === 'sensitive')
+ Sensitive only
+ @endif
+ @if(!$tool && !$workspace && !$dateFrom && !$dateTo && !$sensitivity)
+ All entries
+ @endif
+
+
+
+
+
+
+ Cancel
+
+
+ Download
+
+
+
+ @endif
+
+ {{-- Header --}}
+
+
+
+
MCP Playground
+
+ Interactive tool testing with documentation and examples
+
+
+
+
+
+
+ History
+ @if(count($conversationHistory) > 0)
+
+ {{ count($conversationHistory) }}
+
+ @endif
+
+
+
+
+
+ {{-- Error Display --}}
+ @if($error)
+
+ @endif
+
+
+ {{-- Left Sidebar: Tool Browser --}}
+
+
+ {{-- Server Selection --}}
+
+ Server
+
+ Select a server...
+ @foreach($servers as $server)
+ {{ $server['name'] }} ({{ $server['tool_count'] }})
+ @endforeach
+
+
+
+ @if($selectedServer)
+ {{-- Search --}}
+
+
+ {{-- Category Filter --}}
+ @if($categories->isNotEmpty())
+
+
Category
+
+
+ All
+
+ @foreach($categories as $category)
+
+ {{ $category }}
+
+ @endforeach
+
+
+ @endif
+
+ {{-- Tools List --}}
+
+ @forelse($toolsByCategory as $category => $categoryTools)
+
+
{{ $category }}
+
+ @foreach($categoryTools as $tool)
+
+
+
{{ $tool['name'] }}
+ @if($selectedTool === $tool['name'])
+
+
+ @endif
+
{{ Str::limit($tool['description'], 80) }}
+ @endif
+
+ @endforeach
+ @empty
+
+ @endforelse
+
+ @else
+
+
+
+
Select a server to browse tools
+
+ @endif
+
+
+
+ {{-- Center: Tool Details & Input Form --}}
+
+ {{-- API Key Authentication --}}
+
+
+
+
+ Authentication
+
+
+
+
API Key
+
+
Paste your API key to execute requests live
+
+
+
+ Validate Key
+
+ @if($keyStatus === 'valid')
+
+
+
+ Valid
+
+ @elseif($keyStatus === 'invalid')
+
+
+
+ Invalid key
+
+ @elseif($keyStatus === 'expired')
+
+
+
+ Expired
+
+ @endif
+
+ @if($keyInfo)
+
+
+
+ Name:
+ {{ $keyInfo['name'] }}
+
+
+ Workspace:
+ {{ $keyInfo['workspace'] }}
+
+
+
+ @endif
+
+
+
+ {{-- Tool Form --}}
+ @if($currentTool)
+
+
+
+
+
{{ $currentTool['name'] }}
+
{{ $currentTool['description'] }}
+
+
+ {{ $currentTool['category'] }}
+
+
+
+
+ @php
+ $properties = $currentTool['inputSchema']['properties'] ?? [];
+ $required = $currentTool['inputSchema']['required'] ?? [];
+ @endphp
+
+ @if(count($properties) > 0)
+
+
+
Parameters
+
+ Load examples
+
+
+
+ @foreach($properties as $name => $schema)
+ @php
+ $isRequired = in_array($name, $required) || ($schema['required'] ?? false);
+ $type = is_array($schema['type'] ?? 'string') ? ($schema['type'][0] ?? 'string') : ($schema['type'] ?? 'string');
+ $description = $schema['description'] ?? '';
+ @endphp
+
+
+
+ {{ $name }}
+ @if($isRequired)
+ *
+ @endif
+
+
+ @if(isset($schema['enum']))
+
+ Select...
+ @foreach($schema['enum'] as $option)
+ {{ $option }}
+ @endforeach
+
+ @elseif($type === 'boolean')
+
+ Default
+ true
+ false
+
+ @elseif($type === 'integer' || $type === 'number')
+
+ @elseif($type === 'array' || $type === 'object')
+
+ @else
+
+ @endif
+
+ @if($description)
+
{{ $description }}
+ @endif
+
+ @endforeach
+
+ @else
+
This tool has no parameters.
+ @endif
+
+
+
+
+ @if($keyStatus === 'valid')
+ Execute Request
+ @else
+ Generate Request Preview
+ @endif
+
+
+
+
+ Executing...
+
+
+
+
+ @else
+
+
+
+
Select a tool
+
+ Choose a tool from the sidebar to view its documentation and test it
+
+
+ @endif
+
+
+ {{-- Right: Response Viewer --}}
+
+
+
+
Response
+ @if($executionTime > 0)
+ {{ $executionTime }}ms
+ @endif
+
+
+
+ @if($lastResponse)
+
+
+
+
+ Copy
+ Copied!
+
+
+
+ @if(isset($lastResponse['error']))
+
+
{{ $lastResponse['error'] }}
+
+ @endif
+
+
+
{{ json_encode($lastResponse, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) }}
+
+
+ @if(isset($lastResponse['executed']) && !$lastResponse['executed'])
+
+
+ This is a preview. Add a valid API key to execute requests live.
+
+
+ @endif
+ @else
+
+
+
+
Response will appear here
+
+ @endif
+
+
+ {{-- API Reference --}}
+
+
API Reference
+
+
+ Endpoint
+ /api/v1/mcp/tools/call
+
+
+ Method
+ POST
+
+
+ Auth
+ Bearer token
+
+
+
+
+
+
+
+ {{-- History Panel (Collapsible Bottom) --}}
+
+
+
+
+
+
+ Conversation History
+
+ @if(count($conversationHistory) > 0)
+
+ Clear All
+
+ @endif
+
+
+ @if(count($conversationHistory) > 0)
+
+ @foreach($conversationHistory as $index => $entry)
+
+
+
+
+ @if($entry['success'] ?? true)
+
+ Success
+
+ @else
+
+ Failed
+
+ @endif
+ {{ $entry['tool'] }}
+ on
+ {{ $entry['server'] }}
+
+
+ {{ \Carbon\Carbon::parse($entry['timestamp'])->diffForHumans() }}
+ @if(isset($entry['duration_ms']))
+ {{ $entry['duration_ms'] }}ms
+ @endif
+
+
+
+
+ View
+
+
+ Re-run
+
+
+
+
+ @endforeach
+
+ @else
+
+
No history yet. Execute a tool to see it here.
+
+ @endif
+
+
+
+
+
{{ __('mcp::mcp.playground.title') }}
+
+ {{ __('mcp::mcp.playground.description') }}
+
+
+
+ {{-- Error Display --}}
+ @if($error)
+
+ @endif
+
+
+
+
+
+
+
{{ __('mcp::mcp.playground.auth.title') }}
+
+
+
+
+
+
+
+ {{ __('mcp::mcp.playground.auth.validate') }}
+
+
+ @if($keyStatus === 'valid')
+
+
+ @elseif($keyStatus === 'invalid')
+
+
+ @elseif($keyStatus === 'expired')
+
+
+ @elseif($keyStatus === 'empty')
+
+ {{ __('mcp::mcp.playground.auth.status.empty') }}
+
+ @endif
+
+
+ @if($keyInfo)
+
+
+
+ {{ __('mcp::mcp.playground.auth.key_info.name') }}:
+ {{ $keyInfo['name'] }}
+
+
+ {{ __('mcp::mcp.playground.auth.key_info.workspace') }}:
+ {{ $keyInfo['workspace'] }}
+
+
+ {{ __('mcp::mcp.playground.auth.key_info.scopes') }}:
+ {{ implode(', ', $keyInfo['scopes'] ?? []) }}
+
+
+ {{ __('mcp::mcp.playground.auth.key_info.last_used') }}:
+ {{ $keyInfo['last_used'] }}
+
+
+
+ @elseif(!$isAuthenticated && !$apiKey)
+
+ @endif
+
+
+
+
+
+
{{ __('mcp::mcp.playground.tools.title') }}
+
+
+
+ @foreach($servers as $server)
+ {{ $server['name'] }}
+ @endforeach
+
+
+ @if($selectedServer && count($tools) > 0)
+
+ @foreach($tools as $tool)
+ {{ $tool['name'] }}
+ @endforeach
+
+ @endif
+
+
+
+
+ @if($toolSchema)
+
+
+
{{ $toolSchema['name'] }}
+
{{ $toolSchema['description'] ?? $toolSchema['purpose'] ?? '' }}
+
+
+ @php
+ $params = $toolSchema['inputSchema']['properties'] ?? $toolSchema['parameters'] ?? [];
+ $required = $toolSchema['inputSchema']['required'] ?? [];
+ @endphp
+
+ @if(count($params) > 0)
+
+
{{ __('mcp::mcp.playground.tools.arguments') }}
+
+ @foreach($params as $name => $schema)
+
+ @php
+ $paramRequired = in_array($name, $required) || ($schema['required'] ?? false);
+ $paramType = is_array($schema['type'] ?? 'string') ? ($schema['type'][0] ?? 'string') : ($schema['type'] ?? 'string');
+ @endphp
+
+ @if(isset($schema['enum']))
+
+ @foreach($schema['enum'] as $option)
+ {{ $option }}
+ @endforeach
+
+ @elseif($paramType === 'boolean')
+
+ true
+ false
+
+ @elseif($paramType === 'integer' || $paramType === 'number')
+
+ @endforeach
+
+ @else
+
{{ __('mcp::mcp.playground.tools.no_arguments') }}
+ @endif
+
+
+
+
+ @if($keyStatus === 'valid')
+ {{ __('mcp::mcp.playground.tools.execute') }}
+ @else
+ {{ __('mcp::mcp.playground.tools.generate') }}
+ @endif
+
+ {{ __('mcp::mcp.playground.tools.executing') }}
+
+
+
+ @endif
+
+
+
+
+
+
{{ __('mcp::mcp.playground.response.title') }}
+
+ @if($response)
+
+
+
+ {{ __('mcp::mcp.playground.response.copy') }}
+ {{ __('mcp::mcp.playground.response.copied') }}
+
+
+
{{ $response }}
+
+ @else
+
+
+
{{ __('mcp::mcp.playground.response.empty') }}
+
+ @endif
+
+
+
+
+
{{ __('mcp::mcp.playground.reference.title') }}
+
+
+ {{ __('mcp::mcp.playground.reference.endpoint') }}:
+ {{ config('app.url') }}/api/v1/mcp/tools/call
+
+
+ {{ __('mcp::mcp.playground.reference.method') }}:
+ POST
+
+
+ {{ __('mcp::mcp.playground.reference.auth') }}:
+ @if($keyStatus === 'valid')
+ Bearer {{ Str::limit($apiKey, 20, '...') }}
+ @else
+ Bearer <your-api-key>
+ @endif
+
+
+ {{ __('mcp::mcp.playground.reference.content_type') }}:
+ application/json
+
+
+
+ @if($isAuthenticated)
+
+
+ {{ __('mcp::mcp.playground.reference.manage_keys') }}
+
+
+ @endif
+
+
+
+
+ {{-- Header --}}
+
+
+
MCP Usage Quota
+
+ Current billing period resets {{ $this->resetDate }}
+
+
+
+
+
+
+ {{-- Current Usage Cards --}}
+
+ {{-- Tool Calls Card --}}
+
+
+
+
+
+
+
Tool Calls
+
Monthly usage
+
+
+
+
+ @if($quotaLimits['tool_calls_unlimited'] ?? false)
+
+
+ {{ number_format($currentUsage['tool_calls_count'] ?? 0) }}
+
+ Unlimited
+
+ @else
+
+
+
+ {{ number_format($currentUsage['tool_calls_count'] ?? 0) }}
+
+
+ of {{ number_format($quotaLimits['tool_calls_limit'] ?? 0) }}
+
+
+
+
+ {{ number_format($remaining['tool_calls'] ?? 0) }} remaining
+
+
+ @endif
+
+
+ {{-- Tokens Card --}}
+
+
+
+
+
+
+
Tokens
+
Monthly consumption
+
+
+
+
+ @if($quotaLimits['tokens_unlimited'] ?? false)
+
+
+ {{ number_format($currentUsage['total_tokens'] ?? 0) }}
+
+ Unlimited
+
+
+
+ Input:
+
+ {{ number_format($currentUsage['input_tokens'] ?? 0) }}
+
+
+
+ Output:
+
+ {{ number_format($currentUsage['output_tokens'] ?? 0) }}
+
+
+
+ @else
+
+
+
+ {{ number_format($currentUsage['total_tokens'] ?? 0) }}
+
+
+ of {{ number_format($quotaLimits['tokens_limit'] ?? 0) }}
+
+
+
+
+
+ {{ number_format($remaining['tokens'] ?? 0) }} remaining
+
+
+
+ In: {{ number_format($currentUsage['input_tokens'] ?? 0) }}
+
+
+ Out: {{ number_format($currentUsage['output_tokens'] ?? 0) }}
+
+
+
+
+ @endif
+
+
+
+ {{-- Usage History --}}
+ @if($usageHistory->count() > 0)
+
+
Usage History
+
+
+
+
+ Month
+ Tool Calls
+ Input Tokens
+ Output Tokens
+ Total Tokens
+
+
+
+ @foreach($usageHistory as $record)
+
+
+ {{ $record->month_label }}
+
+
+ {{ number_format($record->tool_calls_count) }}
+
+
+ {{ number_format($record->input_tokens) }}
+
+
+ {{ number_format($record->output_tokens) }}
+
+
+ {{ number_format($record->total_tokens) }}
+
+
+ @endforeach
+
+
+
+
+ @endif
+
+ {{-- Upgrade Prompt (shown when near limit) --}}
+ @if(($this->toolCallsPercentage >= 80 || $this->tokensPercentage >= 80) && !($quotaLimits['tool_calls_unlimited'] ?? false))
+
+
+
+
+
Approaching usage limit
+
+ You're nearing your monthly MCP quota. Consider upgrading your plan for higher limits.
+
+
+
+
+ @endif
+
+
+
{{ __('mcp::mcp.logs.title') }}
+
+ {{ __('mcp::mcp.logs.description') }}
+
+
+
+
+
+
+
+ {{ __('mcp::mcp.logs.filters.server') }}
+
+ {{ __('mcp::mcp.logs.filters.all_servers') }}
+ @foreach($servers as $server)
+ {{ $server }}
+ @endforeach
+
+
+
+ {{ __('mcp::mcp.logs.filters.status') }}
+
+ {{ __('mcp::mcp.logs.filters.all') }}
+ {{ __('mcp::mcp.logs.filters.success') }}
+ {{ __('mcp::mcp.logs.filters.failed') }}
+
+
+
+
+
+
+
+
+
+ @forelse($requests as $request)
+
+
+
+
+ {{ $request->response_status }}
+
+
+ {{ $request->server_id }}/{{ $request->tool_name }}
+
+
+
+ {{ $request->duration_for_humans }}
+
+
+ {{ $request->created_at->diffForHumans() }}
+ ·
+ {{ $request->request_id }}
+
+
+ @empty
+
+ {{ __('mcp::mcp.logs.empty') }}
+
+ @endforelse
+
+
+ @if($requests->hasPages())
+
+ {{ $requests->links() }}
+
+ @endif
+
+
+
+
+ @if($selectedRequest)
+
+
{{ __('mcp::mcp.logs.detail.title') }}
+
+
+
+
+
+
+
+ {{ __('mcp::mcp.logs.detail.status') }}
+
+ {{ $selectedRequest->response_status }}
+ {{ $selectedRequest->isSuccessful() ? __('mcp::mcp.logs.status_ok') : __('mcp::mcp.logs.status_error') }}
+
+
+
+
+
+
{{ __('mcp::mcp.logs.detail.request') }}
+
{{ json_encode($selectedRequest->request_body, JSON_PRETTY_PRINT) }}
+
+
+
+
+
{{ __('mcp::mcp.logs.detail.response') }}
+
{{ json_encode($selectedRequest->response_body, JSON_PRETTY_PRINT) }}
+
+
+ @if($selectedRequest->error_message)
+
+
{{ __('mcp::mcp.logs.detail.error') }}
+
{{ $selectedRequest->error_message }}
+
+ @endif
+
+
+
+
+ {{ __('mcp::mcp.logs.detail.replay_command') }}
+
+ {{ __('mcp::mcp.logs.detail.copy') }}
+ {{ __('mcp::mcp.logs.detail.copied') }}
+
+
+
{{ $selectedRequest->toCurl() }}
+
+
+
+
+
{{ __('mcp::mcp.logs.detail.metadata.request_id') }}: {{ $selectedRequest->request_id }}
+
{{ __('mcp::mcp.logs.detail.metadata.duration') }}: {{ $selectedRequest->duration_for_humans }}
+
{{ __('mcp::mcp.logs.detail.metadata.ip') }}: {{ $selectedRequest->ip_address ?? __('mcp::mcp.common.na') }}
+
{{ __('mcp::mcp.logs.detail.metadata.time') }}: {{ $selectedRequest->created_at->format('Y-m-d H:i:s') }}
+
+
+ @else
+
+
+
{{ __('mcp::mcp.logs.empty_detail') }}
+
+ @endif
+
+
+
+ {{-- Header --}}
+
+
+ {{ __('Tool Versions') }}
+ Manage MCP tool version lifecycles and backwards compatibility
+
+
+
+ Register Version
+
+
+
+
+ {{-- Stats Cards --}}
+
+
+
Total Versions
+
+ {{ number_format($this->stats['total_versions']) }}
+
+
+
+
Unique Tools
+
+ {{ number_format($this->stats['total_tools']) }}
+
+
+
+
Servers
+
+ {{ number_format($this->stats['servers']) }}
+
+
+
+
Deprecated
+
+ {{ number_format($this->stats['deprecated_count']) }}
+
+
+
+
Sunset
+
+ {{ number_format($this->stats['sunset_count']) }}
+
+
+
+
+ {{-- Filters --}}
+
+
+
+
+ All servers
+ @foreach ($this->servers as $serverId)
+ {{ $serverId }}
+ @endforeach
+
+
+ All statuses
+ Latest
+ Active (non-latest)
+ Deprecated
+ Sunset
+
+ @if($search || $server || $status)
+
Clear
+ @endif
+
+
+ {{-- Versions Table --}}
+
+
+ Tool
+ Server
+ Version
+ Status
+ Deprecated
+ Sunset
+ Created
+
+
+
+ @forelse ($this->versions as $version)
+
+
+ {{ $version->tool_name }}
+ @if($version->description)
+ {{ $version->description }}
+ @endif
+
+
+ {{ $version->server_id }}
+
+
+
+ {{ $version->version }}
+
+
+
+
+ {{ ucfirst($version->status) }}
+
+
+
+ @if($version->deprecated_at)
+ {{ $version->deprecated_at->format('M j, Y') }}
+ @else
+ -
+ @endif
+
+
+ @if($version->sunset_at)
+
+ {{ $version->sunset_at->format('M j, Y') }}
+
+ @else
+ -
+ @endif
+
+
+ {{ $version->created_at->format('M j, Y') }}
+
+
+
+
+
+ View Details
+
+ @if(!$version->is_latest && !$version->is_sunset)
+
+ Mark as Latest
+
+ @endif
+ @if(!$version->is_deprecated && !$version->is_sunset)
+
+ Deprecate
+
+ @endif
+
+
+
+
+ @empty
+
+
+
+
+
+
No tool versions found
+
Register tool versions to enable backwards compatibility.
+
+
+ @endforelse
+
+
+
+ @if($this->versions->hasPages())
+
+ {{ $this->versions->links() }}
+
+ @endif
+
+ {{-- Version Detail Modal --}}
+ @if($showVersionDetail && $this->selectedVersion)
+
+
+
+
+
{{ $this->selectedVersion->tool_name }}
+
+
+ {{ $this->selectedVersion->version }}
+
+
+ {{ ucfirst($this->selectedVersion->status) }}
+
+
+
+
+
+
+ {{-- Metadata --}}
+
+
+
Server
+
{{ $this->selectedVersion->server_id }}
+
+
+
Created
+
{{ $this->selectedVersion->created_at->format('Y-m-d H:i:s') }}
+
+ @if($this->selectedVersion->deprecated_at)
+
+
Deprecated
+
+ {{ $this->selectedVersion->deprecated_at->format('Y-m-d') }}
+
+
+ @endif
+ @if($this->selectedVersion->sunset_at)
+
+
Sunset
+
+ {{ $this->selectedVersion->sunset_at->format('Y-m-d') }}
+
+
+ @endif
+
+
+ @if($this->selectedVersion->description)
+
+
Description
+
{{ $this->selectedVersion->description }}
+
+ @endif
+
+ @if($this->selectedVersion->changelog)
+
+
Changelog
+
+ {!! nl2br(e($this->selectedVersion->changelog)) !!}
+
+
+ @endif
+
+ @if($this->selectedVersion->migration_notes)
+
+
+ Migration Notes
+
+
+ {!! nl2br(e($this->selectedVersion->migration_notes)) !!}
+
+
+ @endif
+
+ {{-- Input Schema --}}
+ @if($this->selectedVersion->input_schema)
+
+
Input Schema
+
{{ $this->formatSchema($this->selectedVersion->input_schema) }}
+
+ @endif
+
+ {{-- Output Schema --}}
+ @if($this->selectedVersion->output_schema)
+
+
Output Schema
+
{{ $this->formatSchema($this->selectedVersion->output_schema) }}
+
+ @endif
+
+ {{-- Version History --}}
+ @if($this->versionHistory->count() > 1)
+
+
Version History
+
+ @foreach($this->versionHistory as $index => $historyVersion)
+
+
+
+ {{ $historyVersion->version }}
+
+
+ {{ ucfirst($historyVersion->status) }}
+
+
+ {{ $historyVersion->created_at->format('M j, Y') }}
+
+
+ @if($historyVersion->id !== $this->selectedVersion->id && $index < $this->versionHistory->count() - 1)
+ @php $nextVersion = $this->versionHistory[$index + 1] @endphp
+
+ Compare
+
+ @endif
+
+ @endforeach
+
+
+ @endif
+
+ @endif
+
+ {{-- Compare Schemas Modal --}}
+ @if($showCompareModal && $this->schemaComparison)
+
+
+
+ Schema Comparison
+
+
+
+
+
+ {{ $this->schemaComparison['from']->version }}
+
+
+
+
+
+ {{ $this->schemaComparison['to']->version }}
+
+
+
+
+ @php $changes = $this->schemaComparison['changes'] @endphp
+
+ @if(empty($changes['added']) && empty($changes['removed']) && empty($changes['changed']))
+
+
+ No schema changes between versions
+
+
+ @else
+
+ @if(!empty($changes['added']))
+
+
+ Added Properties ({{ count($changes['added']) }})
+
+
+ @foreach($changes['added'] as $prop)
+ {{ $prop }}
+
+ @endif
+
+ @if(!empty($changes['removed']))
+
+
+ Removed Properties ({{ count($changes['removed']) }})
+
+
+ @foreach($changes['removed'] as $prop)
+ {{ $prop }}
+
+ @endif
+
+ @if(!empty($changes['changed']))
+
+
+ Changed Properties ({{ count($changes['changed']) }})
+
+
+ @foreach($changes['changed'] as $prop => $change)
+
+
{{ $prop }}
+
+
+
Before:
+
{{ json_encode($change['from'], JSON_PRETTY_PRINT) }}
+
+
+
After:
+
{{ json_encode($change['to'], JSON_PRETTY_PRINT) }}
+
+
+
+ @endforeach
+
+
+ @endif
+
+ @endif
+
+
+ Close
+
+
+ @endif
+
+ {{-- Deprecate Modal --}}
+ @if($showDeprecateModal)
+ @php $deprecateVersion = \Core\Mcp\Models\McpToolVersion::find($deprecateVersionId) @endphp
+ @if($deprecateVersion)
+
+
+
+ Deprecate Version
+
+
+
+
+ {{ $deprecateVersion->tool_name }} v{{ $deprecateVersion->version }}
+
+
+ Deprecated versions will show warnings to agents but remain usable until sunset.
+
+
+
+
+ Sunset Date (optional)
+
+ After this date, the version will be blocked and return errors.
+
+
+
+
+ Cancel
+
+ Deprecate Version
+
+
+
+ @endif
+ @endif
+
+ {{-- Register Version Modal --}}
+ @if($showRegisterModal)
+
+
+
+ Register Tool Version
+
+
+
+
+ @endif
+
+ {{ $server['name'] }} Analytics
+
+
+
+
+
+
+
Total Calls
+
{{ number_format($stats['total_calls']) }}
+
+
+
Success Rate
+
+ {{ $stats['success_rate'] }}%
+
+
+
+
Successful
+
{{ number_format($stats['successful_calls']) }}
+
+
+
Failed
+
{{ number_format($stats['failed_calls']) }}
+
+
+
Tool Usage
+
+ @foreach($stats['by_tool'] as $tool => $data)
+
+
+ {{ $tool }}
+
+
+ {{ $data['calls'] }} calls
+
+ {{ $data['success_rate'] }}% success
+
+ {{ $data['avg_duration_ms'] }}ms avg
+
+
+ @endforeach
+
+
+
Daily Activity
+
+ @foreach($stats['by_day'] as $date => $count)
+
+
{{ $date }}
+
+
+ @php
+ $maxCalls = max($stats['by_day']);
+ $width = $maxCalls > 0 ? ($count / $maxCalls) * 100 : 0;
+ @endphp
+
+
+
+
{{ $count }}
+
+ @endforeach
+
+
+
Error Breakdown
+
+ @foreach($stats['errors'] as $code => $count)
+
+ {{ $code ?: 'Unknown' }}
+ {{ $count }} occurrences
+
+ @endforeach
+
+
+ Time range:
+
+ @foreach([7, 14, 30] as $range)
+
+ {{ $range }} days
+
+ @endforeach
+
+
+
diff --git a/src/php/src/Website/Mcp/View/Blade/web/api-explorer.blade.php b/src/php/src/Website/Mcp/View/Blade/web/api-explorer.blade.php
new file mode 100644
index 0000000..cb87e4f
--- /dev/null
+++ b/src/php/src/Website/Mcp/View/Blade/web/api-explorer.blade.php
@@ -0,0 +1,219 @@
+
+
+
+
+
API Explorer
+
Interactive documentation with code snippets in 11 languages
+
+
+
+
+
+
+
+
+
API Key
+
+
+ Production
+ Homelab
+ Local
+
+
+
Enter your API key to enable live testing. Keys are not stored.
+
+
+
+
+
+
+
+
+
+
Endpoints
+
+
+ @foreach($endpoints as $index => $endpoint)
+
+
+
+ {{ $endpoint['method'] }}
+
+ {{ $endpoint['name'] }}
+
+ {{ $endpoint['path'] }}
+
+ @endforeach
+
+
+
+
+
+
+
+
+
+
Request
+
+
+
+
+ GET
+ POST
+ PUT
+ PATCH
+ DELETE
+
+
+
+ @if(in_array($method, ['POST', 'PUT', 'PATCH']))
+
+
+ Request Body (JSON)
+ Format
+
+
+
+ @endif
+
+
+ Send Request
+
+
+
+ Sending...
+
+
+
+
+
+
+
+
+
+
Code Snippet
+
+
+
+ Copy
+
+
+
+
+
+
+
+ @foreach($languages as $lang)
+
+ {{ $lang['name'] }}
+
+ @endforeach
+
+
+
+
+
+
+
+
+ @if($error)
+
+ @endif
+
+ @if($response)
+
+
+
+
Response
+
+ {{ $response['status'] }}
+
+
+
{{ $responseTime }}ms
+
+
+
{{ json_encode($response['body'], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) }}
+
+
+ @endif
+
+
+
+
+
+
+
+ @script
+
+ @endscript
+
+
+ @if(session('message'))
+
+
{{ session('message') }}
+
+ @endif
+
+
+
+
+
+ API Keys
+
+
+ Create API keys to authenticate HTTP requests to MCP servers.
+
+
+
+ Create Key
+
+
+
+
+
+ @if($keys->isEmpty())
+
+
+
+
No API Keys Yet
+
+ Create an API key to start making authenticated requests to MCP servers over HTTP.
+
+
+ Create Your First Key
+
+
+ @else
+
+
+
+
+ Name
+
+
+ Key
+
+
+ Scopes
+
+
+ Last Used
+
+
+ Expires
+
+
+ Actions
+
+
+
+
+ @foreach($keys as $key)
+
+
+ {{ $key->name }}
+
+
+
+ {{ $key->prefix }}_****
+
+
+
+
+ @foreach($key->scopes ?? [] as $scope)
+
+ {{ $scope }}
+
+ @endforeach
+
+
+
+ {{ $key->last_used_at?->diffForHumans() ?? 'Never' }}
+
+
+ @if($key->expires_at)
+ @if($key->expires_at->isPast())
+ Expired
+ @else
+ {{ $key->expires_at->diffForHumans() }}
+ @endif
+ @else
+ Never
+ @endif
+
+
+
+ Revoke
+
+
+
+ @endforeach
+
+
+ @endif
+
+
+
+
+
+
+
+
+
+ Include your API key in HTTP requests using one of these methods:
+
+
+
+
Authorization Header (recommended)
+
Authorization: Bearer hk_abc123_****
+
+
+
X-API-Key Header
+
X-API-Key: hk_abc123_****
+
+
+
+
+
+
+
+
+
+ Call an MCP tool via HTTP POST:
+
+ @php $mcpUrl = request()->getSchemeAndHttpHost(); @endphp
+
curl -X POST {{ $mcpUrl }}/tools/call \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "server": "openbrain",
+ "tool": "brain_recall",
+ "arguments": { "query": "recent decisions" }
+ }'
+
+
+
+
+
+
+
Create API Key
+
+
+
+
+
Key Name
+
+ @error('newKeyName')
+
{{ $message }}
+ @enderror
+
+
+
+
+
+
+
+ Expiration
+
+ Never expires
+ 30 days
+ 90 days
+ 1 year
+
+
+
+
+
+ Cancel
+ Create Key
+
+
+
+
+
+
+
+
+
+
API Key Created
+
+
+
+
+ Copy this key now. You won't be able to see it again.
+
+
+
+
+
{{ $newPlainKey }}
+
+
+
+
+
+ Done
+
+
+
+ Setup Guide
+
+ @php
+ $mcpUrl = request()->getSchemeAndHttpHost();
+ @endphp
+
+
+
+
Setup Guide
+
+ Connect AI agents to MCP servers via HTTP.
+
+
+
+
+
+
+
+
+
+
+
+
+
HTTP API
+
+ All platforms
+
+
+
+
+
+ Call MCP tools from any language, platform, or AI agent using standard HTTP requests.
+ Works with Claude Code, Cursor, custom agents, webhooks, and any HTTP client.
+
+
+
1. Get your API key
+
+ Create an API key from your admin dashboard. Keys use the hk_ prefix.
+
+
+
2. Discover available servers
+
curl {{ $mcpUrl }}/servers.json \
+ -H "Authorization: Bearer YOUR_API_KEY"
+
+
3. Call a tool
+
curl -X POST {{ $mcpUrl }}/tools/call \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "server": "openbrain",
+ "tool": "brain_recall",
+ "arguments": { "query": "authentication decisions" }
+ }'
+
+
4. Read a resource
+
curl {{ $mcpUrl }}/resources/plans://all \
+ -H "Authorization: Bearer YOUR_API_KEY"
+
+
+
+
+
+ GET /.well-known/mcp-servers.json
+ Agent discovery
+
+
+ GET /servers
+ List all servers
+
+
+ GET /servers/{id}
+ Server details + tools
+
+
+ POST /tools/call
+ Execute a tool
+
+
+ GET /resources/{uri}
+ Read a resource
+
+
+
+
+
+
+
+
+
+
+
+
Code Examples
+
+
+
+
+
+
+
Python
+
import requests
+
+resp = requests.post(
+ "{{ $mcpUrl }}/tools/call",
+ headers={"Authorization": "Bearer hk_your_key"},
+ json={
+ "server": "openbrain",
+ "tool": "brain_recall",
+ "arguments": {"query": "recent decisions"}
+ }
+)
+print(resp.json())
+
+
+
+
+
JavaScript
+
const resp = await fetch("{{ $mcpUrl }}/tools/call", {
+ method: "POST",
+ headers: {
+ "Authorization": "Bearer hk_your_key",
+ "Content-Type": "application/json",
+ },
+ body: JSON.stringify({
+ server: "openbrain",
+ tool: "brain_recall",
+ arguments: { query: "recent decisions" },
+ }),
+});
+const data = await resp.json();
+
+
+
+
+
+
+
Authentication
+
+
+
+
Authorization Header (Recommended)
+
Authorization: Bearer hk_abc123_your_key_here
+
+
+
+
X-API-Key Header
+
X-API-Key: hk_abc123_your_key_here
+
+
+
+
+
Server-scoped keys
+
+ API keys can be restricted to specific MCP servers. If you get a 403 error,
+ check your key's server scopes in your admin dashboard.
+
+
+
+
+
Rate limiting
+
+ Requests are rate limited to 120 per minute. Rate limit headers
+ (X-RateLimit-Limit, X-RateLimit-Remaining)
+ are included in all responses.
+
+
+
+
+
+
+
Discovery
+
+ Agents discover available servers automatically via the well-known endpoint:
+
+
curl {{ $mcpUrl }}/.well-known/mcp-servers.json
+
+ Returns the server registry with capabilities and connection details.
+ No authentication required for discovery.
+
+
+
+
+
+
Need help setting up?
+
+
+ Browse Servers
+
+
+ OpenAPI Spec
+
+
+
+
diff --git a/src/php/src/Website/Mcp/View/Blade/web/dashboard.blade.php b/src/php/src/Website/Mcp/View/Blade/web/dashboard.blade.php
new file mode 100644
index 0000000..f530059
--- /dev/null
+++ b/src/php/src/Website/Mcp/View/Blade/web/dashboard.blade.php
@@ -0,0 +1,283 @@
+
+
+
+
+ Upstream Intelligence
+ Track vendor updates and manage porting tasks
+
+
+ Refresh
+
+
+
+
+
+
+ Vendors
+ {{ $this->stats['total_vendors'] }}
+
+
+ Pending
+ {{ $this->stats['pending_todos'] }}
+
+
+ Quick Wins
+ {{ $this->stats['quick_wins'] }}
+
+
+ Security
+ {{ $this->stats['security_updates'] }}
+
+
+ In Progress
+ {{ $this->stats['in_progress'] }}
+
+
+ This Week
+ {{ $this->stats['recent_releases'] }}
+
+
+
+
+
+
+ Tracked Vendors
+
+
+
+ @foreach($this->vendors as $vendor)
+
+
+ {{ $vendor->getSourceTypeIcon() }}
+ {{ $vendor->name }}
+
+
+
{{ $vendor->vendor_name }} · {{ $vendor->getSourceTypeLabel() }}
+
Version: {{ $vendor->current_version ?? 'Not set' }}
+
+ {{ $vendor->todos_count }} todos
+ {{ $vendor->releases_count }} releases
+
+
+
+ @endforeach
+
+
+
+
+
+
+
+
+ All Vendors
+ @foreach($this->vendors as $vendor)
+ {{ $vendor->name }}
+ @endforeach
+
+
+
+ All Status
+ Pending
+ In Progress
+ Ported
+ Skipped
+
+
+
+ All Types
+ Feature
+ Bugfix
+ Security
+ UI
+ Block
+ API
+
+
+
+ All Effort
+ Low (<1hr)
+ Medium (1-4hr)
+ High (4+hr)
+
+
+
+
+
+
+
+
+ Porting Tasks
+ {{ $this->todos->total() }} total
+
+
+
+
+ Type
+ Title
+ Vendor
+ Priority
+ Effort
+ Status
+ Actions
+
+
+ @forelse($this->todos as $todo)
+
+
+ {{ $todo->getTypeIcon() }}
+
+
+
+
{{ $todo->title }}
+ @if($todo->description)
+
{{ Str::limit($todo->description, 80) }}
+ @endif
+
+
+ {{ $todo->vendor->name }}
+
+
+
+ {{ $todo->priority }}/10
+
+
+
+
+ {{ $todo->getEffortLabel() }}
+
+
+
+
+ {{ str_replace('_', ' ', $todo->status) }}
+
+
+
+ @if($todo->status === 'pending')
+ Start
+ @elseif($todo->status === 'in_progress')
+
+ Done
+ Skip
+
+ @endif
+
+
+ @empty
+
+
+ No todos found matching filters
+
+
+ @endforelse
+
+
+
+ @if($this->todos->hasPages())
+
+ {{ $this->todos->links() }}
+
+ @endif
+
+
+
+
+
+
+
+
Asset Library
+
+ @if($this->assetStats['updates_available'] > 0)
+ {{ $this->assetStats['updates_available'] }} updates
+ @endif
+ {{ $this->assetStats['total'] }} assets
+
+
+
+
+ @foreach($this->assets as $asset)
+
+
+
{{ $asset->getTypeIcon() }}
+
+
{{ $asset->name }}
+
+ @if($asset->package_name)
+ {{ $asset->package_name }}
+ @endif
+
+
+
+
+ {{ $asset->getLicenseIcon() }}
+ @if($asset->installed_version)
+
+ {{ $asset->installed_version }}
+ @if($asset->hasUpdate())
+ → {{ $asset->latest_version }}
+ @endif
+
+ @else
+ Not installed
+ @endif
+
+
+ @endforeach
+
+
+
+
+
+
+
+ Pattern Library
+ {{ $this->assetStats['patterns'] }} patterns
+
+
+
+ @foreach($this->patterns as $pattern)
+
+
+ {{ $pattern->getCategoryIcon() }}
+ {{ $pattern->name }}
+
+
{{ $pattern->description }}
+
+ {{ $pattern->language }}
+ @if($pattern->is_vetted)
+ Vetted
+ @endif
+
+
+ @endforeach
+
+
+
+
+
+
+
+
+ Recent Activity
+
+
+
+ @forelse($this->recentLogs as $log)
+
+ {{ $log->getActionIcon() }}
+ {{ $log->created_at->diffForHumans() }}
+ {{ $log->getActionLabel() }}
+ ·
+ {{ $log->vendor->name }}
+ @if($log->error_message)
+ Error
+ @endif
+
+ @empty
+
No recent activity
+ @endforelse
+
+
+
+
+ MCP Servers
+
+
+
MCP Servers
+
+ All available MCP servers for AI agent integration.
+
+
+ @forelse($servers as $server)
+
+
+
+
+
+ @switch($server['id'])
+ @case('hosthub-agent')
+
+
+
+ {{ $server['name'] }}
+
+
{{ $server['id'] }}
+
+
+
+ {{ ucfirst($server['status'] ?? 'available') }}
+
+
+
+
+ {{ $server['tagline'] ?? $server['description'] ?? '' }}
+
+
+
+
+
+
+
+
+ @if(($server['workflow_count'] ?? 0) > 0)
+
+
+ @endif
+
+
+
+
+
+ @empty
+
+
+
No MCP servers available.
+
+ @endforelse
+
+
Planned Servers
+
+ @foreach($plannedServers as $server)
+
+
+
+ @switch($server['id'])
+ @case('upstream')
+
+
{{ $server['name'] }}
+
+
{{ $server['tagline'] ?? '' }}
+
+ @endforeach
+
+
diff --git a/src/php/src/Website/Mcp/View/Blade/web/keys.blade.php b/src/php/src/Website/Mcp/View/Blade/web/keys.blade.php
new file mode 100644
index 0000000..92ff915
--- /dev/null
+++ b/src/php/src/Website/Mcp/View/Blade/web/keys.blade.php
@@ -0,0 +1,6 @@
+
+ API Keys
+ Manage API keys for MCP server access.
+
+
diff --git a/src/php/src/Website/Mcp/View/Blade/web/landing.blade.php b/src/php/src/Website/Mcp/View/Blade/web/landing.blade.php
new file mode 100644
index 0000000..5da9bfe
--- /dev/null
+++ b/src/php/src/Website/Mcp/View/Blade/web/landing.blade.php
@@ -0,0 +1,214 @@
+
+ MCP Portal
+ Connect AI agents to platform infrastructure via Model Context Protocol. Machine-readable, agent-optimised, human-friendly.
+
+
+
+
+ MCP Ecosystem
+
+
+ Connect AI agents to platform infrastructure via MCP.Machine-readable •
+ Agent-optimised •
+ Human-friendly
+
+
+
+ Browse Servers
+
+
+ Setup Guide
+
+
+
+ Coming Soon
+
+ @foreach($plannedServers as $server)
+
+
+
+ @switch($server['id'])
+ @case('analyticshost')
+
+
+ Planned
+
+
+
+ {{ $server['name'] }}
+
+
+ {{ $server['tagline'] ?? '' }}
+
+
+ @endforeach
+
+ @endif
+
+
+ @php
+ $mcpUrl = request()->getSchemeAndHttpHost();
+ @endphp
+
+ Quick Start
+
+ Call MCP tools via HTTP with your API key:
+
+ curl -X POST {{ $mcpUrl }}/tools/call \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "server": "openbrain",
+ "tool": "brain_recall",
+ "arguments": { "query": "recent decisions" }
+ }'
+
+ Full Setup Guide
+
+
+ OpenAPI Spec
+
+
+
+
diff --git a/src/php/src/Website/Mcp/View/Blade/web/mcp-metrics.blade.php b/src/php/src/Website/Mcp/View/Blade/web/mcp-metrics.blade.php
new file mode 100644
index 0000000..fd550bc
--- /dev/null
+++ b/src/php/src/Website/Mcp/View/Blade/web/mcp-metrics.blade.php
@@ -0,0 +1,309 @@
+
+
+
+
+ MCP Agent Metrics
+ Monitor tool usage, performance, and errors
+
+
+
+ 7 Days
+ 14 Days
+ 30 Days
+
+ Refresh
+
+
+
+
+
+
+ Total Calls
+ {{ number_format($this->overview['total_calls']) }}
+ @if($this->overview['calls_trend_percent'] != 0)
+
+ {{ $this->overview['calls_trend_percent'] > 0 ? '+' : '' }}{{ $this->overview['calls_trend_percent'] }}%
+
+ @endif
+
+
+ Success Rate
+ {{ $this->overview['success_rate'] }}%
+
+
+ Successful
+ {{ number_format($this->overview['success_calls']) }}
+
+
+ Errors
+ {{ number_format($this->overview['error_calls']) }}
+
+
+ Avg Duration
+ {{ $this->overview['avg_duration_ms'] < 1000 ? $this->overview['avg_duration_ms'] . 'ms' : round($this->overview['avg_duration_ms'] / 1000, 2) . 's' }}
+
+
+ Unique Tools
+ {{ $this->overview['unique_tools'] }}
+
+
+
+
+
+
+
+ Overview
+
+
+ Performance
+
+
+ Errors
+
+
+ Activity Feed
+
+
+
+
+ @if($activeTab === 'overview')
+
+
+
+
+ Daily Call Volume
+
+
+
+ @foreach($this->dailyTrend as $day)
+
+
{{ $day['date_formatted'] }}
+
+
+ @php
+ $maxCalls = collect($this->dailyTrend)->max('total_calls') ?: 1;
+ $successWidth = ($day['total_success'] / $maxCalls) * 100;
+ $errorWidth = ($day['total_errors'] / $maxCalls) * 100;
+ @endphp
+
+
+
{{ $day['total_calls'] }}
+
+
+ @endforeach
+
+
+
+
+
+
+
+ Top Tools
+
+
+
+ @forelse($this->topTools as $tool)
+
+
+ {{ $tool->tool_name }}
+ {{ $tool->server_id }}
+
+
+
+ {{ $tool->success_rate }}%
+
+ {{ number_format($tool->total_calls) }}
+
+
+ @empty
+
No tool calls recorded yet
+ @endforelse
+
+
+
+
+
+
+
+ Server Breakdown
+
+
+ @forelse($this->serverStats as $server)
+
+
+ {{ $server->server_id }}
+ {{ $server->unique_tools }} tools
+
+
+ {{ number_format($server->total_success) }}
+ {{ number_format($server->total_errors) }}
+ {{ number_format($server->total_calls) }}
+
+
+ @empty
+
No servers active yet
+ @endforelse
+
+
+
+
+
+
+ Plan Activity
+
+
+ @forelse($this->planActivity as $plan)
+
+
+ {{ $plan->plan_slug }}
+ {{ $plan->unique_tools }} tools
+
+
+
+ {{ $plan->success_rate }}%
+
+ {{ number_format($plan->call_count) }}
+
+
+ @empty
+
No plan activity recorded
+ @endforelse
+
+
+
+ @endif
+
+ @if($activeTab === 'performance')
+
+
+
+
+ Tool Performance (p50 / p95 / p99)
+
+
+
+
+
+ Tool
+ Calls
+ Min
+ Avg
+ p50
+ p95
+ p99
+ Max
+
+
+
+ @forelse($this->toolPerformance as $tool)
+
+ {{ $tool['tool_name'] }}
+ {{ number_format($tool['call_count']) }}
+ {{ $tool['min_ms'] }}ms
+ {{ round($tool['avg_ms']) }}ms
+ {{ round($tool['p50_ms']) }}ms
+ {{ round($tool['p95_ms']) }}ms
+ {{ round($tool['p99_ms']) }}ms
+ {{ $tool['max_ms'] }}ms
+
+ @empty
+
+ No performance data recorded yet
+
+ @endforelse
+
+
+
+
+
+
+
+
+ Hourly Distribution (Last 24 Hours)
+
+
+
+ @php $maxHourly = collect($this->hourlyDistribution)->max('call_count') ?: 1; @endphp
+ @foreach($this->hourlyDistribution as $hour)
+
+
+
{{ $hour['hour_formatted'] }}
+
+ @endforeach
+
+
+
+
+ @endif
+
+ @if($activeTab === 'errors')
+
+
+ Error Breakdown
+
+
+
+
+
+ Tool
+ Error Code
+ Count
+
+
+
+ @forelse($this->errorBreakdown as $error)
+
+ {{ $error->tool_name }}
+
+
+ {{ $error->error_code ?? 'unknown' }}
+
+
+ {{ number_format($error->error_count) }}
+
+ @empty
+
+ No errors recorded - all systems healthy
+
+ @endforelse
+
+
+
+
+ @endif
+
+ @if($activeTab === 'activity')
+
+
+ Recent Activity
+
+
+ @forelse($this->recentCalls as $call)
+
+
+
+
+
{{ $call['tool_name'] }}
+ @if($call['plan_slug'])
+
@ {{ $call['plan_slug'] }}
+ @endif
+ @if(!$call['success'] && $call['error_message'])
+
{{ Str::limit($call['error_message'], 80) }}
+ @endif
+
+
+
+ {{ $call['duration'] }}
+ {{ $call['created_at'] }}
+
+
+ @empty
+
No activity recorded yet
+ @endforelse
+
+
+ @endif
+
+
+
+
+
MCP Tool Playground
+
Test MCP tool calls with custom parameters
+
+
+
+
+
+
+
Request
+
+
+
+ Server
+
+ Select a server...
+ @foreach($servers as $server)
+
+ {{ $server['name'] }} ({{ $server['tool_count'] }} tools)
+
+ @endforeach
+
+
+
+
+
+
Tool
+
+ Select a tool...
+ @foreach($tools as $tool)
+
+ {{ $tool['name'] }}
+
+ @endforeach
+
+ @if($selectedTool)
+ @php $currentTool = collect($tools)->firstWhere('name', $selectedTool); @endphp
+ @if($currentTool && !empty($currentTool['purpose']))
+
{{ $currentTool['purpose'] }}
+ @endif
+ @endif
+
+
+
+
+
+ Parameters (JSON)
+
+ Format JSON
+
+
+
+ @error('inputJson')
+
{{ $message }}
+ @enderror
+
+
+
+
+ Execute Tool
+
+
+
+ Executing...
+
+
+
+
+
+
+
+
+
+
Response
+ @if($executionTime > 0)
+ {{ $executionTime }}ms
+ @endif
+
+
+ @if($lastError)
+
+
+
+
+
Error
+
{{ $lastError }}
+
+
+
+ @endif
+
+
+
@if($lastResult){{ json_encode($lastResult, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) }}@else// Response will appear here... @endif
+
+
+
+
+
+
+ @if($selectedTool && !empty($tools))
+ @php $currentTool = collect($tools)->firstWhere('name', $selectedTool); @endphp
+ @if($currentTool && !empty($currentTool['parameters']))
+
+
+
Parameter Reference
+
+
+
+
+ Name
+ Type
+ Required
+ Description
+
+
+
+ @foreach($currentTool['parameters'] as $paramName => $paramDef)
+
+ {{ $paramName }}
+ {{ is_array($paramDef) ? ($paramDef['type'] ?? 'string') : 'string' }}
+
+ @if(is_array($paramDef) && ($paramDef['required'] ?? false))
+ Required
+ @else
+ Optional
+ @endif
+
+ {{ is_array($paramDef) ? ($paramDef['description'] ?? '-') : $paramDef }}
+
+ @endforeach
+
+
+
+
+
+ @endif
+ @endif
+
+
+
+
+
+
+
Playground
+
+ Test MCP tools interactively and execute requests live.
+
+
+
+ {{-- Error Display --}}
+ @if($error)
+
+ @endif
+
+
+
+
+
+
+
Authentication
+
+
+
+
+
+
+
+ Validate Key
+
+
+ @if($keyStatus === 'valid')
+
+
+ @elseif($keyStatus === 'invalid')
+
+
+ @elseif($keyStatus === 'expired')
+
+
+ @elseif($keyStatus === 'empty')
+
+ Enter a key to validate
+
+ @endif
+
+
+ @if($keyInfo)
+
+
+
+ Name:
+ {{ $keyInfo['name'] }}
+
+
+ Workspace:
+ {{ $keyInfo['workspace'] }}
+
+
+ Scopes:
+ {{ implode(', ', $keyInfo['scopes'] ?? []) }}
+
+
+ Last used:
+ {{ $keyInfo['last_used'] }}
+
+
+
+ @elseif(!$isAuthenticated && !$apiKey)
+
+
+ Sign in
+ to create API keys, or paste an existing key above.
+
+
+ @endif
+
+
+
+
+
+
Select Tool
+
+
+
+ @foreach($servers as $server)
+ {{ $server['name'] }}
+ @endforeach
+
+
+ @if($selectedServer && count($tools) > 0)
+
+ @foreach($tools as $tool)
+ {{ $tool['name'] }}
+ @endforeach
+
+ @endif
+
+
+
+
+ @if($toolSchema)
+
+
+
{{ $toolSchema['name'] }}
+
{{ $toolSchema['description'] ?? $toolSchema['purpose'] ?? '' }}
+
+
+ @php
+ $params = $toolSchema['inputSchema']['properties'] ?? $toolSchema['parameters'] ?? [];
+ $required = $toolSchema['inputSchema']['required'] ?? [];
+ @endphp
+
+ @if(count($params) > 0)
+
+
Arguments
+
+ @foreach($params as $name => $schema)
+
+ @php
+ $paramRequired = in_array($name, $required) || ($schema['required'] ?? false);
+ $paramType = is_array($schema['type'] ?? 'string') ? ($schema['type'][0] ?? 'string') : ($schema['type'] ?? 'string');
+ @endphp
+
+ @if(isset($schema['enum']))
+
+ @foreach($schema['enum'] as $option)
+ {{ $option }}
+ @endforeach
+
+ @elseif($paramType === 'boolean')
+
+ true
+ false
+
+ @elseif($paramType === 'integer' || $paramType === 'number')
+
+ @endforeach
+
+ @else
+
This tool has no arguments.
+ @endif
+
+
+
+
+ @if($keyStatus === 'valid')
+ Execute Request
+ @else
+ Generate Request
+ @endif
+
+ Executing...
+
+
+
+ @endif
+
+
+
+
+
+
Response
+
+ @if($response)
+
+
+
+ Copy
+ Copied
+
+
+
{{ $response }}
+
+ @else
+
+
+
Select a server and tool to get started.
+
+ @endif
+
+
+
+
+
API Reference
+
+
+ Endpoint:
+ {{ request()->getSchemeAndHttpHost() }}/tools/call
+
+
+ Method:
+ POST
+
+
+ Auth:
+ @if($keyStatus === 'valid')
+ Bearer {{ Str::limit($apiKey, 20, '...') }}
+ @else
+ Bearer <your-api-key>
+ @endif
+
+
+ Content-Type:
+ application/json
+
+
+
+
+
+
+
+
+
Request Log
+
+ View API requests and generate curl commands to replay them.
+
+
+
+
+
+
+
+ Server
+
+ All servers
+ @foreach($servers as $server)
+ {{ $server }}
+ @endforeach
+
+
+
+ Status
+
+ All
+ Success
+ Failed
+
+
+
+
+
+
+
+
+
+ @forelse($requests as $request)
+
+
+
+
+ {{ $request->response_status }}
+
+
+ {{ $request->server_id }}/{{ $request->tool_name }}
+
+
+
+ {{ $request->duration_for_humans }}
+
+
+ {{ $request->created_at->diffForHumans() }}
+ ·
+ {{ $request->request_id }}
+
+
+ @empty
+
+ No requests found.
+
+ @endforelse
+
+
+ @if($requests->hasPages())
+
+ {{ $requests->links() }}
+
+ @endif
+
+
+
+
+ @if($selectedRequest)
+
+
Request Detail
+
+
+
+
+
+
+
+ Status
+
+ {{ $selectedRequest->response_status }}
+ {{ $selectedRequest->isSuccessful() ? 'OK' : 'Error' }}
+
+
+
+
+
+
Request
+
{{ json_encode($selectedRequest->request_body, JSON_PRETTY_PRINT) }}
+
+
+
+
+
Response
+
{{ json_encode($selectedRequest->response_body, JSON_PRETTY_PRINT) }}
+
+
+ @if($selectedRequest->error_message)
+
+
Error
+
{{ $selectedRequest->error_message }}
+
+ @endif
+
+
+
+
+ Replay Command
+
+ Copy
+ Copied
+
+
+
{{ $selectedRequest->toCurl() }}
+
+
+
+
+
Request ID: {{ $selectedRequest->request_id }}
+
Duration: {{ $selectedRequest->duration_for_humans }}
+
IP: {{ $selectedRequest->ip_address ?? 'N/A' }}
+
Time: {{ $selectedRequest->created_at->format('Y-m-d H:i:s') }}
+
+
+ @else
+
+
+
Select a request to view details and generate replay commands.
+
+ @endif
+
+
+
+ {{ $server['name'] }}
+ {{ $server['tagline'] ?? $server['description'] ?? '' }}
+
+
+
+
+
+ ← Back to Servers
+
+
+
+
+
+
+ @switch($server['id'])
+ @case('hosthub-agent')
+
+
+
{{ $server['name'] }}
+
{{ $server['id'] }}
+
+
+
+ {{ ucfirst($server['status'] ?? 'available') }}
+
+
+
+
+ {{ $server['tagline'] ?? '' }}
+
+
+
About
+
+ {!! nl2br(e($server['description'])) !!}
+
+
+ @if(!empty($server['use_when']))
+
+
+
+
+ @foreach($server['use_when'] as $item)
+ • {{ $item }}
+ @endforeach
+
+
+ @endif
+
+ @if(!empty($server['dont_use_when']))
+
+
+
+
+ @foreach($server['dont_use_when'] as $item)
+ • {{ $item }}
+ @endforeach
+
+
+ @endif
+
+
Connection
+
+ Call tools on this server via HTTP:
+
+
curl -X POST {{ $mcpUrl }}/tools/call \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "server": "{{ $server['id'] }}",
+ "tool": "{{ !empty($server['tools']) ? $server['tools'][0]['name'] : 'tool_name' }}",
+ "arguments": {}
+ }'
+
+
+ Full setup guide →
+
+
+
+
+ Tools ({{ count($server['tools']) }})
+
+
+ @foreach($server['tools'] as $tool)
+
+
+
+ {{ $tool['name'] }}
+
+
+
+ {{ $tool['purpose'] ?? '' }}
+
+
+ @if(!empty($tool['example_prompts']))
+
+
Example prompts:
+
+ @foreach(array_slice($tool['example_prompts'], 0, 3) as $prompt)
+ "{{ $prompt }}"
+ @endforeach
+
+
+ @endif
+
+ @if(!empty($tool['parameters']))
+
+
+ Parameters
+
+
+ @foreach($tool['parameters'] as $name => $param)
+
+
{{ $name }}
+ @if(!empty($param['required']))
+
*
+ @endif
+
+ {{ is_array($param['type'] ?? '') ? implode('|', $param['type']) : ($param['type'] ?? 'string') }}
+
+ @if(!empty($param['description']))
+
{{ $param['description'] }}
+ @endif
+
+ @endforeach
+
+ @endif
+
+ @endforeach
+
+
+
+ Resources ({{ count($server['resources']) }})
+
+
+ @foreach($server['resources'] as $resource)
+
+
+
+
{{ $resource['uri'] }}
+
{{ $resource['purpose'] ?? $resource['name'] ?? '' }}
+
+
+ @endforeach
+
+
+
+ Workflows ({{ count($server['workflows']) }})
+
+
+ @foreach($server['workflows'] as $workflow)
+
+
{{ $workflow['name'] }}
+
{{ $workflow['description'] ?? '' }}
+ @if(!empty($workflow['steps']))
+
+ @foreach($workflow['steps'] as $index => $step)
+
+ {{ $step['action'] }}
+ @if(!empty($step['note']))
+ — {{ $step['note'] }}
+ @endif
+
+ @endforeach
+
+ @endif
+
+ @endforeach
+
+
diff --git a/src/php/src/Website/Mcp/View/Blade/web/unified-search.blade.php b/src/php/src/Website/Mcp/View/Blade/web/unified-search.blade.php
new file mode 100644
index 0000000..db7d1b3
--- /dev/null
+++ b/src/php/src/Website/Mcp/View/Blade/web/unified-search.blade.php
@@ -0,0 +1,202 @@
+
+
+
+
+
Search
+
Find tools, endpoints, patterns, and more across the system
+
+
+
+
+
+
+
+
+
+
Filter:
+ @foreach($this->types as $typeKey => $typeInfo)
+
+ @if($typeInfo['icon'] === 'wrench')
+ {{ $this->resultCountsByType[$typeKey] }}
+ @endif
+
+ @endforeach
+
+ @if(count($selectedTypes) > 0)
+
+ Clear filters
+
+ @endif
+
+
+
+
+
+ @if(strlen($query) >= 2)
+
+
+
+ @if($this->results->count() > 0)
+
+ Showing {{ $this->results->count() }} result{{ $this->results->count() !== 1 ? 's' : '' }}
+
+ @endif
+ @else
+
+
+
+
+
Start searching
+
Type at least 2 characters to search across all system components.
+
+ @foreach($this->types as $typeKey => $typeInfo)
+
+ {{ $typeInfo['name'] }}
+
+ @endforeach
+
+
+ @endif
+
+
+
+
+