Added value: +{
+  "type": "boolean"
+}

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: -"Return exactly these top-level keys (overrides view)."New value: +"Only these top-level keys, e.g. [\"slug\",\"score\"]."

Previous value: -"via_provider — also return the APIs of providers whose name matched `q`, the union apis_io_search counts. Needs `q`; adds nothing without one."New value: +"via_provider: also return APIs of providers whose name matched `q`. Needs `q`."

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: -"Access model — how to start: open (no key), self-serve, approval. (providers only)"New value: +"open (no key) | self-serve | approval."

Previous value: -"Page number, 1-based (default 1). Use with `limit` to walk a long list."New value: +"Page number, 1-based (default 1)."

Previous value: -"Access model — pricing: free, freemium, free-trial, paid, enterprise. (providers only)"New value: +"free | freemium | free-trial | paid | enterprise, e.g. [\"free\"]."

Previous value: -"modeled: real APIs behind a partner/contract gate whose shape API Evangelist drew (no public reference); unpublished: product areas with NO API behind them (listed for completeness, not counted); published: every real API, modeled included; documented: only entries with neither mark. Omit to list all; every marked row carries `provenance`."New value: +"modeled | unpublished | published | documented, e.g. \"documented\". Omit for all. Meanings: apis://docs/tools/find_apis."

Previous value: -"Provider slugs to restrict results to, e.g. [\"stripe\",\"adyen\"]."New value: +"Provider slugs, e.g. [\"stripe\"]."

Previous value: -"Only providers callable publicly with no signup (onboarding=open). (providers only)"New value: +"Callable with no signup (onboarding=open)."

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: -"When `q` exactly names a tag, apis.io uses it: on PROVIDERS a resource tag (order, webhook, image) replaces the text search with the companies that classify themselves there — 2,182 text matches for \"order\" become the 92 that claim it; on APIS the tag's members are ADDED to the text matches, never swapped for them. Market tags (payments) and tags almost no company claims are reported and not applied. Set `off` for pure text. The resolution is always echoed as `resolved_tag`."New value: +"on (default) uses a tag `q` names; off = text only."

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)."

Previous value: -"Only providers a developer can start using at no cost right now (free/trial + self-serve/open). (providers only)"New value: +"Usable at no cost right now (free/trial + self-serve/open)."

Previous value: -"summary (default) returns lean discovery records + *_count for dropped sections; full returns the whole record (use get_api / get_provider for one entity)."New value: +"summary (default, lean) or full."

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: +"Results per page, 1-100 (default 25)."

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: +"Page number, 1-based (default 1). Use with `limit` to walk a long list."

Added value: +"Provider slugs to restrict results to, e.g. [\"stripe\",\"adyen\"]."

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

Added value: +{
+  "description": "modeled: real APIs behind a partner/contract gate whose shape API Evangelist drew (no public reference); unpublished: product areas with NO API behind them (listed for completeness, not counted); published: every real API, modeled included; documented: only entries with neither mark. Omit to list all; every marked row carries `provenance`.",
+  "enum": [
+    "modeled",
+    "unpublished",
+    "published",
+    "documented"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "via_provider — also return the APIs of providers whose name matched `q`, the union apis_io_search counts. Needs `q`; adds nothing without one.",
+  "items": {
+    "enum": [
+      "via_provider"
+    ]
+  },
+  "type": "array"
+}

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: +{
+  "default": "on",
+  "description": "When `q` exactly names a tag, apis.io uses it: on PROVIDERS a resource tag (order, webhook, image) replaces the text search with the companies that classify themselves there — 2,182 text matches for \"order\" become the 92 that claim it; on APIS the tag's members are ADDED to the text matches, never swapped for them. Market tags (payments) and tags almost no company claims are reported and not applied. Set `off` for pure text. The resolution is always echoed as `resolved_tag`.",
+  "enum": [
+    "on",
+    "off"
+  ],
+  "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"
+}

Added value: +{
+  "description": "Access model — how to start: open (no key), self-serve, approval. (providers only)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Access model — pricing: free, freemium, free-trial, paid, enterprise. (providers only)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Only providers callable publicly with no signup (onboarding=open). (providers only)",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Only providers a developer can start using at no cost right now (free/trial + self-serve/open). (providers only)",
+  "type": "boolean"
+}

Added value: +"Return exactly these top-level keys (overrides view)."

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: +{
+  "default": "summary",
+  "description": "summary (default) returns lean discovery records + *_count for dropped sections; full returns the whole record (use get_api / get_provider for one entity).",
+  "enum": [
+    "summary",
+    "full"
+  ],
+  "type": "string"
+}

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