Lyssna

Describes the Lyssna Data API. With no arguments, the result is the complete supported-operation catalog for the currently loaded API document. With a path copied from that catalog, the result is a self-contained guide with the applicable tool and exact MCP argument placement: pathParams, selectors for get_data, and filter, sort, cursor, and page_size for search_data. A method is required only when the selected path offers multiple methods. Identical requests against an unchanged API document return the same information. Catalog hints cover simple calls; operation guides include nested filters, selector semantics, result shape, and an example. The catalog and guides are compiled from the exact loaded OpenAPI document generation; Rails remains the final validation, authorization, masking, tenant, and record-access boundary. Unknown paths or methods fail permanently with offered choices.

describe_data

Fetch Data API data with a GET request. Source path and pathParams exactly from describe_data: template segments (e.g. {test_unique_id}) go in pathParams; all filters go in selectors, never as top-level arguments. Returns one of: a list result { rows, meta, guidance } for paginated (list) operations, or a detail result { data } for single-resource operations. For lists, follow meta.next_cursor by passing it as cursor on the next call; the guidance field states whether another page exists. page_size defaults to 50, max 100, and applies to list operations only. Non-ok statuses: invalid_request (fix path/selectors/pagination), not_available (resource missing or unauthorized), unavailable_retryable (retry later), and too_large (narrow selectors or reduce page_size, then retry).

get_data

Search Data API list data with a POST search request. Source path and pathParams exactly from describe_data: template segments (e.g. {test_unique_id}) go in pathParams; structured predicates go in filter, never as top-level arguments, flat selectors, raw body, or raw page objects. Returns a list result only: { rows, meta, guidance }. Follow meta.next_cursor by passing it as cursor on the next call; omit cursor for the first page. page_size defaults to 50, max 100; requests above the max are rejected by the tool contract. Use sort only when describe_data documents a supported search sort; the Data API validates sort values and filter shape. Non-ok statuses: invalid_request (fix path/filter/sort/pagination), not_available (resource missing or unauthorized), unavailable_retryable (retry later), and too_large (narrow filter or reduce page_size, then retry).

search_data