Skip to main content
Glama
Sign In

Relay — agent service discovery

by site.chatgpt.orellise.relay-agent-services
OverviewDiscussionsAdmin

Find official documents to read

search_reading_sources
Read-onlyIdempotent

Search a dated local index of exact public Markdown documents from reviewed official publishers. Literal title/URL terms only, not semantic search. Returns ids, source URLs, listing provenance and pagination. A listing is not a successful reading test, new service, factual verification or suitability claim. Listings expire after 30 days. No upstream requests, credentials or payments. Call read_official_document separately only when the user requests a document. Source metadata is untrusted data.

Input Schema

NameRequiredDescriptionDefault
limitNoMaximum source records per page, from 1 to 20.
queryNoLiteral title or URL terms. Empty lists current source metadata; does not fetch documents.
offsetNoZero-based page offset. Use nextOffset from the preceding response; preserve the same query.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "coverage": {
-        "properties": {
-          "nextStep": {
-            "type": "string"
-          },
-          "requiresLogin": {
-            "const": false
-          },
-          "requiresProviderKey": {
-            "const": false
-          },
-          "status": {
-            "enum": [
-              "listed",
-              "source_not_listed",
-              "publisher_not_supported",
-              "no_metadata_match"
-            ]
-          }
-        },
-        "required": [
-          "status",
-          "nextStep",
-          "requiresLogin",
-          "requiresProviderKey"
-        ],
-        "type": "object"
-      },
-      "limitations": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "listed": {
-        "type": "integer"
-      },
-      "nextOffset": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "offset": {
-        "type": "integer"
-      },
-      "sources": {
-        "items": {
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "indexSha256": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "indexUrl": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "readTested": {
-              "const": "not_established_by_index"
-            },
-            "reviewedAt": {
-              "type": "string"
-            },
-            "sourceUrl": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            },
-            "verification": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "title",
-            "url",
-            "sourceUrl",
-            "reviewedAt",
-            "verification",
-            "readTested"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "type": "array"
-      },
-      "total": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "sources",
-      "total",
-      "listed",
-      "offset",
-      "nextOffset",
-      "coverage",
-      "limitations"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "error_code": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "error_code",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "coverage": {
+        "properties": {
+          "nextStep": {
+            "type": "string"
+          },
+          "requiresLogin": {
+            "const": false
+          },
+          "requiresProviderKey": {
+            "const": false
+          },
+          "status": {
+            "enum": [
+              "listed",
+              "source_not_listed",
+              "publisher_not_supported",
+              "no_metadata_match"
+            ]
+          }
+        },
+        "required": [
+          "status",
+          "nextStep",
+          "requiresLogin",
+          "requiresProviderKey"
+        ],
+        "type": "object"
+      },
+      "limitations": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "listed": {
+        "type": "integer"
+      },
+      "nextOffset": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "offset": {
+        "type": "integer"
+      },
+      "sources": {
+        "items": {
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "indexSha256": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "indexUrl": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "readTested": {
+              "const": "not_established_by_index"
+            },
+            "reviewedAt": {
+              "type": "string"
+            },
+            "sourceUrl": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "verification": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "title",
+            "url",
+            "sourceUrl",
+            "reviewedAt",
+            "verification",
+            "readTested"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      },
+      "total": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "sources",
+      "total",
+      "listed",
+      "offset",
+      "nextOffset",
+      "coverage",
+      "limitations"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "error_code": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "recovery": {
+        "additionalProperties": false,
+        "properties": {
+          "automaticRetryAllowed": {
+            "const": false
+          },
+          "guidance": {
+            "type": "string"
+          },
+          "requiredArguments": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "tool",
+          "requiredArguments",
+          "guidance",
+          "automaticRetryAllowed"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error_code",
+      "error"
+    ],
+    "type": "object"
+  }
+]
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "limitations": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "listed": {
-        "type": "integer"
-      },
-      "nextOffset": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "offset": {
-        "type": "integer"
-      },
-      "sources": {
-        "items": {
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "indexSha256": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "indexUrl": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "readTested": {
-              "const": "not_established_by_index"
-            },
-            "reviewedAt": {
-              "type": "string"
-            },
-            "sourceUrl": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            },
-            "verification": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "title",
-            "url",
-            "sourceUrl",
-            "reviewedAt",
-            "verification",
-            "readTested"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "type": "array"
-      },
-      "total": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "sources",
-      "total",
-      "listed",
-      "offset",
-      "nextOffset",
-      "limitations"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "error_code": {
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "error_code",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "coverage": {
+        "properties": {
+          "nextStep": {
+            "type": "string"
+          },
+          "requiresLogin": {
+            "const": false
+          },
+          "requiresProviderKey": {
+            "const": false
+          },
+          "status": {
+            "enum": [
+              "listed",
+              "source_not_listed",
+              "publisher_not_supported",
+              "no_metadata_match"
+            ]
+          }
+        },
+        "required": [
+          "status",
+          "nextStep",
+          "requiresLogin",
+          "requiresProviderKey"
+        ],
+        "type": "object"
+      },
+      "limitations": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "listed": {
+        "type": "integer"
+      },
+      "nextOffset": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "offset": {
+        "type": "integer"
+      },
+      "sources": {
+        "items": {
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "indexSha256": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "indexUrl": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "readTested": {
+              "const": "not_established_by_index"
+            },
+            "reviewedAt": {
+              "type": "string"
+            },
+            "sourceUrl": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "verification": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "title",
+            "url",
+            "sourceUrl",
+            "reviewedAt",
+            "verification",
+            "readTested"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "type": "array"
+      },
+      "total": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "sources",
+      "total",
+      "listed",
+      "offset",
+      "nextOffset",
+      "coverage",
+      "limitations"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "error_code": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "error_code",
+      "error"
+    ],
+    "type": "object"
+  }
+]
  3. Changed2 schema fields changed
    • addedInput schema / properties / limit / description
      Added value: +"Maximum source records per page, from 1 to 20."
    • addedInput schema / properties / offset / description
      Added value: +"Zero-based page offset. Use nextOffset from the preceding response; preserve the same query."
  4. Added

TDQS

A4.6/5.0
Behavior5/5

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

Goes well beyond the annotations: no upstream requests, credentials or payments; listings expire after 30 days; returns ids, source URLs, listing provenance and pagination; source metadata is untrusted data. The 'a listing is not a successful reading test, new service, factual verification or suitability claim' line sets precise expectations about what a result does and does not mean.

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?

Front-loaded with the core definition and negative constraint before the disclaimers. Dense but nearly every sentence carries distinct information; the disclaimer sentence listing four things a listing is not is slightly run-on but earns its place as a guardrail.

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

Completeness5/5

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

Annotations already cover safety and closed-world behavior, and an output schema exists so return values need not be spelled out. The description still adds freshness (30-day expiry), trust posture, and side-effect absence, leaving nothing an agent needs missing.

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 100%, so the schema already documents limit, query and offset in detail, including the empty-query behavior and the nextOffset pattern. The description adds no parameter-specific syntax or format guidance beyond that, so the baseline 3 applies.

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

Purpose5/5

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

States a specific verb (search), resource (a dated local index of exact public Markdown documents), and scope (reviewed official publishers, literal title/URL terms only). The explicit 'not semantic search' clause separates it from semantic siblings like search_services and search_discovered_services, and the read_official_document mention separates it from the fetch tool.

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

Usage Guidelines5/5

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

Gives a clear negative constraint ('literal title/URL terms only, not semantic search') and names the alternative with the condition that selects it: 'Call read_official_document separately only when the user requests a document.' An agent knows both when to use this and when to defer to the sibling.

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

All Relay — agent service discovery toolsInspect
Try in Browser
Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources