Previous value: -"Area slugs, as find_areas returns them, e.g. [\"security\"]."New value: +"Area slugs, e.g. [\"security\"]."

Previous value: -"Artifact types an API must carry, e.g. [\"OpenAPI\",\"AsyncAPI\",\"Postman\"]. Synonyms fold (MCPServer = MCP)."New value: +"Artifact types required, e.g. [\"OpenAPI\"]."

Previous value: -"Rating bands: exemplar, strong, developing, thin, minimal."New value: +"exemplar | strong | developing | thin | minimal."

Previous value: -"Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable."New value: +"Optional: one sentence on why you are asking. Never used to rank; read only if a result is wrong."

Previous value: -"Industry slugs, as find_industries returns them, e.g. [\"artificial-intelligence\"]."New value: +"Industry slugs, e.g. [\"fintech\"]."

Previous value: -"How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."New value: +"How `tags` combine: any (default) or all."

Previous value: -"Only providers whose Kin Score composite is at or above this, 0-100, e.g. 60."New value: +"Minimum Kin Score composite (0-100), e.g. 60."

Previous value: -"Free text over name + description."New value: +"Free text over name + description, e.g. \"sms\"."

Previous value: -"Region slugs, as find_regions returns them, e.g. [\"north-america\"]."New value: +"Region slugs, e.g. [\"north-america\"]."

Previous value: -"Order results. Default: relevance with a query, composite (quality) when browsing. `demand` = Fortune-1000 adoption, scoped to the query."New value: +"Default: relevance with `q`, else composite."

Previous value: -"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or find_providers?api_tags= to reach companies whose APIs merely touch it."New value: +"Tag slugs, e.g. [\"payments\"]. On providers: what the company does (see api_tags)."

Added value: +"Area slugs, as find_areas returns them, e.g. [\"security\"]."

Added value: +"Artifact types an API must carry, e.g. [\"OpenAPI\",\"AsyncAPI\",\"Postman\"]. Synonyms fold (MCPServer = MCP)."

Added value: +"Industry slugs, as find_industries returns them, e.g. [\"artificial-intelligence\"]."

Added value: +"How multiple `tags` combine: \"any\" (default, at least one) or \"all\" (every tag)."

Added value: +"Only providers whose Kin Score composite is at or above this, 0-100, e.g. 60."

Added value: +"Provider slugs to restrict all three sections to, e.g. [\"stripe\"]."

Added value: +"Region slugs, as find_regions returns them, e.g. [\"north-america\"]."

Previous value: -"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or api_tags below."New value: +"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or find_providers?api_tags= to reach companies whose APIs merely touch it."

Added value: +{
+  "description": "Return only this kind of match. Default: every kind.",
+  "enum": [
+    "apis",
+    "providers",
+    "tags"
+  ],
+  "type": "string"
+}

Previous value: -"Tag slugs."New value: +"Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or api_tags below."

Added value: +{
+  "description": "Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable.",
+  "type": "string"
+}

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Previous value: -25New value: +5

Added value: +"Top matches to return per section (apis/providers/tags)."

Previous value: -100New value: +25

Removed value: -{
-  "default": 1,
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -{
-  "default": "apis",
-  "enum": [
-    "apis",
-    "providers",
-    "tags"
-  ],
-  "type": "string"
-}

Added value: +"Order results. Default: relevance with a query, composite (quality) when browsing. `demand` = Fortune-1000 adoption, scoped to the query."

Added value: +[
+  "relevance",
+  "composite",
+  "name",
+  "created",
+  "modified",
+  "api_count",
+  "demand"
+]

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}