Skip to main content
Glama

Darwin

by so.darwin
OverviewDiscussionsAdmin

Darwin

search
Read-onlyIdempotent

Find ranked public agents from a natural-language query. Optionally add a category focus or objective. Returns compact agent identities and nested capabilities that can be passed directly to Act.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
queryYes
categoryNoOptional open-ended agent or capability category focus for ranking.
objectiveNoOptional outcome or success objective that should affect ranking.
numResultsNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
agentsYes
outcomeYesNO_ELIGIBLE_SUPPLY
resultsYes
versionsYes
diagnosticsNo
contractVersionYessearch-public-v2

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / agents / items / properties / capabilities / items / properties / routeDecision
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "bindingRevision": {
+      "anyOf": [
+        {
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "capabilityRevision": {
+      "anyOf": [
+        {
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "contractVersion": {
+      "const": 1,
+      "type": "number"
+    },
+    "owner": {
+      "enum": [
+        "SOURCE",
+        "CREORA",
+        "CREORA_DARWIN",
+        "PROVIDER",
+        "PROVIDER_DARWIN",
+        "DARWIN",
+        "DARWIN_WEB",
+        "PROVIDER_NETWORK"
+      ],
+      "type": "string"
+    },
+    "reasonCode": {
+      "enum": [
+        "NO_REMOTE_ROUTE",
+        "VERIFICATION_EXPIRED",
+        "EXACT_OPERATION_NOT_VERIFIED",
+        "SCHEMA_CHANGED",
+        "SOURCE_RECEIPT_MISSING",
+        "SOURCE_REVISION_MISMATCH",
+        "BINDING_DIGEST_MISMATCH",
+        "AUTHENTICATION_REQUIRED",
+        "CONFIGURATION_REQUIRED",
+        "BROWSER_SESSION_REQUIRED",
+        "ROUTE_NOT_APPROVED",
+        "UNSUPPORTED_TRANSPORT",
+        "UNSUPPORTED_PROTOCOL_VERSION",
+        "CATALOG_TOO_LARGE",
+        "ADAPTER_UNAVAILABLE",
+        "PROVIDER_UNREACHABLE",
+        "ROUTE_WITHDRAWN",
+        "DARWIN_POLICY_BLOCKED",
+        "READINESS_EVALUATION_UNAVAILABLE"
+      ],
+      "type": "string"
+    },
+    "recovery": {
+      "enum": [
+        "REFRESH_EVIDENCE",
+        "REAUTHENTICATE",
+        "CONFIGURE_ROUTE",
+        "CONNECT_BROWSER",
+        "REQUEST_APPROVAL",
+        "DEPLOY_ADAPTER",
+        "REDUCE_CATALOG",
+        "RETRY_PROVIDER",
+        "CONTACT_OPERATOR",
+        "NONE"
+      ],
+      "type": "string"
+    },
+    "stage": {
+      "enum": [
+        "SOURCE_EVIDENCE",
+        "VERIFICATION_FRESHNESS",
+        "CAPABILITY_BINDING",
+        "PUBLICATION_HANDOFF",
+        "DARWIN_CONSUMPTION",
+        "USER_PREFLIGHT",
+        "TRANSPORT_ADMISSION",
+        "ROUTE_POLICY",
+        "ADAPTER_SELECTION",
+        "PROVIDER_ATTEMPT",
+        "SOURCE_LIFECYCLE",
+        "DARWIN_POLICY",
+        "READINESS_EVALUATION"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "contractVersion",
+    "reasonCode",
+    "stage",
+    "owner",
+    "capabilityRevision",
+    "bindingRevision",
+    "recovery"
+  ],
+  "type": "object"
+}
    • addedOutput schema / properties / results / items / properties / routeDecision
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "bindingRevision": {
+      "anyOf": [
+        {
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "capabilityRevision": {
+      "anyOf": [
+        {
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "contractVersion": {
+      "const": 1,
+      "type": "number"
+    },
+    "owner": {
+      "enum": [
+        "SOURCE",
+        "CREORA",
+        "CREORA_DARWIN",
+        "PROVIDER",
+        "PROVIDER_DARWIN",
+        "DARWIN",
+        "DARWIN_WEB",
+        "PROVIDER_NETWORK"
+      ],
+      "type": "string"
+    },
+    "reasonCode": {
+      "enum": [
+        "NO_REMOTE_ROUTE",
+        "VERIFICATION_EXPIRED",
+        "EXACT_OPERATION_NOT_VERIFIED",
+        "SCHEMA_CHANGED",
+        "SOURCE_RECEIPT_MISSING",
+        "SOURCE_REVISION_MISMATCH",
+        "BINDING_DIGEST_MISMATCH",
+        "AUTHENTICATION_REQUIRED",
+        "CONFIGURATION_REQUIRED",
+        "BROWSER_SESSION_REQUIRED",
+        "ROUTE_NOT_APPROVED",
+        "UNSUPPORTED_TRANSPORT",
+        "UNSUPPORTED_PROTOCOL_VERSION",
+        "CATALOG_TOO_LARGE",
+        "ADAPTER_UNAVAILABLE",
+        "PROVIDER_UNREACHABLE",
+        "ROUTE_WITHDRAWN",
+        "DARWIN_POLICY_BLOCKED",
+        "READINESS_EVALUATION_UNAVAILABLE"
+      ],
+      "type": "string"
+    },
+    "recovery": {
+      "enum": [
+        "REFRESH_EVIDENCE",
+        "REAUTHENTICATE",
+        "CONFIGURE_ROUTE",
+        "CONNECT_BROWSER",
+        "REQUEST_APPROVAL",
+        "DEPLOY_ADAPTER",
+        "REDUCE_CATALOG",
+        "RETRY_PROVIDER",
+        "CONTACT_OPERATOR",
+        "NONE"
+      ],
+      "type": "string"
+    },
+    "stage": {
+      "enum": [
+        "SOURCE_EVIDENCE",
+        "VERIFICATION_FRESHNESS",
+        "CAPABILITY_BINDING",
+        "PUBLICATION_HANDOFF",
+        "DARWIN_CONSUMPTION",
+        "USER_PREFLIGHT",
+        "TRANSPORT_ADMISSION",
+        "ROUTE_POLICY",
+        "ADAPTER_SELECTION",
+        "PROVIDER_ATTEMPT",
+        "SOURCE_LIFECYCLE",
+        "DARWIN_POLICY",
+        "READINESS_EVALUATION"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "contractVersion",
+    "reasonCode",
+    "stage",
+    "owner",
+    "capabilityRevision",
+    "bindingRevision",
+    "recovery"
+  ],
+  "type": "object"
+}
  2. Changed2 schema fields changed
    • addedOutput schema / properties / agents / items / properties / capabilities / items / properties / threadUnavailableReason
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "ACT_THREAD_CUTOVER_PENDING",
+        "TARGET_CAPABILITY_NOT_FOUND",
+        "THREAD_CAPABILITY_CATALOG_TOO_LARGE",
+        "ROUTE_NOT_CONFIGURED",
+        "ROUTE_REVISION_STALE",
+        "ROUTE_NOT_APPROVED",
+        "ROUTE_NOT_READY",
+        "ROUTE_NOT_VERIFIED",
+        "ROUTE_VERIFICATION_EXPIRED",
+        "CALLABLE_TRANSPORT_NOT_VERIFIED",
+        "THREAD_ADAPTER_UNAVAILABLE",
+        "CAPABILITY_SCHEMA_MISSING",
+        "THREAD_AUTH_BINDING_UNVERIFIED",
+        "THREAD_DISCOVERY_AUTHENTICATION_REQUIRED",
+        "THREAD_READINESS_UNAVAILABLE"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / properties / results / items / properties / threadUnavailableReason
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "ACT_THREAD_CUTOVER_PENDING",
+        "TARGET_CAPABILITY_NOT_FOUND",
+        "THREAD_CAPABILITY_CATALOG_TOO_LARGE",
+        "ROUTE_NOT_CONFIGURED",
+        "ROUTE_REVISION_STALE",
+        "ROUTE_NOT_APPROVED",
+        "ROUTE_NOT_READY",
+        "ROUTE_NOT_VERIFIED",
+        "ROUTE_VERIFICATION_EXPIRED",
+        "CALLABLE_TRANSPORT_NOT_VERIFIED",
+        "THREAD_ADAPTER_UNAVAILABLE",
+        "CAPABILITY_SCHEMA_MISSING",
+        "THREAD_AUTH_BINDING_UNVERIFIED",
+        "THREAD_DISCOVERY_AUTHENTICATION_REQUIRED",
+        "THREAD_READINESS_UNAVAILABLE"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
  3. Changed6 schema fields changed
    • addedOutput schema / properties / agents / items / properties / canAttemptThread
      Added value: +{
+  "type": "boolean"
+}
    • addedOutput schema / properties / agents / items / properties / capabilities / items / properties / canAttemptThread
      Added value: +{
+  "type": "boolean"
+}
    • changedOutput schema / properties / agents / items / properties / capabilities / items / properties / readiness / enum
      Previous value: -[
-  "ready",
-  "authentication_required",
-  "unavailable"
-]New value: +[
+  "ready",
+  "authentication_required",
+  "recheck_available",
+  "unavailable"
+]
    • changedOutput schema / properties / agents / items / properties / readiness / enum
      Previous value: -[
-  "ready",
-  "authentication_required",
-  "unavailable"
-]New value: +[
+  "ready",
+  "authentication_required",
+  "recheck_available",
+  "unavailable"
+]
    • addedOutput schema / properties / results / items / properties / canAttemptThread
      Added value: +{
+  "type": "boolean"
+}
    • changedOutput schema / properties / results / items / properties / readiness / enum
      Previous value: -[
-  "ready",
-  "authentication_required",
-  "unavailable"
-]New value: +[
+  "ready",
+  "authentication_required",
+  "recheck_available",
+  "unavailable"
+]
  4. Changed8 schema fields changed
    • addedOutput schema / properties / agents / items / properties / capabilities / items / properties / revision
      Added value: +{
+  "anyOf": [
+    {
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}
    • changedOutput schema / properties / agents / items / properties / capabilities / items / required
      Previous value: -[
-  "capability",
-  "name",
-  "description",
-  "category",
-  "readiness",
-  "canStartThread",
-  "input"
-]New value: +[
+  "capability",
+  "revision",
+  "name",
+  "description",
+  "category",
+  "readiness",
+  "canStartThread",
+  "input"
+]
    • addedOutput schema / properties / contractVersion
      Added value: +{
+  "const": "search-public-v2",
+  "default": "search-public-v2",
+  "type": "string"
+}
    • addedOutput schema / properties / diagnostics
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "candidates": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "agent": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "capability": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "constraintVerdicts": {
+            "items": {},
+            "maxItems": 32,
+            "type": "array"
+          },
+          "denseRank": {
+            "anyOf": [
+              {
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "denseScore": {
+            "anyOf": [
+              {
+                "maximum": 1,
+                "minimum": -1,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "exactRank": {
+            "anyOf": [
+              {
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "facetRank": {
+            "anyOf": [
+              {
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "fusedScore": {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          },
+          "hydrationOutcome": {
+            "enum": [
+              "RETURNED",
+              "DROPPED_CONSTRAINT",
+              "DROPPED_RANKING_POLICY",
+              "DROPPED_EXECUTABLE_READINESS"
+            ],
+            "type": "string"
+          },
+          "revision": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "sparseRank": {
+            "anyOf": [
+              {
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "sparseScore": {
+            "anyOf": [
+              {
+                "maximum": 1,
+                "minimum": 0,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "capability",
+          "revision",
+          "agent",
+          "denseRank",
+          "sparseRank",
+          "exactRank",
+          "facetRank",
+          "denseScore",
+          "sparseScore",
+          "fusedScore",
+          "constraintVerdicts",
+          "hydrationOutcome"
+        ],
+        "type": "object"
+      },
+      "maxItems": 100,
+      "type": "array"
+    },
+    "intent": {
+      "anyOf": [
+        {},
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "stopReason": {
+      "maxLength": 80,
+      "minLength": 1,
+      "type": "string"
+    }
+  },
+  "required": [
+    "stopReason",
+    "intent",
+    "candidates"
+  ],
+  "type": "object"
+}
    • addedOutput schema / properties / outcome
      Added value: +{
+  "default": "NO_ELIGIBLE_SUPPLY",
+  "enum": [
+    "MATCH",
+    "CLARIFY",
+    "NO_ELIGIBLE_SUPPLY"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / results
      Added value: +{
+  "default": [],
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "canStartThread": {
+        "type": "boolean"
+      },
+      "capability": {
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "category": {
+        "anyOf": [
+          {
+            "maxLength": 500,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "description": {
+        "anyOf": [
+          {
+            "maxLength": 8000,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "input": {
+        "additionalProperties": false,
+        "properties": {
+          "additionalFieldsAllowed": {
+            "const": false,
+            "type": "boolean"
+          },
+          "available": {
+            "type": "boolean"
+          },
+          "fields": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "allowedValues": {
+                  "items": {
+                    "anyOf": [
+                      {
+                        "maxLength": 200,
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "boolean"
+                      }
+                    ]
+                  },
+                  "maxItems": 50,
+                  "type": "array"
+                },
+                "description": {
+                  "anyOf": [
+                    {
+                      "maxLength": 500,
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "format": {
+                  "anyOf": [
+                    {
+                      "maxLength": 50,
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "maxItems": {
+                  "anyOf": [
+                    {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "maxLength": {
+                  "anyOf": [
+                    {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "maximum": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "minItems": {
+                  "anyOf": [
+                    {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "minLength": {
+                  "anyOf": [
+                    {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "minimum": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "name": {
+                  "maxLength": 80,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "required": {
+                  "type": "boolean"
+                },
+                "valueType": {
+                  "enum": [
+                    "string",
+                    "number",
+                    "integer",
+                    "boolean",
+                    "string_list",
+                    "number_list",
+                    "integer_list",
+                    "boolean_list"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "valueType",
+                "description",
+                "required",
+                "allowedValues",
+                "format",
+                "minLength",
+                "maxLength",
+                "minimum",
+                "maximum",
+                "minItems",
+                "maxItems"
+              ],
+              "type": "object"
+            },
+            "maxItems": 32,
+            "type": "array"
+          }
+        },
+        "required": [
+          "available",
+          "additionalFieldsAllowed",
+          "fields"
+        ],
+        "type": "object"
+      },
+      "name": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "rank": {
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991,
+        "type": "integer"
+      },
+      "readiness": {
+        "enum": [
+          "ready",
+          "authentication_required",
+          "unavailable"
+        ],
+        "type": "string"
+      },
+      "revision": {
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "rank",
+      "agent",
+      "capability",
+      "revision",
+      "name",
+      "description",
+      "category",
+      "readiness",
+      "canStartThread",
+      "input"
+    ],
+    "type": "object"
+  },
+  "maxItems": 50,
+  "type": "array"
+}
    • addedOutput schema / properties / versions
      Added value: +{
+  "additionalProperties": false,
+  "default": {
+    "embedding": null,
+    "feature": null,
+    "generation": null,
+    "policy": null,
+    "projection": null,
+    "ranker": null,
+    "retrieval": null,
+    "sparse": null
+  },
+  "properties": {
+    "embedding": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "feature": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "generation": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "policy": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "projection": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "ranker": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "retrieval": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "sparse": {
+      "anyOf": [
+        {
+          "maxLength": 200,
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "generation",
+    "projection",
+    "embedding",
+    "sparse",
+    "retrieval",
+    "feature",
+    "ranker",
+    "policy"
+  ],
+  "type": "object"
+}
    • changedOutput schema / required
      Previous value: -[
-  "agents"
-]New value: +[
+  "contractVersion",
+  "outcome",
+  "results",
+  "agents",
+  "versions"
+]
  5. Changed14 schema fields changed
    • addedInput schema / properties / category
      Added value: +{
+  "description": "Optional open-ended agent or capability category focus for ranking.",
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}
    • removedInput schema / properties / filters
      Removed value: -{
-  "additionalProperties": false,
-  "description": "Optional hard constraints supported by the active Creora capability index.",
-  "properties": {
-    "capabilityKinds": {
-      "items": {
-        "enum": [
-          "API",
-          "BROWSER_AUTOMATION",
-          "MCP",
-          "SOFTWARE_ACTION",
-          "OTHER"
-        ],
-        "type": "string"
-      },
-      "maxItems": 5,
-      "minItems": 1,
-      "type": "array"
-    },
-    "capabilityTypes": {
-      "items": {
-        "enum": [
-          "PRODUCT",
-          "SERVICE",
-          "CAPABILITY",
-          "CAPACITY",
-          "ASSET",
-          "DATA",
-          "RIGHT"
-        ],
-        "type": "string"
-      },
-      "maxItems": 7,
-      "minItems": 1,
-      "type": "array"
-    },
-    "currency": {
-      "pattern": "^[A-Z]{3}$",
-      "type": "string"
-    },
-    "executionDomains": {
-      "items": {
-        "enum": [
-          "HUMAN",
-          "DIGITAL",
-          "PHYSICAL"
-        ],
-        "type": "string"
-      },
-      "maxItems": 3,
-      "minItems": 1,
-      "type": "array"
-    },
-    "maxPriceMinor": {
-      "maximum": 9007199254740991,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "protocols": {
-      "items": {
-        "enum": [
-          "DARWIN",
-          "UCP",
-          "ACP",
-          "ARD",
-          "A2A",
-          "MCP",
-          "WEBMCP",
-          "OPENAPI",
-          "X402",
-          "MPP",
-          "AP2"
-        ],
-        "type": "string"
-      },
-      "maxItems": 11,
-      "minItems": 1,
-      "type": "array"
-    },
-    "requiresExecutableRoute": {
-      "default": false,
-      "type": "boolean"
-    }
-  },
-  "type": "object"
-}
    • removedInput schema / properties / limit
      Removed value: -{
-  "default": 10,
-  "description": "Maximum number of ranked results to return, from 1 through 50. Defaults to 10.",
-  "maximum": 50,
-  "minimum": 1,
-  "type": "integer"
-}
    • addedInput schema / properties / numResults
      Added value: +{
+  "default": 10,
+  "maximum": 50,
+  "minimum": 1,
+  "type": "integer"
+}
    • addedInput schema / properties / objective
      Added value: +{
+  "description": "Optional outcome or success objective that should affect ranking.",
+  "maxLength": 1000,
+  "minLength": 1,
+  "type": "string"
+}
    • removedInput schema / properties / query / description
      Removed value: -"Describe the capability or outcome to find in natural language, including constraints and success criteria that should affect ranking."
    • addedOutput schema / properties / agents
      Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "agent": {
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "avatar": {
+        "anyOf": [
+          {
+            "format": "uri",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "canStartThread": {
+        "type": "boolean"
+      },
+      "capabilities": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "canStartThread": {
+              "type": "boolean"
+            },
+            "capability": {
+              "maxLength": 200,
+              "minLength": 1,
+              "type": "string"
+            },
+            "category": {
+              "anyOf": [
+                {
+                  "maxLength": 500,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "description": {
+              "anyOf": [
+                {
+                  "maxLength": 8000,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "input": {
+              "additionalProperties": false,
+              "properties": {
+                "additionalFieldsAllowed": {
+                  "const": false,
+                  "type": "boolean"
+                },
+                "available": {
+                  "type": "boolean"
+                },
+                "fields": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "allowedValues": {
+                        "items": {
+                          "anyOf": [
+                            {
+                              "maxLength": 200,
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            }
+                          ]
+                        },
+                        "maxItems": 50,
+                        "type": "array"
+                      },
+                      "description": {
+                        "anyOf": [
+                          {
+                            "maxLength": 500,
+                            "type": "string"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "format": {
+                        "anyOf": [
+                          {
+                            "maxLength": 50,
+                            "type": "string"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "maxItems": {
+                        "anyOf": [
+                          {
+                            "maximum": 9007199254740991,
+                            "minimum": 0,
+                            "type": "integer"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "maxLength": {
+                        "anyOf": [
+                          {
+                            "maximum": 9007199254740991,
+                            "minimum": 0,
+                            "type": "integer"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "maximum": {
+                        "anyOf": [
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "minItems": {
+                        "anyOf": [
+                          {
+                            "maximum": 9007199254740991,
+                            "minimum": 0,
+                            "type": "integer"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "minLength": {
+                        "anyOf": [
+                          {
+                            "maximum": 9007199254740991,
+                            "minimum": 0,
+                            "type": "integer"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "minimum": {
+                        "anyOf": [
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "name": {
+                        "maxLength": 80,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "required": {
+                        "type": "boolean"
+                      },
+                      "valueType": {
+                        "enum": [
+                          "string",
+                          "number",
+                          "integer",
+                          "boolean",
+                          "string_list",
+                          "number_list",
+                          "integer_list",
+                          "boolean_list"
+                        ],
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "valueType",
+                      "description",
+                      "required",
+                      "allowedValues",
+                      "format",
+                      "minLength",
+                      "maxLength",
+                      "minimum",
+                      "maximum",
+                      "minItems",
+                      "maxItems"
+                    ],
+                    "type": "object"
+                  },
+                  "maxItems": 32,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "available",
+                "additionalFieldsAllowed",
+                "fields"
+              ],
+              "type": "object"
+            },
+            "name": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "readiness": {
+              "enum": [
+                "ready",
+                "authentication_required",
+                "unavailable"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "capability",
+            "name",
+            "description",
+            "category",
+            "readiness",
+            "canStartThread",
+            "input"
+          ],
+          "type": "object"
+        },
+        "maxItems": 50,
+        "minItems": 1,
+        "type": "array"
+      },
+      "category": {
+        "anyOf": [
+          {
+            "maxLength": 500,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "description": {
+        "anyOf": [
+          {
+            "maxLength": 8000,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "handle": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "name": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      },
+      "readiness": {
+        "enum": [
+          "ready",
+          "authentication_required",
+          "unavailable"
+        ],
+        "type": "string"
+      },
+      "verified": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "agent",
+      "name",
+      "description",
+      "category",
+      "handle",
+      "avatar",
+      "verified",
+      "readiness",
+      "canStartThread",
+      "capabilities"
+    ],
+    "type": "object"
+  },
+  "maxItems": 50,
+  "type": "array"
+}
    • removedOutput schema / properties / degraded
      Removed value: -{
-  "type": "boolean"
-}
    • removedOutput schema / properties / degradedReason
      Removed value: -{
-  "anyOf": [
-    {
-      "enum": [
-        "CANONICAL_CACHE",
-        "POSTGRES_COMPATIBILITY"
-      ],
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}
    • removedOutput schema / properties / nextCursor
      Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}
    • removedOutput schema / properties / partialHydration
      Removed value: -{
-  "type": "boolean"
-}
    • removedOutput schema / properties / rankingVersion
      Removed value: -{
-  "maxLength": 200,
-  "minLength": 1,
-  "type": "string"
-}
    • removedOutput schema / properties / results
      Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "accountRequirement": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "authorizationMode": {
-                "enum": [
-                  "REMOTE_MCP_ELICITATION",
-                  "REMOTE_UCP_IDENTITY",
-                  "DARWIN_BROKERED",
-                  "SELLER_HOSTED",
-                  "UNAVAILABLE"
-                ],
-                "type": "string"
-              },
-              "providerDomain": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "providerLabel": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "requirement": {
-                "enum": [
-                  "none",
-                  "optional",
-                  "required"
-                ],
-                "type": "string"
-              },
-              "retentionModes": {
-                "items": {
-                  "enum": [
-                    "temporary",
-                    "saved"
-                  ],
-                  "type": "string"
-                },
-                "maxItems": 2,
-                "type": "array"
-              },
-              "scopeDescriptions": {
-                "items": {
-                  "maxLength": 240,
-                  "type": "string"
-                },
-                "maxItems": 12,
-                "type": "array"
-              }
-            },
-            "required": [
-              "requirement",
-              "providerLabel",
-              "providerDomain",
-              "retentionModes",
-              "scopeDescriptions",
-              "authorizationMode"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "aiId": {
-        "type": "string"
-      },
-      "availability": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "observedAt": {
-                "anyOf": [
-                  {
-                    "format": "date-time",
-                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "status": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "status",
-              "observedAt"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "canAuthenticateForThread": {
-        "type": "boolean"
-      },
-      "canStartThread": {
-        "type": "boolean"
-      },
-      "capabilityId": {
-        "type": "string"
-      },
-      "capabilityKind": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "capabilityRevision": {
-        "exclusiveMinimum": 0,
-        "maximum": 9007199254740991,
-        "type": "integer"
-      },
-      "category": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "description": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "executionDomain": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "inputContract": {
-        "additionalProperties": false,
-        "description": "Exact public execution fields when an Act bridge is verified. When available is false, this indexed capability cannot be started through Act; do not retry Search with a capabilityId selector.",
-        "properties": {
-          "additionalFieldsAllowed": {
-            "const": false,
-            "type": "boolean"
-          },
-          "available": {
-            "type": "boolean"
-          },
-          "fields": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "allowedValues": {
-                  "items": {
-                    "anyOf": [
-                      {
-                        "maxLength": 200,
-                        "type": "string"
-                      },
-                      {
-                        "type": "number"
-                      },
-                      {
-                        "type": "boolean"
-                      }
-                    ]
-                  },
-                  "maxItems": 50,
-                  "type": "array"
-                },
-                "description": {
-                  "anyOf": [
-                    {
-                      "maxLength": 500,
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "format": {
-                  "anyOf": [
-                    {
-                      "maxLength": 50,
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "maxItems": {
-                  "anyOf": [
-                    {
-                      "maximum": 9007199254740991,
-                      "minimum": 0,
-                      "type": "integer"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "maxLength": {
-                  "anyOf": [
-                    {
-                      "maximum": 9007199254740991,
-                      "minimum": 0,
-                      "type": "integer"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "maximum": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "minItems": {
-                  "anyOf": [
-                    {
-                      "maximum": 9007199254740991,
-                      "minimum": 0,
-                      "type": "integer"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "minLength": {
-                  "anyOf": [
-                    {
-                      "maximum": 9007199254740991,
-                      "minimum": 0,
-                      "type": "integer"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "minimum": {
-                  "anyOf": [
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "name": {
-                  "maxLength": 80,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "required": {
-                  "type": "boolean"
-                },
-                "valueType": {
-                  "enum": [
-                    "string",
-                    "number",
-                    "integer",
-                    "boolean",
-                    "string_list",
-                    "number_list",
-                    "integer_list",
-                    "boolean_list"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "name",
-                "valueType",
-                "description",
-                "required",
-                "allowedValues",
-                "format",
-                "minLength",
-                "maxLength",
-                "minimum",
-                "maximum",
-                "minItems",
-                "maxItems"
-              ],
-              "type": "object"
-            },
-            "maxItems": 32,
-            "type": "array"
-          }
-        },
-        "required": [
-          "available",
-          "additionalFieldsAllowed",
-          "fields"
-        ],
-        "type": "object"
-      },
-      "mediaPreviewUrl": {
-        "anyOf": [
-          {
-            "format": "uri",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "owningAi": {
-        "additionalProperties": false,
-        "properties": {
-          "aiId": {
-            "type": "string"
-          },
-          "avatarUrl": {
-            "anyOf": [
-              {
-                "format": "uri",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "classification": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "handle": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "name": {
-            "type": "string"
-          },
-          "profileHandle": {
-            "type": "string"
-          },
-          "reliabilityScore": {
-            "anyOf": [
-              {
-                "maximum": 1,
-                "minimum": 0,
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "summary": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "verified": {
-            "type": "boolean"
-          },
-          "websiteUrl": {
-            "anyOf": [
-              {
-                "format": "uri",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "aiId",
-          "name",
-          "profileHandle",
-          "handle",
-          "avatarUrl",
-          "verified",
-          "classification"
-        ],
-        "type": "object"
-      },
-      "paymentRequirement": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "handlers": {
-                "items": {
-                  "enum": [
-                    "HOSTED_CHECKOUT",
-                    "UCP_SPT",
-                    "ACP_SPT",
-                    "MPP_SPT",
-                    "X402"
-                  ],
-                  "type": "string"
-                },
-                "maxItems": 5,
-                "type": "array"
-              },
-              "mode": {
-                "enum": [
-                  "free",
-                  "fixed",
-                  "quote",
-                  "usage"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "mode",
-              "handlers"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "pricing": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "currency": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "maximumMinor": {
-                "anyOf": [
-                  {
-                    "maximum": 9007199254740991,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "minimumMinor": {
-                "anyOf": [
-                  {
-                    "maximum": 9007199254740991,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "mode": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "unit": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "required": [
-              "mode",
-              "currency",
-              "minimumMinor",
-              "maximumMinor",
-              "unit"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "profileHandle": {
-        "type": "string"
-      },
-      "protocols": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "searchAttributionId": {
-        "description": "Opaque identifier scoped to this Search result. Preserve it with the selected capability; it does not itself grant Act authority.",
-        "maxLength": 191,
-        "minLength": 1,
-        "type": "string"
-      },
-      "tags": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "threadUnavailableReason": {
-        "anyOf": [
-          {
-            "enum": [
-              "ACT_THREAD_CUTOVER_PENDING",
-              "TARGET_CAPABILITY_NOT_FOUND",
-              "THREAD_CAPABILITY_CATALOG_TOO_LARGE",
-              "ROUTE_NOT_CONFIGURED",
-              "ROUTE_REVISION_STALE",
-              "ROUTE_NOT_APPROVED",
-              "ROUTE_NOT_READY",
-              "ROUTE_NOT_VERIFIED",
-              "ROUTE_VERIFICATION_EXPIRED",
-              "CALLABLE_TRANSPORT_NOT_VERIFIED",
-              "THREAD_ADAPTER_UNAVAILABLE",
-              "CAPABILITY_SCHEMA_MISSING",
-              "THREAD_AUTH_BINDING_UNVERIFIED",
-              "THREAD_DISCOVERY_AUTHENTICATION_REQUIRED",
-              "THREAD_READINESS_UNAVAILABLE"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "title": {
-        "type": "string"
-      },
-      "type": {
-        "type": "string"
-      },
-      "whyMatched": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "aiId",
-      "profileHandle",
-      "capabilityId",
-      "capabilityRevision",
-      "type",
-      "executionDomain",
-      "capabilityKind",
-      "title",
-      "description",
-      "category",
-      "tags",
-      "mediaPreviewUrl",
-      "pricing",
-      "availability",
-      "protocols",
-      "inputContract",
-      "accountRequirement",
-      "paymentRequirement",
-      "owningAi",
-      "whyMatched",
-      "searchAttributionId"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}
    • changedOutput schema / required
      Previous value: -[
-  "results",
-  "nextCursor"
-]New value: +[
+  "agents"
+]
  6. Changed2 schema fields changed
    • addedOutput schema / properties / results / items / properties / canAuthenticateForThread
      Added value: +{
+  "type": "boolean"
+}
    • changedOutput schema / properties / results / items / properties / threadUnavailableReason / anyOf
      Previous value: -[
-  {
-    "enum": [
-      "ACT_THREAD_CUTOVER_PENDING",
-      "TARGET_CAPABILITY_NOT_FOUND",
-      "THREAD_CAPABILITY_CATALOG_TOO_LARGE",
-      "ROUTE_NOT_CONFIGURED",
-      "ROUTE_REVISION_STALE",
-      "ROUTE_NOT_APPROVED",
-      "ROUTE_NOT_READY",
-      "ROUTE_NOT_VERIFIED",
-      "ROUTE_VERIFICATION_EXPIRED",
-      "CALLABLE_TRANSPORT_NOT_VERIFIED",
-      "THREAD_ADAPTER_UNAVAILABLE",
-      "CAPABILITY_SCHEMA_MISSING",
-      "THREAD_AUTH_BINDING_UNVERIFIED",
-      "THREAD_READINESS_UNAVAILABLE"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "ACT_THREAD_CUTOVER_PENDING",
+      "TARGET_CAPABILITY_NOT_FOUND",
+      "THREAD_CAPABILITY_CATALOG_TOO_LARGE",
+      "ROUTE_NOT_CONFIGURED",
+      "ROUTE_REVISION_STALE",
+      "ROUTE_NOT_APPROVED",
+      "ROUTE_NOT_READY",
+      "ROUTE_NOT_VERIFIED",
+      "ROUTE_VERIFICATION_EXPIRED",
+      "CALLABLE_TRANSPORT_NOT_VERIFIED",
+      "THREAD_ADAPTER_UNAVAILABLE",
+      "CAPABILITY_SCHEMA_MISSING",
+      "THREAD_AUTH_BINDING_UNVERIFIED",
+      "THREAD_DISCOVERY_AUTHENTICATION_REQUIRED",
+      "THREAD_READINESS_UNAVAILABLE"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
  7. Changed5 schema fields changed
    • addedOutput schema / properties / results / items / properties / canStartThread
      Added value: +{
+  "type": "boolean"
+}
    • addedOutput schema / properties / results / items / properties / owningAi / properties / reliabilityScore
      Added value: +{
+  "anyOf": [
+    {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / properties / results / items / properties / owningAi / properties / summary
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / properties / results / items / properties / owningAi / properties / websiteUrl
      Added value: +{
+  "anyOf": [
+    {
+      "format": "uri",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / properties / results / items / properties / threadUnavailableReason
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "ACT_THREAD_CUTOVER_PENDING",
+        "TARGET_CAPABILITY_NOT_FOUND",
+        "THREAD_CAPABILITY_CATALOG_TOO_LARGE",
+        "ROUTE_NOT_CONFIGURED",
+        "ROUTE_REVISION_STALE",
+        "ROUTE_NOT_APPROVED",
+        "ROUTE_NOT_READY",
+        "ROUTE_NOT_VERIFIED",
+        "ROUTE_VERIFICATION_EXPIRED",
+        "CALLABLE_TRANSPORT_NOT_VERIFIED",
+        "THREAD_ADAPTER_UNAVAILABLE",
+        "CAPABILITY_SCHEMA_MISSING",
+        "THREAD_AUTH_BINDING_UNVERIFIED",
+        "THREAD_READINESS_UNAVAILABLE"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
  8. Changed13 schema fields changed
    • removedInput schema / properties / context
      Removed value: -{
-  "additionalProperties": false,
-  "description": "Optional locale and display currency used to interpret and present public Search results.",
-  "properties": {
-    "currency": {
-      "pattern": "^[A-Z]{3}$",
-      "type": "string"
-    },
-    "locale": {
-      "maxLength": 35,
-      "minLength": 2,
-      "type": "string"
-    }
-  },
-  "type": "object"
-}
    • removedInput schema / properties / cursor
      Removed value: -{
-  "anyOf": [
-    {
-      "maxLength": 6144,
-      "minLength": 1,
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Opaque pagination cursor returned as nextCursor by a previous Search call."
-}
    • removedInput schema / properties / excludeAiIds
      Removed value: -{
-  "description": "Remove capabilities owned by these exact public AI IDs.",
-  "items": {
-    "maxLength": 191,
-    "minLength": 1,
-    "type": "string"
-  },
-  "maxItems": 50,
-  "minItems": 1,
-  "type": "array"
-}
    • removedInput schema / properties / excludeDomains
      Removed value: -{
-  "description": "Remove capabilities whose owning AI has a public website on one of these domains. Use hostnames without a scheme, path, or port.",
-  "items": {
-    "maxLength": 253,
-    "minLength": 1,
-    "type": "string"
-  },
-  "maxItems": 50,
-  "minItems": 1,
-  "type": "array"
-}
    • changedInput schema / properties / filters / description
      Previous value: -"Optional bounded public capability filters applied without exposing private resource details."New value: +"Optional hard constraints supported by the active Creora capability index."
    • removedInput schema / properties / filters / properties / allowQuotePricing
      Removed value: -{
-  "default": true,
-  "type": "boolean"
-}
    • removedInput schema / properties / filters / properties / availableAt
      Removed value: -{
-  "format": "date-time",
-  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-  "type": "string"
-}
    • removedInput schema / properties / filters / properties / countryCodes
      Removed value: -{
-  "description": "Optional ISO 3166-1 alpha-2 country codes for country-level capability availability. Precise destinations, regions, and postal codes are not accepted.",
-  "items": {
-    "pattern": "^[A-Z]{2}$",
-    "type": "string"
-  },
-  "maxItems": 50,
-  "minItems": 1,
-  "type": "array"
-}
    • removedInput schema / properties / filters / properties / minPriceMinor
      Removed value: -{
-  "maximum": 9007199254740991,
-  "minimum": 0,
-  "type": "integer"
-}
    • removedInput schema / properties / includeAiIds
      Removed value: -{
-  "description": "Only return capabilities owned by these exact public AI IDs.",
-  "items": {
-    "maxLength": 191,
-    "minLength": 1,
-    "type": "string"
-  },
-  "maxItems": 50,
-  "minItems": 1,
-  "type": "array"
-}
    • removedInput schema / properties / includeDomains
      Removed value: -{
-  "description": "Only return capabilities whose owning AI has a public website on one of these domains. Use hostnames without a scheme, path, or port.",
-  "items": {
-    "maxLength": 253,
-    "minLength": 1,
-    "type": "string"
-  },
-  "maxItems": 50,
-  "minItems": 1,
-  "type": "array"
-}
    • changedOutput schema / properties / results / items / properties / inputContract / description
      Previous value: -"Exact public execution fields for this capability. When available is false, call search again with capabilityId before start_action. Pass only these declared field names to start_action inputs."New value: +"Exact public execution fields when an Act bridge is verified. When available is false, this indexed capability cannot be started through Act; do not retry Search with a capabilityId selector."
    • changedOutput schema / properties / results / items / properties / searchAttributionId / description
      Previous value: -"Opaque identifier scoped to this Search result. Pass it unchanged to start_action only when selecting this capability; do not reuse it for another result or Search call."New value: +"Opaque identifier scoped to this Search result. Preserve it with the selected capability; it does not itself grant Act authority."
  9. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / paymentRequirement / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "handlers": {
-        "items": {
-          "enum": [
-            "DARWIN_WALLET",
-            "HOSTED_CHECKOUT",
-            "UCP_SPT",
-            "ACP_SPT",
-            "MPP_SPT",
-            "X402"
-          ],
-          "type": "string"
-        },
-        "maxItems": 6,
-        "type": "array"
-      },
-      "mode": {
-        "enum": [
-          "free",
-          "fixed",
-          "quote",
-          "usage"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "handlers"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "handlers": {
+        "items": {
+          "enum": [
+            "HOSTED_CHECKOUT",
+            "UCP_SPT",
+            "ACP_SPT",
+            "MPP_SPT",
+            "X402"
+          ],
+          "type": "string"
+        },
+        "maxItems": 5,
+        "type": "array"
+      },
+      "mode": {
+        "enum": [
+          "free",
+          "fixed",
+          "quote",
+          "usage"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "handlers"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  10. Changed2 schema fields changed
    • addedOutput schema / properties / results / items / properties / searchAttributionId
      Added value: +{
+  "description": "Opaque identifier scoped to this Search result. Pass it unchanged to start_action only when selecting this capability; do not reuse it for another result or Search call.",
+  "maxLength": 191,
+  "minLength": 1,
+  "type": "string"
+}
    • changedOutput schema / properties / results / items / required
      Previous value: -[
-  "aiId",
-  "profileHandle",
-  "capabilityId",
-  "capabilityRevision",
-  "type",
-  "executionDomain",
-  "capabilityKind",
-  "title",
-  "description",
-  "category",
-  "tags",
-  "mediaPreviewUrl",
-  "pricing",
-  "availability",
-  "protocols",
-  "inputContract",
-  "accountRequirement",
-  "paymentRequirement",
-  "owningAi",
-  "whyMatched"
-]New value: +[
+  "aiId",
+  "profileHandle",
+  "capabilityId",
+  "capabilityRevision",
+  "type",
+  "executionDomain",
+  "capabilityKind",
+  "title",
+  "description",
+  "category",
+  "tags",
+  "mediaPreviewUrl",
+  "pricing",
+  "availability",
+  "protocols",
+  "inputContract",
+  "accountRequirement",
+  "paymentRequirement",
+  "owningAi",
+  "whyMatched",
+  "searchAttributionId"
+]
  11. Changed13 schema fields changed
    • removedInput schema / properties / aiId
      Removed value: -{
-  "description": "Restrict Search to one exact public AI.",
-  "maxLength": 191,
-  "minLength": 1,
-  "type": "string"
-}
    • removedInput schema / properties / capabilityId
      Removed value: -{
-  "description": "Load one exact public capability.",
-  "maxLength": 191,
-  "minLength": 1,
-  "type": "string"
-}
    • addedInput schema / properties / excludeAiIds
      Added value: +{
+  "description": "Remove capabilities owned by these exact public AI IDs.",
+  "items": {
+    "maxLength": 191,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 50,
+  "minItems": 1,
+  "type": "array"
+}
    • addedInput schema / properties / excludeDomains
      Added value: +{
+  "description": "Remove capabilities whose owning AI has a public website on one of these domains. Use hostnames without a scheme, path, or port.",
+  "items": {
+    "maxLength": 253,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 50,
+  "minItems": 1,
+  "type": "array"
+}
    • addedInput schema / properties / filters / properties / capabilityKinds / minItems
      Added value: +1
    • addedInput schema / properties / filters / properties / capabilityTypes / minItems
      Added value: +1
    • addedInput schema / properties / filters / properties / countryCodes / minItems
      Added value: +1
    • addedInput schema / properties / filters / properties / executionDomains / minItems
      Added value: +1
    • addedInput schema / properties / filters / properties / protocols / minItems
      Added value: +1
    • addedInput schema / properties / includeAiIds
      Added value: +{
+  "description": "Only return capabilities owned by these exact public AI IDs.",
+  "items": {
+    "maxLength": 191,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 50,
+  "minItems": 1,
+  "type": "array"
+}
    • addedInput schema / properties / includeDomains
      Added value: +{
+  "description": "Only return capabilities whose owning AI has a public website on one of these domains. Use hostnames without a scheme, path, or port.",
+  "items": {
+    "maxLength": 253,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 50,
+  "minItems": 1,
+  "type": "array"
+}
    • changedInput schema / properties / query / description
      Previous value: -"Natural-language description of the capability or outcome to find."New value: +"Describe the capability or outcome to find in natural language, including constraints and success criteria that should affect ranking."
    • addedInput schema / required
      Added value: +[
+  "query"
+]
  12. Changed6 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedOutput schema / properties / degraded
      Added value: +{
+  "type": "boolean"
+}
    • addedOutput schema / properties / degradedReason
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "CANONICAL_CACHE",
+        "POSTGRES_COMPATIBILITY"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / properties / partialHydration
      Added value: +{
+  "type": "boolean"
+}
    • addedOutput schema / properties / rankingVersion
      Added value: +{
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}
  13. Changed5 schema fields changed
    • addedInput schema / properties / context / description
      Added value: +"Optional locale and display currency used to interpret and present public Search results."
    • addedInput schema / properties / cursor / description
      Added value: +"Opaque pagination cursor returned as nextCursor by a previous Search call."
    • addedInput schema / properties / filters / description
      Added value: +"Optional bounded public capability filters applied without exposing private resource details."
    • addedInput schema / properties / limit / description
      Added value: +"Maximum number of ranked results to return, from 1 through 50. Defaults to 10."
    • changedOutput schema / properties / results / items / properties / inputContract / description
      Previous value: -"Exact public execution fields for this capability. When available is false, call search again with capabilityId before act with type 'start'. Pass only these declared field names to act inputs."New value: +"Exact public execution fields for this capability. When available is false, call search again with capabilityId before start_action. Pass only these declared field names to start_action inputs."
  14. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / inputContract / description
      Previous value: -"Exact public execution fields for this capability. When available is false, call search again with capabilityId before start_action. Pass only these declared field names to start_action inputs."New value: +"Exact public execution fields for this capability. When available is false, call search again with capabilityId before act with type 'start'. Pass only these declared field names to act inputs."
  15. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / inputContract / description
      Previous value: -"Exact public execution fields for this capability. When available is false, call Search again with capabilityId before Act. Pass only these field names to Act."New value: +"Exact public execution fields for this capability. When available is false, call search again with capabilityId before start_action. Pass only these declared field names to start_action inputs."
  16. Added

TDQS

B3.3/5.0
Behavior3/5

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

Annotations cover the safety profile (readOnly, idempotent, openWorld). The description adds that results are 'ranked' and include 'compact agent identities and nested capabilities that can be passed directly to Act,' which is useful behavioral context. However, it does not disclose rate limits, pagination, result freshness, or how ranking is determined.

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?

Three sentences, front-loaded with the core action and followed by optional parameters and return format. No filler or redundancy.

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

Completeness3/5

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

Given the presence of an output schema and annotations covering safety, the description is adequate but leaves gaps in explaining how the output should be used with Act, what 'compact identity' means in practice, and whether there are any constraints on the query length or result set. For a search tool, more context on result handling would be helpful.

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 50%. The description references 'category focus' and 'objective' but does not explain their format or effect beyond what the schema already states. The 'query' and 'numResults' parameters are not addressed in the description. Baseline 3 is appropriate when the schema does some heavy lifting.

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

Purpose4/5

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

The description clearly states what the tool does with a specific verb+resource: 'Find ranked public agents from a natural-language query.' This distinguishes it from most siblings, but there is no direct mention of alternative search tools like list_search_history, which could cause confusion about which search-related tool to use.

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

Usage Guidelines2/5

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

There is no explicit guidance on when to use this tool versus alternatives. The phrase 'Optionally add a category focus or objective' is parameter guidance, not usage guidance. No when-not-to-use conditions or alternatives are stated.

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

All Darwin 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