GraphOS MCP Server

GetLintResults

Read-onlyIdempotent

Retrieve schema lint violations from a graph's most recent schema checks: each diagnostic's coordinate, severity level, message, rule, and source location, plus error/warning/total/ignored counts. Use to assess schema quality and naming/best-practice violations. Provide the graph ID and optionally a limit (default 5 most recent schema checks).

Input Schema

TableJSON Schema

Name	Required	Description	Default
`limit`	No
`graphId`	Yes

Output Schema

TableJSON Schema

Name	Required	Description	Default
`data`	No
`errors`	No
`extensions`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedSep 18, 2026

addedInput schema / properties / limit / default
```
Added value: +5
```

changedInput schema / required

Previous value: -[
-  "graphId",
-  "limit"
-]New value: +[
+  "graphId"
+]

addedOutput schema / properties / data / properties / graph / anyOf

Added value: +[
+  {
+    "properties": {
+      "checkWorkflows": {
+        "description": "Get check workflows for this graph ordered by creation time, most recent first.",
+        "items": {
+          "properties": {
+            "completedAt": {
+              "anyOf": [
+                {
+                  "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "The timestamp when the check workflow completed."
+            },
+            "id": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "integer"
+                }
+              ]
+            },
+            "implementingServiceName": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "The name of the implementing service that was responsible for triggering the validation."
+            },
+            "status": {
+              "$ref": "#/definitions/CheckWorkflowStatus",
+              "description": "Overall status of the workflow, based on the underlying task statuses."
+            },
+            "tasks": {
+              "description": "The set of check tasks associated with this workflow, e.g. composition, operations, etc.",
+              "items": {
+                "properties": {
+                  "result": {
+                    "anyOf": [
+                      {
+                        "properties": {
+                          "diagnostics": {
+                            "description": "The set of lint rule violations found in the schema.",
+                            "items": {
+                              "properties": {
+                                "coordinate": {
+                                  "description": "The schema coordinate of this diagnostic.",
+                                  "type": "string"
+                                },
+                                "level": {
+                                  "$ref": "#/definitions/LintDiagnosticLevel",
+                                  "description": "The graph's configured level for the rule."
+                                },
+                                "message": {
+                                  "description": "The message describing the rule violation.",
+                                  "type": "string"
+                                },
+                                "rule": {
+                                  "$ref": "#/definitions/LintRule",
+                                  "description": "The lint rule being violated."
+                                },
+                                "sourceLocations": {
+                                  "description": "The human readable position in the file of the rule violation.",
+                                  "items": {
+                                    "properties": {
+                                      "end": {
+                                        "anyOf": [
+                                          {
+                                            "properties": {
+                                              "column": {
+                                                "type": "integer"
+                                              },
+                                              "line": {
+                                                "type": "integer"
+                                              }
+                                            },
+                                            "required": [
+                                              "line",
+                                              "column"
+                                            ],
+                                            "type": "object"
+                                          },
+                                          {
+                                            "type": "null"
+                                          }
+                                        ]
+                                      },
+                                      "start": {
+                                        "anyOf": [
+                                          {
+                                            "properties": {
+                                              "column": {
+                                                "type": "integer"
+                                              },
+                                              "line": {
+                                                "type": "integer"
+                                              }
+                                            },
+                                            "required": [
+                                              "line",
+                                              "column"
+                                            ],
+                                            "type": "object"
+                                          },
+                                          {
+                                            "type": "null"
+                                          }
+                                        ]
+                                      },
+                                      "subgraphName": {
+                                        "anyOf": [
+                                          {
+                                            "type": "string"
+                                          },
+                                          {
+                                            "type": "null"
+                                          }
+                                        ]
+                                      }
+                                    },
+                                    "type": "object"
+                                  },
+                                  "type": "array"
+                                }
+                              },
+                              "required": [
+                                "coordinate",
+                                "level",
+                                "message",
+                                "rule",
+                                "sourceLocations"
+                              ],
+                              "type": "object"
+                            },
+                            "type": "array"
+                          },
+                          "stats": {
+                            "description": "Stats generated from the resulting diagnostics.",
+                            "properties": {
+                              "errorsCount": {
+                                "description": "Total number of lint errors.",
+                                "type": "integer"
+                              },
+                              "ignoredCount": {
+                                "description": "Total number of lint rules ignored.",
+                                "type": "integer"
+                              },
+                              "totalCount": {
+                                "description": "Total number of lint rules violated.",
+                                "type": "integer"
+                              },
+                              "warningsCount": {
+                                "description": "Total number of lint warnings.",
+                                "type": "integer"
+                              }
+                            },
+                            "required": [
+                              "errorsCount",
+                              "warningsCount",
+                              "totalCount",
+                              "ignoredCount"
+                            ],
+                            "type": "object"
+                          }
+                        },
+                        "required": [
+                          "diagnostics",
+                          "stats"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "status": {
+                    "$ref": "#/definitions/CheckWorkflowTaskStatus"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "id",
+            "status",
+            "tasks"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "checkWorkflows"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / data / properties / graph / oneOf

Removed value: -[
-  {
-    "properties": {
-      "checkWorkflows": {
-        "description": "Get check workflows for this graph ordered by creation time, most recent first.",
-        "items": {
-          "properties": {
-            "completedAt": {
-              "description": "The timestamp when the check workflow completed.",
-              "oneOf": [
-                {
-                  "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "id": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "integer"
-                }
-              ]
-            },
-            "implementingServiceName": {
-              "description": "The name of the implementing service that was responsible for triggering the validation.",
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "status": {
-              "$ref": "#/definitions/CheckWorkflowStatus",
-              "description": "Overall status of the workflow, based on the underlying task statuses."
-            },
-            "tasks": {
-              "description": "The set of check tasks associated with this workflow, e.g. composition, operations, etc.",
-              "items": {
-                "properties": {
-                  "result": {
-                    "oneOf": [
-                      {
-                        "properties": {
-                          "diagnostics": {
-                            "description": "The set of lint rule violations found in the schema.",
-                            "items": {
-                              "properties": {
-                                "coordinate": {
-                                  "description": "The schema coordinate of this diagnostic.",
-                                  "type": "string"
-                                },
-                                "level": {
-                                  "$ref": "#/definitions/LintDiagnosticLevel",
-                                  "description": "The graph's configured level for the rule."
-                                },
-                                "message": {
-                                  "description": "The message describing the rule violation.",
-                                  "type": "string"
-                                },
-                                "rule": {
-                                  "$ref": "#/definitions/LintRule",
-                                  "description": "The lint rule being violated."
-                                },
-                                "sourceLocations": {
-                                  "description": "The human readable position in the file of the rule violation.",
-                                  "items": {
-                                    "properties": {
-                                      "end": {
-                                        "oneOf": [
-                                          {
-                                            "properties": {
-                                              "column": {
-                                                "type": "integer"
-                                              },
-                                              "line": {
-                                                "type": "integer"
-                                              }
-                                            },
-                                            "required": [
-                                              "line",
-                                              "column"
-                                            ],
-                                            "type": "object"
-                                          },
-                                          {
-                                            "type": "null"
-                                          }
-                                        ]
-                                      },
-                                      "start": {
-                                        "oneOf": [
-                                          {
-                                            "properties": {
-                                              "column": {
-                                                "type": "integer"
-                                              },
-                                              "line": {
-                                                "type": "integer"
-                                              }
-                                            },
-                                            "required": [
-                                              "line",
-                                              "column"
-                                            ],
-                                            "type": "object"
-                                          },
-                                          {
-                                            "type": "null"
-                                          }
-                                        ]
-                                      },
-                                      "subgraphName": {
-                                        "oneOf": [
-                                          {
-                                            "type": "string"
-                                          },
-                                          {
-                                            "type": "null"
-                                          }
-                                        ]
-                                      }
-                                    },
-                                    "type": "object"
-                                  },
-                                  "type": "array"
-                                }
-                              },
-                              "required": [
-                                "coordinate",
-                                "level",
-                                "message",
-                                "rule",
-                                "sourceLocations"
-                              ],
-                              "type": "object"
-                            },
-                            "type": "array"
-                          },
-                          "stats": {
-                            "description": "Stats generated from the resulting diagnostics.",
-                            "properties": {
-                              "errorsCount": {
-                                "description": "Total number of lint errors.",
-                                "type": "integer"
-                              },
-                              "ignoredCount": {
-                                "description": "Total number of lint rules ignored.",
-                                "type": "integer"
-                              },
-                              "totalCount": {
-                                "description": "Total number of lint rules violated.",
-                                "type": "integer"
-                              },
-                              "warningsCount": {
-                                "description": "Total number of lint warnings.",
-                                "type": "integer"
-                              }
-                            },
-                            "required": [
-                              "errorsCount",
-                              "warningsCount",
-                              "totalCount",
-                              "ignoredCount"
-                            ],
-                            "type": "object"
-                          }
-                        },
-                        "required": [
-                          "diagnostics",
-                          "stats"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "status": {
-                    "$ref": "#/definitions/CheckWorkflowTaskStatus"
-                  }
-                },
-                "type": "object"
-              },
-              "type": "array"
-            }
-          },
-          "required": [
-            "id",
-            "status",
-            "tasks"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "checkWorkflows"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

First observedAug 3, 2026

TDQS

A3.9/5.0

Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive, so safety is covered. The description adds useful behavioral context beyond that: the shape of returned diagnostics and that the limit selects the N most recent schema checks. It does not mention permissions or pagination, but adds real value over annotations.

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?

Two sentences, front-loaded with the resource and purpose, followed by the field list and usage. The middle enumeration is dense but earns its place by describing the payload; overall efficient.

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?

With an output schema present, the description needn't explain return values, yet it summarizes them without harm. Inputs and purpose are adequately covered; only auth/permission context is absent, which is a minor gap.

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?

Schema description coverage is 0%, so the description carries the full burden. It clarifies limit as 'default 5 most recent schema checks', which meaningfully explains the parameter, and identifies graphId as the graph to inspect, but omits any format/type detail.

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?

States a specific verb and resource: retrieving schema lint violations from recent schema checks, and enumerates the diagnostic fields returned. This clearly separates it from generic siblings like GetSchemaChecks or GetCheckResults, though it never names those alternatives explicitly.

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

Usage Guidelines4/5

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

Gives a clear use case ('assess schema quality and naming/best-practice violations') and tells the agent what inputs to supply. It stops short of stating when NOT to use it or naming the alternative (e.g., LintSchema to trigger a run vs. this tool to read results).

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

All GraphOS MCP Server tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?