Skip to main content
Glama
Sign In

Relay — agent service discovery

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

Prepare a provider connection

get_connection_handoff
Read-onlyIdempotent

Read a reviewed host-managed connection plan for Exa, Jina or Browserless. Only provider is accepted. Returns official endpoints, authentication method, setup steps, source evidence and account-check limitations. Configure credentials only in your agent host; ToolSkipper does not inspect accounts, perform OAuth, accept keys or execute authenticated provider tasks. Discover live provider tool schemas after connecting. Connection grants no payment permission: the host must enforce the user's budget and provider billing controls before charged work. Unpublished or changed listings return no usable connection options. No provider calls or writes.

Input Schema

NameRequiredDescriptionDefault
providerYesReviewed provider identifier for host-managed setup. This returns instructions only; it never connects an account or authorizes spending.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "account": {
-        "additionalProperties": false,
-        "properties": {
-          "checkedByRelay": {
-            "const": false,
-            "type": "boolean"
-          },
-          "status": {
-            "const": "unknown",
-            "type": "string"
-          }
-        },
-        "required": [
-          "status",
-          "checkedByRelay"
-        ],
-        "type": "object"
-      },
-      "availability": {
-        "enum": [
-          "documented",
-          "unavailable"
-        ],
-        "type": "string"
-      },
-      "canExecuteInRelay": {
-        "const": false,
-        "type": "boolean"
-      },
-      "credentialsHeldBy": {
-        "const": "agent_host",
-        "type": "string"
-      },
-      "executionLocation": {
-        "const": "agent_host",
-        "type": "string"
-      },
-      "hostRequirements": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "limitations": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "options": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "authentication": {
-              "additionalProperties": false,
-              "properties": {
-                "handledBy": {
-                  "const": "agent_host",
-                  "type": "string"
-                },
-                "instructions": {
-                  "type": "string"
-                },
-                "method": {
-                  "enum": [
-                    "oauth",
-                    "api-key"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "method",
-                "handledBy",
-                "instructions"
-              ],
-              "type": "object"
-            },
-            "configuration": {
-              "anyOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "format": {
-                      "const": "mcpServers",
-                      "type": "string"
-                    },
-                    "json": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "format",
-                    "json"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "connectionPackage": {
-              "additionalProperties": false,
-              "properties": {
-                "example": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "content": {
-                      "type": "string"
-                    },
-                    "documentationUrl": {
-                      "format": "uri",
-                      "type": "string"
-                    },
-                    "format": {
-                      "enum": [
-                        "json",
-                        "http"
-                      ],
-                      "type": "string"
-                    },
-                    "instructions": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "format",
-                    "content",
-                    "instructions",
-                    "documentationUrl"
-                  ],
-                  "type": "object"
-                },
-                "hostPrompt": {
-                  "type": "string"
-                },
-                "permissions": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "reviewedAt": {
-                  "format": "date",
-                  "type": "string"
-                },
-                "verification": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                }
-              },
-              "required": [
-                "reviewedAt",
-                "hostPrompt",
-                "permissions",
-                "verification",
-                "example"
-              ],
-              "type": "object"
-            },
-            "documentationUrl": {
-              "format": "uri",
-              "type": "string"
-            },
-            "endpoint": {
-              "format": "uri",
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "protocol": {
-              "enum": [
-                "MCP",
-                "REST"
-              ],
-              "type": "string"
-            },
-            "sourceIds": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "steps": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "transport": {
-              "enum": [
-                "streamable-http",
-                "https"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "label",
-            "protocol",
-            "transport",
-            "endpoint",
-            "authentication",
-            "configuration",
-            "connectionPackage",
-            "documentationUrl",
-            "steps",
-            "sourceIds"
-          ],
-          "type": "object"
-        },
-        "maxItems": 1,
-        "type": "array"
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "authorizedByHandoff": {
-            "const": false,
-            "type": "boolean"
-          },
-          "budgetUsd": {
-            "type": "null"
-          },
-          "providerCostUsd": {
-            "type": "null"
-          },
-          "requiresHostEnforcement": {
-            "const": true,
-            "type": "boolean"
-          },
-          "requiresUserAuthorization": {
-            "const": true,
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "authorizedByHandoff",
-          "budgetUsd",
-          "providerCostUsd",
-          "requiresUserAuthorization",
-          "requiresHostEnforcement"
-        ],
-        "type": "object"
-      },
-      "provider": {
-        "enum": [
-          "exa",
-          "jina-ai",
-          "browserless"
-        ],
-        "type": "string"
-      },
-      "providerName": {
-        "type": "string"
-      },
-      "reasonCode": {
-        "enum": [
-          "HOST_SETUP_DOCUMENTED",
-          "PUBLISHED_SERVICE_UNAVAILABLE",
-          "REVIEWED_CONNECTION_UNAVAILABLE"
-        ],
-        "type": "string"
-      },
-      "review": {
-        "additionalProperties": false,
-        "properties": {
-          "guideSnapshotMatched": {
-            "type": "boolean"
-          },
-          "listingSnapshotMatched": {
-            "type": "boolean"
-          },
-          "reviewedAt": {
-            "anyOf": [
-              {
-                "format": "date",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "reviewedAt",
-          "listingSnapshotMatched",
-          "guideSnapshotMatched"
-        ],
-        "type": "object"
-      },
-      "schemaVersion": {
-        "const": "1",
-        "type": "string"
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "checkedAt": {
-              "format": "date",
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "format": "uri",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "url",
-            "title",
-            "checkedAt"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "status": {
-        "const": "host_connection_required",
-        "type": "string"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "schemaVersion",
-      "provider",
-      "providerName",
-      "status",
-      "availability",
-      "reasonCode",
-      "summary",
-      "executionLocation",
-      "credentialsHeldBy",
-      "canExecuteInRelay",
-      "account",
-      "payment",
-      "review",
-      "sources",
-      "options",
-      "hostRequirements",
-      "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: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "additionalProperties": false,
+        "properties": {
+          "checkedByRelay": {
+            "const": false,
+            "type": "boolean"
+          },
+          "status": {
+            "const": "unknown",
+            "type": "string"
+          }
+        },
+        "required": [
+          "status",
+          "checkedByRelay"
+        ],
+        "type": "object"
+      },
+      "availability": {
+        "enum": [
+          "documented",
+          "unavailable"
+        ],
+        "type": "string"
+      },
+      "canExecuteInRelay": {
+        "const": false,
+        "type": "boolean"
+      },
+      "credentialsHeldBy": {
+        "const": "agent_host",
+        "type": "string"
+      },
+      "executionLocation": {
+        "const": "agent_host",
+        "type": "string"
+      },
+      "hostRequirements": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "limitations": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "authentication": {
+              "additionalProperties": false,
+              "properties": {
+                "handledBy": {
+                  "const": "agent_host",
+                  "type": "string"
+                },
+                "instructions": {
+                  "type": "string"
+                },
+                "method": {
+                  "enum": [
+                    "oauth",
+                    "api-key"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "method",
+                "handledBy",
+                "instructions"
+              ],
+              "type": "object"
+            },
+            "configuration": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "format": {
+                      "const": "mcpServers",
+                      "type": "string"
+                    },
+                    "json": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "format",
+                    "json"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "connectionPackage": {
+              "additionalProperties": false,
+              "properties": {
+                "example": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "content": {
+                      "type": "string"
+                    },
+                    "documentationUrl": {
+                      "format": "uri",
+                      "type": "string"
+                    },
+                    "format": {
+                      "enum": [
+                        "json",
+                        "http"
+                      ],
+                      "type": "string"
+                    },
+                    "instructions": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "format",
+                    "content",
+                    "instructions",
+                    "documentationUrl"
+                  ],
+                  "type": "object"
+                },
+                "hostPrompt": {
+                  "type": "string"
+                },
+                "permissions": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "reviewedAt": {
+                  "format": "date",
+                  "type": "string"
+                },
+                "verification": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              },
+              "required": [
+                "reviewedAt",
+                "hostPrompt",
+                "permissions",
+                "verification",
+                "example"
+              ],
+              "type": "object"
+            },
+            "documentationUrl": {
+              "format": "uri",
+              "type": "string"
+            },
+            "endpoint": {
+              "format": "uri",
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "protocol": {
+              "enum": [
+                "MCP",
+                "REST"
+              ],
+              "type": "string"
+            },
+            "sourceIds": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "steps": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "transport": {
+              "enum": [
+                "streamable-http",
+                "https"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "label",
+            "protocol",
+            "transport",
+            "endpoint",
+            "authentication",
+            "configuration",
+            "connectionPackage",
+            "documentationUrl",
+            "steps",
+            "sourceIds"
+          ],
+          "type": "object"
+        },
+        "maxItems": 1,
+        "type": "array"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "authorizedByHandoff": {
+            "const": false,
+            "type": "boolean"
+          },
+          "budgetUsd": {
+            "type": "null"
+          },
+          "providerCostUsd": {
+            "type": "null"
+          },
+          "requiresHostEnforcement": {
+            "const": true,
+            "type": "boolean"
+          },
+          "requiresUserAuthorization": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "authorizedByHandoff",
+          "budgetUsd",
+          "providerCostUsd",
+          "requiresUserAuthorization",
+          "requiresHostEnforcement"
+        ],
+        "type": "object"
+      },
+      "provider": {
+        "enum": [
+          "exa",
+          "jina-ai",
+          "browserless"
+        ],
+        "type": "string"
+      },
+      "providerName": {
+        "type": "string"
+      },
+      "reasonCode": {
+        "enum": [
+          "HOST_SETUP_DOCUMENTED",
+          "PUBLISHED_SERVICE_UNAVAILABLE",
+          "REVIEWED_CONNECTION_UNAVAILABLE"
+        ],
+        "type": "string"
+      },
+      "review": {
+        "additionalProperties": false,
+        "properties": {
+          "guideSnapshotMatched": {
+            "type": "boolean"
+          },
+          "listingSnapshotMatched": {
+            "type": "boolean"
+          },
+          "reviewedAt": {
+            "anyOf": [
+              {
+                "format": "date",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "reviewedAt",
+          "listingSnapshotMatched",
+          "guideSnapshotMatched"
+        ],
+        "type": "object"
+      },
+      "schemaVersion": {
+        "const": "1",
+        "type": "string"
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "checkedAt": {
+              "format": "date",
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "format": "uri",
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "url",
+            "title",
+            "checkedAt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "const": "host_connection_required",
+        "type": "string"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "provider",
+      "providerName",
+      "status",
+      "availability",
+      "reasonCode",
+      "summary",
+      "executionLocation",
+      "credentialsHeldBy",
+      "canExecuteInRelay",
+      "account",
+      "payment",
+      "review",
+      "sources",
+      "options",
+      "hostRequirements",
+      "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: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "account": {
-        "additionalProperties": false,
-        "properties": {
-          "checkedByRelay": {
-            "const": false,
-            "type": "boolean"
-          },
-          "status": {
-            "const": "unknown",
-            "type": "string"
-          }
-        },
-        "required": [
-          "status",
-          "checkedByRelay"
-        ],
-        "type": "object"
-      },
-      "availability": {
-        "enum": [
-          "documented",
-          "unavailable"
-        ],
-        "type": "string"
-      },
-      "canExecuteInRelay": {
-        "const": false,
-        "type": "boolean"
-      },
-      "credentialsHeldBy": {
-        "const": "agent_host",
-        "type": "string"
-      },
-      "executionLocation": {
-        "const": "agent_host",
-        "type": "string"
-      },
-      "hostRequirements": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "limitations": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "options": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "authentication": {
-              "additionalProperties": false,
-              "properties": {
-                "handledBy": {
-                  "const": "agent_host",
-                  "type": "string"
-                },
-                "instructions": {
-                  "type": "string"
-                },
-                "method": {
-                  "enum": [
-                    "oauth",
-                    "api-key"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "method",
-                "handledBy",
-                "instructions"
-              ],
-              "type": "object"
-            },
-            "configuration": {
-              "anyOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "format": {
-                      "const": "mcpServers",
-                      "type": "string"
-                    },
-                    "json": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "format",
-                    "json"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "documentationUrl": {
-              "format": "uri",
-              "type": "string"
-            },
-            "endpoint": {
-              "format": "uri",
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "protocol": {
-              "enum": [
-                "MCP",
-                "REST"
-              ],
-              "type": "string"
-            },
-            "sourceIds": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "steps": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "transport": {
-              "enum": [
-                "streamable-http",
-                "https"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "label",
-            "protocol",
-            "transport",
-            "endpoint",
-            "authentication",
-            "configuration",
-            "documentationUrl",
-            "steps",
-            "sourceIds"
-          ],
-          "type": "object"
-        },
-        "maxItems": 1,
-        "type": "array"
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "authorizedByHandoff": {
-            "const": false,
-            "type": "boolean"
-          },
-          "budgetUsd": {
-            "type": "null"
-          },
-          "providerCostUsd": {
-            "type": "null"
-          },
-          "requiresHostEnforcement": {
-            "const": true,
-            "type": "boolean"
-          },
-          "requiresUserAuthorization": {
-            "const": true,
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "authorizedByHandoff",
-          "budgetUsd",
-          "providerCostUsd",
-          "requiresUserAuthorization",
-          "requiresHostEnforcement"
-        ],
-        "type": "object"
-      },
-      "provider": {
-        "enum": [
-          "exa",
-          "jina-ai",
-          "browserless"
-        ],
-        "type": "string"
-      },
-      "providerName": {
-        "type": "string"
-      },
-      "reasonCode": {
-        "enum": [
-          "HOST_SETUP_DOCUMENTED",
-          "PUBLISHED_SERVICE_UNAVAILABLE",
-          "REVIEWED_CONNECTION_UNAVAILABLE"
-        ],
-        "type": "string"
-      },
-      "review": {
-        "additionalProperties": false,
-        "properties": {
-          "guideSnapshotMatched": {
-            "type": "boolean"
-          },
-          "listingSnapshotMatched": {
-            "type": "boolean"
-          },
-          "reviewedAt": {
-            "anyOf": [
-              {
-                "format": "date",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "reviewedAt",
-          "listingSnapshotMatched",
-          "guideSnapshotMatched"
-        ],
-        "type": "object"
-      },
-      "schemaVersion": {
-        "const": "1",
-        "type": "string"
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "checkedAt": {
-              "format": "date",
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "format": "uri",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "url",
-            "title",
-            "checkedAt"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "status": {
-        "const": "host_connection_required",
-        "type": "string"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "schemaVersion",
-      "provider",
-      "providerName",
-      "status",
-      "availability",
-      "reasonCode",
-      "summary",
-      "executionLocation",
-      "credentialsHeldBy",
-      "canExecuteInRelay",
-      "account",
-      "payment",
-      "review",
-      "sources",
-      "options",
-      "hostRequirements",
-      "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: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "additionalProperties": false,
+        "properties": {
+          "checkedByRelay": {
+            "const": false,
+            "type": "boolean"
+          },
+          "status": {
+            "const": "unknown",
+            "type": "string"
+          }
+        },
+        "required": [
+          "status",
+          "checkedByRelay"
+        ],
+        "type": "object"
+      },
+      "availability": {
+        "enum": [
+          "documented",
+          "unavailable"
+        ],
+        "type": "string"
+      },
+      "canExecuteInRelay": {
+        "const": false,
+        "type": "boolean"
+      },
+      "credentialsHeldBy": {
+        "const": "agent_host",
+        "type": "string"
+      },
+      "executionLocation": {
+        "const": "agent_host",
+        "type": "string"
+      },
+      "hostRequirements": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "limitations": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "authentication": {
+              "additionalProperties": false,
+              "properties": {
+                "handledBy": {
+                  "const": "agent_host",
+                  "type": "string"
+                },
+                "instructions": {
+                  "type": "string"
+                },
+                "method": {
+                  "enum": [
+                    "oauth",
+                    "api-key"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "method",
+                "handledBy",
+                "instructions"
+              ],
+              "type": "object"
+            },
+            "configuration": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "format": {
+                      "const": "mcpServers",
+                      "type": "string"
+                    },
+                    "json": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "format",
+                    "json"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "connectionPackage": {
+              "additionalProperties": false,
+              "properties": {
+                "example": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "content": {
+                      "type": "string"
+                    },
+                    "documentationUrl": {
+                      "format": "uri",
+                      "type": "string"
+                    },
+                    "format": {
+                      "enum": [
+                        "json",
+                        "http"
+                      ],
+                      "type": "string"
+                    },
+                    "instructions": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "format",
+                    "content",
+                    "instructions",
+                    "documentationUrl"
+                  ],
+                  "type": "object"
+                },
+                "hostPrompt": {
+                  "type": "string"
+                },
+                "permissions": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "reviewedAt": {
+                  "format": "date",
+                  "type": "string"
+                },
+                "verification": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              },
+              "required": [
+                "reviewedAt",
+                "hostPrompt",
+                "permissions",
+                "verification",
+                "example"
+              ],
+              "type": "object"
+            },
+            "documentationUrl": {
+              "format": "uri",
+              "type": "string"
+            },
+            "endpoint": {
+              "format": "uri",
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "protocol": {
+              "enum": [
+                "MCP",
+                "REST"
+              ],
+              "type": "string"
+            },
+            "sourceIds": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "steps": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "transport": {
+              "enum": [
+                "streamable-http",
+                "https"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "label",
+            "protocol",
+            "transport",
+            "endpoint",
+            "authentication",
+            "configuration",
+            "connectionPackage",
+            "documentationUrl",
+            "steps",
+            "sourceIds"
+          ],
+          "type": "object"
+        },
+        "maxItems": 1,
+        "type": "array"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "authorizedByHandoff": {
+            "const": false,
+            "type": "boolean"
+          },
+          "budgetUsd": {
+            "type": "null"
+          },
+          "providerCostUsd": {
+            "type": "null"
+          },
+          "requiresHostEnforcement": {
+            "const": true,
+            "type": "boolean"
+          },
+          "requiresUserAuthorization": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "authorizedByHandoff",
+          "budgetUsd",
+          "providerCostUsd",
+          "requiresUserAuthorization",
+          "requiresHostEnforcement"
+        ],
+        "type": "object"
+      },
+      "provider": {
+        "enum": [
+          "exa",
+          "jina-ai",
+          "browserless"
+        ],
+        "type": "string"
+      },
+      "providerName": {
+        "type": "string"
+      },
+      "reasonCode": {
+        "enum": [
+          "HOST_SETUP_DOCUMENTED",
+          "PUBLISHED_SERVICE_UNAVAILABLE",
+          "REVIEWED_CONNECTION_UNAVAILABLE"
+        ],
+        "type": "string"
+      },
+      "review": {
+        "additionalProperties": false,
+        "properties": {
+          "guideSnapshotMatched": {
+            "type": "boolean"
+          },
+          "listingSnapshotMatched": {
+            "type": "boolean"
+          },
+          "reviewedAt": {
+            "anyOf": [
+              {
+                "format": "date",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "reviewedAt",
+          "listingSnapshotMatched",
+          "guideSnapshotMatched"
+        ],
+        "type": "object"
+      },
+      "schemaVersion": {
+        "const": "1",
+        "type": "string"
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "checkedAt": {
+              "format": "date",
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "format": "uri",
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "url",
+            "title",
+            "checkedAt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "const": "host_connection_required",
+        "type": "string"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "provider",
+      "providerName",
+      "status",
+      "availability",
+      "reasonCode",
+      "summary",
+      "executionLocation",
+      "credentialsHeldBy",
+      "canExecuteInRelay",
+      "account",
+      "payment",
+      "review",
+      "sources",
+      "options",
+      "hostRequirements",
+      "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. Changed1 schema field changed
    • addedInput schema / properties / provider / description
      Added value: +"Reviewed provider identifier for host-managed setup. This returns instructions only; it never connects an account or authorizes spending."
  4. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "account": {
+        "additionalProperties": false,
+        "properties": {
+          "checkedByRelay": {
+            "const": false,
+            "type": "boolean"
+          },
+          "status": {
+            "const": "unknown",
+            "type": "string"
+          }
+        },
+        "required": [
+          "status",
+          "checkedByRelay"
+        ],
+        "type": "object"
+      },
+      "availability": {
+        "enum": [
+          "documented",
+          "unavailable"
+        ],
+        "type": "string"
+      },
+      "canExecuteInRelay": {
+        "const": false,
+        "type": "boolean"
+      },
+      "credentialsHeldBy": {
+        "const": "agent_host",
+        "type": "string"
+      },
+      "executionLocation": {
+        "const": "agent_host",
+        "type": "string"
+      },
+      "hostRequirements": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "limitations": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "authentication": {
+              "additionalProperties": false,
+              "properties": {
+                "handledBy": {
+                  "const": "agent_host",
+                  "type": "string"
+                },
+                "instructions": {
+                  "type": "string"
+                },
+                "method": {
+                  "enum": [
+                    "oauth",
+                    "api-key"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "method",
+                "handledBy",
+                "instructions"
+              ],
+              "type": "object"
+            },
+            "configuration": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "format": {
+                      "const": "mcpServers",
+                      "type": "string"
+                    },
+                    "json": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "format",
+                    "json"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "documentationUrl": {
+              "format": "uri",
+              "type": "string"
+            },
+            "endpoint": {
+              "format": "uri",
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "protocol": {
+              "enum": [
+                "MCP",
+                "REST"
+              ],
+              "type": "string"
+            },
+            "sourceIds": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "steps": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "transport": {
+              "enum": [
+                "streamable-http",
+                "https"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "label",
+            "protocol",
+            "transport",
+            "endpoint",
+            "authentication",
+            "configuration",
+            "documentationUrl",
+            "steps",
+            "sourceIds"
+          ],
+          "type": "object"
+        },
+        "maxItems": 1,
+        "type": "array"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "authorizedByHandoff": {
+            "const": false,
+            "type": "boolean"
+          },
+          "budgetUsd": {
+            "type": "null"
+          },
+          "providerCostUsd": {
+            "type": "null"
+          },
+          "requiresHostEnforcement": {
+            "const": true,
+            "type": "boolean"
+          },
+          "requiresUserAuthorization": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "authorizedByHandoff",
+          "budgetUsd",
+          "providerCostUsd",
+          "requiresUserAuthorization",
+          "requiresHostEnforcement"
+        ],
+        "type": "object"
+      },
+      "provider": {
+        "enum": [
+          "exa",
+          "jina-ai",
+          "browserless"
+        ],
+        "type": "string"
+      },
+      "providerName": {
+        "type": "string"
+      },
+      "reasonCode": {
+        "enum": [
+          "HOST_SETUP_DOCUMENTED",
+          "PUBLISHED_SERVICE_UNAVAILABLE",
+          "REVIEWED_CONNECTION_UNAVAILABLE"
+        ],
+        "type": "string"
+      },
+      "review": {
+        "additionalProperties": false,
+        "properties": {
+          "guideSnapshotMatched": {
+            "type": "boolean"
+          },
+          "listingSnapshotMatched": {
+            "type": "boolean"
+          },
+          "reviewedAt": {
+            "anyOf": [
+              {
+                "format": "date",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "reviewedAt",
+          "listingSnapshotMatched",
+          "guideSnapshotMatched"
+        ],
+        "type": "object"
+      },
+      "schemaVersion": {
+        "const": "1",
+        "type": "string"
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "checkedAt": {
+              "format": "date",
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "format": "uri",
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "url",
+            "title",
+            "checkedAt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "const": "host_connection_required",
+        "type": "string"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "schemaVersion",
+      "provider",
+      "providerName",
+      "status",
+      "availability",
+      "reasonCode",
+      "summary",
+      "executionLocation",
+      "credentialsHeldBy",
+      "canExecuteInRelay",
+      "account",
+      "payment",
+      "review",
+      "sources",
+      "options",
+      "hostRequirements",
+      "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"
+  }
+]
    • removedOutput schema / properties
      Removed value: -{
-  "account": {
-    "additionalProperties": false,
-    "properties": {
-      "checkedByRelay": {
-        "const": false,
-        "type": "boolean"
-      },
-      "status": {
-        "const": "unknown",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "checkedByRelay"
-    ],
-    "type": "object"
-  },
-  "availability": {
-    "enum": [
-      "documented",
-      "unavailable"
-    ],
-    "type": "string"
-  },
-  "canExecuteInRelay": {
-    "const": false,
-    "type": "boolean"
-  },
-  "credentialsHeldBy": {
-    "const": "agent_host",
-    "type": "string"
-  },
-  "executionLocation": {
-    "const": "agent_host",
-    "type": "string"
-  },
-  "hostRequirements": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "limitations": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "options": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "authentication": {
-          "additionalProperties": false,
-          "properties": {
-            "handledBy": {
-              "const": "agent_host",
-              "type": "string"
-            },
-            "instructions": {
-              "type": "string"
-            },
-            "method": {
-              "enum": [
-                "oauth",
-                "api-key"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "method",
-            "handledBy",
-            "instructions"
-          ],
-          "type": "object"
-        },
-        "configuration": {
-          "anyOf": [
-            {
-              "additionalProperties": false,
-              "properties": {
-                "format": {
-                  "const": "mcpServers",
-                  "type": "string"
-                },
-                "json": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "format",
-                "json"
-              ],
-              "type": "object"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "documentationUrl": {
-          "format": "uri",
-          "type": "string"
-        },
-        "endpoint": {
-          "format": "uri",
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "label": {
-          "type": "string"
-        },
-        "protocol": {
-          "enum": [
-            "MCP",
-            "REST"
-          ],
-          "type": "string"
-        },
-        "sourceIds": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "steps": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "transport": {
-          "enum": [
-            "streamable-http",
-            "https"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "id",
-        "label",
-        "protocol",
-        "transport",
-        "endpoint",
-        "authentication",
-        "configuration",
-        "documentationUrl",
-        "steps",
-        "sourceIds"
-      ],
-      "type": "object"
-    },
-    "maxItems": 1,
-    "type": "array"
-  },
-  "payment": {
-    "additionalProperties": false,
-    "properties": {
-      "authorizedByHandoff": {
-        "const": false,
-        "type": "boolean"
-      },
-      "budgetUsd": {
-        "type": "null"
-      },
-      "providerCostUsd": {
-        "type": "null"
-      },
-      "requiresHostEnforcement": {
-        "const": true,
-        "type": "boolean"
-      },
-      "requiresUserAuthorization": {
-        "const": true,
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "authorizedByHandoff",
-      "budgetUsd",
-      "providerCostUsd",
-      "requiresUserAuthorization",
-      "requiresHostEnforcement"
-    ],
-    "type": "object"
-  },
-  "provider": {
-    "enum": [
-      "exa",
-      "jina-ai",
-      "browserless"
-    ],
-    "type": "string"
-  },
-  "providerName": {
-    "type": "string"
-  },
-  "reasonCode": {
-    "enum": [
-      "HOST_SETUP_DOCUMENTED",
-      "PUBLISHED_SERVICE_UNAVAILABLE",
-      "REVIEWED_CONNECTION_UNAVAILABLE"
-    ],
-    "type": "string"
-  },
-  "review": {
-    "additionalProperties": false,
-    "properties": {
-      "guideSnapshotMatched": {
-        "type": "boolean"
-      },
-      "listingSnapshotMatched": {
-        "type": "boolean"
-      },
-      "reviewedAt": {
-        "anyOf": [
-          {
-            "format": "date",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "reviewedAt",
-      "listingSnapshotMatched",
-      "guideSnapshotMatched"
-    ],
-    "type": "object"
-  },
-  "schemaVersion": {
-    "const": "1",
-    "type": "string"
-  },
-  "sources": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "checkedAt": {
-          "format": "date",
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "title": {
-          "type": "string"
-        },
-        "url": {
-          "format": "uri",
-          "type": "string"
-        }
-      },
-      "required": [
-        "id",
-        "url",
-        "title",
-        "checkedAt"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "status": {
-    "const": "host_connection_required",
-    "type": "string"
-  },
-  "summary": {
-    "type": "string"
-  }
-}
    • removedOutput schema / required
      Removed value: -[
-  "schemaVersion",
-  "provider",
-  "providerName",
-  "status",
-  "availability",
-  "reasonCode",
-  "summary",
-  "executionLocation",
-  "credentialsHeldBy",
-  "canExecuteInRelay",
-  "account",
-  "payment",
-  "review",
-  "sources",
-  "options",
-  "hostRequirements",
-  "limitations"
-]
  5. First observed

TDQS

A4.7/5.0
Behavior5/5

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

It goes far beyond the annotations by disclosing complex behavioral constraints like ToolSkipper's inability to perform OAuth or inspect accounts. It also includes critical non-functional traits like billing enforcement and the consequence of using unpublished listings.

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

Conciseness5/5

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

While lengthy, every sentence is critical, serving as a manual of terms and conditions for the tool. The information is structured logically, moving from purpose to output content, then to operational restrictions.

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?

Given the high complexity of setup and billing, the description is exceptionally complete. It covers the input requirements, the nature of the output (what it contains), the execution environment constraints, and the financial safeguards.

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 input schema has 100% coverage and the input is simple. The description merely reinforces the enum values and the single required parameter ('provider'), thus hitting the baseline score for high schema coverage.

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?

The tool specifically states it reads a 'reviewed host-managed connection plan' for specific vendors (Exa, Jina, Browserless). This is highly distinct from general search tools in the sibling list, making its purpose immediately clear.

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?

The description provides exhaustive usage guidelines by defining strict boundaries, such as 'Only provider is accepted' and 'Connection grants no payment permission.' It explicitly outlines the conditions under which the tool is applicable and its operational limitations.

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