x-tool-description
`x-tool-description` appears on operations. Its value is a string. Used by a single provider across 1 OpenAPI document. Observed values include `Retrieves paginated active deals with filtering by owner, person, organization, `, `Creates new sales deals with customizable properties: title (required), value, p`, `Retrieves paginated archived deals with same filtering as active deals. Essentia`, `Soft-deletes deals with 30-day recovery period before permanent removal. Essenti`. Consistent with artificial intelligence — this is inferred from where the key appears and what it carries, not from any published definition.
Where it appears
| Location in the document | Occurrences | |
|---|---|---|
| operation | 27 |
What its value looks like
| Value shape | Occurrences |
|---|---|
| string | 27 |
Observed values
Sampled from the specifications, most frequent first.
Providers publishing it
All 1.
Why this is not in OpenAPI
Extensions exist because a provider needed something the specification would not carry. Most of what they hold is not the API contract at all — it is operational metadata about the contract: documentation, lifecycle, policy, provenance, and now agents. That metadata is usually better placed alongside the contract, in an Overlay or an APIs.json index, than crammed inside it. See everything else doing the artificial intelligence job.