A feature refers to an optional capability or enhancement that can be enabled or disabled in the OpenAPI visibility and context management system. Each feature provides a specific function, such as adding filter examples, injecting per-tool context, or populating parameter examples. These features do not change the core business logic or security posture; they only enrich the API specification for better usability and discoverability.

The following table lists available features, configuration keys, and their effects:
Feature Configuration key Effect Note
Filter examples openapi_visibility.add_filter_examples Adds a consolidated Filter Examples: line or Filter: for single field, and sets example on existing filter query parameter. Activates only if a filter query parameter exists. It supports up to three predicates derived from the first eight output fields. It does not include per-example usage lines.
Parameter examples openapi_visibility.add_param_examples Sets example values on existing query or path parameters that do not already have examples. Sensitive names such as token, secret, and password are skipped. This feature does not create new parameters.
Per-tool context openapi_visibility.per_tool_context_enabled Appends a Context: block or line for operations that have a matching .md or .txt file. This feature is disabled by default and must be explicitly enabled.
Max context files openapi_visibility.per_tool_context_max_files Limits the number of operations that receive context after applying priority sorting. If this property is omitted or set to a value less than or equal to zero, the number of files is unlimited.
Context character limit openapi_visibility.per_tool_context_char_limit Sets the global maximum number of characters allowed per per-tool context snippet. The internal hard ceiling is 2000 characters. If the property is unset, the default is 10000 characters, but it is capped at 2000. Set this property explicitly to 2000 or lower for clarity.
Global context limit openapi_visibility.global_context_char_limit Sets the maximum number of characters appended from global.md to the info.description and each operation. The default value is 10000 characters. It is recommended to lower this value to between 3000 and 6000 characters for clarity.
Context directory openapi_visibility.context_dir This feature specifies the directory that is scanned for context assets. The default search order is:
  1. An explicitly specified directory
  2. ./context
  3. repo/context/
Catalog and schema introspection Tools such as list_all_tags, get_tool_schema, and get_filter_fields These tools surface tags and resolved schemas for runtime introspection. Assign read scopes if the information is sensitive.