Skip to main content
Glama
MarlonJD

web-debug-mcp

by MarlonJD
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Detect web project eligibility

web_project_detect
Read-onlyIdempotent

Find the exact web project root by inspecting directories. Separate confirmed markers from weak dependencies and report bounded workspace candidates without starting a process.

Instructions

Inspect the exact root, distinguish confirmed application markers from weak dependency candidates, and report bounded workspace candidates without starting a process or selecting a child.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
projectRootNo/app

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYes
dataNo
errorNo
warningsYes
artifactsYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed7 schema fields changedv0.7.0
    • removedOutput schema / definitions / __schema1
      Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "number"
-    },
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    },
-    {
-      "items": {
-        "$ref": "#/definitions/__schema1"
-      },
-      "type": "array"
-    },
-    {
-      "additionalProperties": {
-        "$ref": "#/definitions/__schema1"
-      },
-      "propertyNames": {
-        "type": "string"
-      },
-      "type": "object"
-    }
-  ]
-}
    • addedOutput schema / properties / data / additionalProperties
      Added value: +false
    • removedOutput schema / properties / data / allOf
      Removed value: -[
-  {
-    "$ref": "#/definitions/__schema0"
-  }
-]
    • addedOutput schema / properties / data / properties
      Added value: +{
+  "ambiguous": {
+    "type": "boolean"
+  },
+  "confidence": {
+    "enum": [
+      "high",
+      "medium",
+      "low",
+      "none"
+    ],
+    "type": "string"
+  },
+  "frameworkDetections": {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "confidence": {
+          "enum": [
+            "high",
+            "medium",
+            "low"
+          ],
+          "type": "string"
+        },
+        "framework": {
+          "enum": [
+            "vanilla",
+            "react",
+            "angular",
+            "vue",
+            "vite",
+            "next"
+          ],
+          "type": "string"
+        },
+        "provenance": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "source": {
+                "enum": [
+                  "config",
+                  "entry",
+                  "script",
+                  "dependency",
+                  "devDependency",
+                  "peerDependency"
+                ],
+                "type": "string"
+              },
+              "value": {
+                "maxLength": 300,
+                "type": "string"
+              }
+            },
+            "required": [
+              "source",
+              "value"
+            ],
+            "type": "object"
+          },
+          "maxItems": 8,
+          "type": "array"
+        },
+        "selected": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "framework",
+        "confidence",
+        "selected",
+        "provenance"
+      ],
+      "type": "object"
+    },
+    "maxItems": 6,
+    "type": "array"
+  },
+  "frameworks": {
+    "items": {
+      "enum": [
+        "vanilla",
+        "react",
+        "angular",
+        "vue",
+        "vite",
+        "next"
+      ],
+      "type": "string"
+    },
+    "maxItems": 6,
+    "type": "array"
+  },
+  "kind": {
+    "enum": [
+      "application",
+      "workspace",
+      "library",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "markers": {
+    "items": {
+      "maxLength": 300,
+      "type": "string"
+    },
+    "maxItems": 32,
+    "type": "array"
+  },
+  "packageManager": {
+    "anyOf": [
+      {
+        "enum": [
+          "npm",
+          "pnpm",
+          "yarn",
+          "bun"
+        ],
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "projectCapabilities": {
+    "additionalProperties": false,
+    "properties": {
+      "angular": {
+        "type": "boolean"
+      },
+      "browserTarget": {
+        "type": "boolean"
+      },
+      "next": {
+        "type": "boolean"
+      },
+      "react": {
+        "type": "boolean"
+      },
+      "serverRuntime": {
+        "type": "boolean"
+      },
+      "vite": {
+        "type": "boolean"
+      },
+      "vue": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "browserTarget",
+      "react",
+      "angular",
+      "vue",
+      "vite",
+      "next",
+      "serverRuntime"
+    ],
+    "type": "object"
+  },
+  "projectRoot": {
+    "maxLength": 4096,
+    "type": "string"
+  },
+  "schemaVersion": {
+    "const": 2,
+    "type": "number"
+  },
+  "warnings": {
+    "items": {
+      "maxLength": 500,
+      "type": "string"
+    },
+    "maxItems": 20,
+    "type": "array"
+  },
+  "workspace": {
+    "additionalProperties": false,
+    "properties": {
+      "candidates": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "ambiguous": {
+              "type": "boolean"
+            },
+            "confidence": {
+              "enum": [
+                "high",
+                "medium",
+                "low",
+                "none"
+              ],
+              "type": "string"
+            },
+            "frameworks": {
+              "items": {
+                "enum": [
+                  "vanilla",
+                  "react",
+                  "angular",
+                  "vue",
+                  "vite",
+                  "next"
+                ],
+                "type": "string"
+              },
+              "maxItems": 6,
+              "type": "array"
+            },
+            "markers": {
+              "items": {
+                "maxLength": 300,
+                "type": "string"
+              },
+              "maxItems": 12,
+              "type": "array"
+            },
+            "projectRoot": {
+              "maxLength": 4096,
+              "type": "string"
+            }
+          },
+          "required": [
+            "projectRoot",
+            "frameworks",
+            "confidence",
+            "ambiguous",
+            "markers"
+          ],
+          "type": "object"
+        },
+        "maxItems": 32,
+        "type": "array"
+      },
+      "declared": {
+        "type": "boolean"
+      },
+      "truncated": {
+        "type": "boolean"
+      },
+      "unsupportedPatterns": {
+        "items": {
+          "maxLength": 300,
+          "type": "string"
+        },
+        "maxItems": 32,
+        "type": "array"
+      }
+    },
+    "required": [
+      "declared",
+      "candidates",
+      "truncated",
+      "unsupportedPatterns"
+    ],
+    "type": "object"
+  }
+}
    • addedOutput schema / properties / data / required
      Added value: +[
+  "schemaVersion",
+  "projectRoot",
+  "packageManager",
+  "kind",
+  "frameworks",
+  "markers",
+  "confidence",
+  "ambiguous",
+  "frameworkDetections",
+  "workspace",
+  "projectCapabilities",
+  "warnings"
+]
    • addedOutput schema / properties / data / type
      Added value: +"object"
    • changedOutput schema / properties / error / properties / details / allOf
      Previous value: -[
-  {
-    "$ref": "#/definitions/__schema1"
-  }
-]New value: +[
+  {
+    "$ref": "#/definitions/__schema0"
+  }
+]
  2. First observedv0.5.0-next.0

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint false. The description adds useful behavioral detail by stating it inspects 'the exact root' and does not start a process or select a child, giving the agent confidence about non-side-effecting behavior. It does not contradict the annotations and adds meaningful behavioral nuance beyond them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no filler and begins with the key action, 'Inspect'. It packs multiple clauses – root inspection, marker distinction, candidate reporting, and non-actions – efficiently. It could be clearer if split, but it earns its space.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the output schema is present and annotations cover side-effecting safety, the description provides enough context for a low-complexity read-only tool: it reports candidates without side effects. It lacks explicit when-to-use guidance, but the title, siblings, and non-action phrasing fill most gaps. The description is close to complete for a tool of this simplicity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 0% description coverage for projectRoot, so the description must compensate. The phrase 'Inspect the exact root' connects loosely to projectRoot but does not explain path format, whether it is absolute or relative, or the significance of the default '/app'. For a single self-named parameter this is minimally adequate but lacks real semantic depth.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names specific actions – 'inspect', 'distinguish', 'report' – and a clear resource, the project root. It also distinguishes itself from sibling tools by stating it works 'without starting a process or selecting a child', which separates it from session-start and child-inspection tools. The language is somewhat technical ('bounded workspace candidates'), but the core purpose is clear.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies a pre-flight or eligibility-inspection step and explicitly says it does not start a process or select a child. However, it never directly states when to use this tool versus siblings such as web_session_start or web_next_inspect, so the agent must infer the intended usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MarlonJD/web-debug-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server