Tools

The Glass Data MCP server offers the agent the tools listed on this page, and the agent picks the tool that fits the question. Each tool requires an access level of the connection on the account and a minimum access profile of the user.

Every tool except list_accounts takes the account by its slug in the account argument. The agent receives the full list of tools whatever its access, and a call without the required access or profile is refused, with what would unlock the tool. The describe_account tool reports the tools withheld on the account.

Behavior shared across tools, such as version comparison and simulation, is in Operations.

Accounts

Tool What it does Access Profile
list_accounts lists the user’s accounts, with the slug, the environment (production or test), whether the connection is enabled on each account and what the agent can do there not required not required
describe_account describes an account: name, environment, status, time zone, the connection’s access, the user’s profile and the withheld tools, with what would unlock each one Read Read only

Event types and fields

Tool What it does Access Profile
list_event_types lists the event types, with the status, the number of fields, metrics and monitors and the time of the last accepted event, including the _failure type Read Read only
describe_event_type describes the fields of an event type: identifier, name, data type, settings, accepted values and usages Read Read only
list_field_values lists the values a field accepts and the values received since a date, with the name each value stands for Read Read only
list_field_elements lists the items of a list or boolean field, with the label, color and icon of each item Read Read only
create_event_field creates a field in an event type, with an identifier, data type and property type that cannot be changed afterwards Read and change Editor
update_event_field changes a field’s name, description, required setting, inheritance and maximum size Read and change Editor
add_field_elements adds items to a list field, in a batch Read and change Editor
update_field_elements changes the value, label, color or icon of items of a list or boolean field, in a batch, except the values of a boolean field Read and change Editor
remove_field_elements removes items from a list field, in a batch, without changing the value of events already stored Read and change Editor
deactivate_event_field deactivates a field and keeps the stored values, which return if the field is reactivated in the panel Read and change Editor
remove_event_field removes a field, and the stored values can no longer be queried Read and change Editor

Events and export

Tool What it does Access Profile
count_events counts the events of a period in time buckets, with filters and an optional split by one field Read Read only
find_events lists the events that match the filters, newest first, with the chosen fields Read Read only
create_export starts an export of the events that match the filters, with every active field of the event type Read Analyst
describe_export reports the status of an export and returns the download link, which requires the Analyst profile Read Read only
list_exports lists the account’s recent exports, including those started in the panel, and the use of the daily limit Read Read only

Metrics and monitors

Tool What it does Access Profile
list_metrics lists the metrics, with the event type, the grouping, the number of filters and the aggregations of each metric Read Read only
describe_metric describes a metric: filters, aggregations and granularities, with the period each granularity reaches Read Read only
query_metric reads the values of a metric over a recent period or a past window, with the expected band and the alerts Read Read only
list_monitors lists the monitors, with the metric, the interval, the detection, the status and the number of segments analyzed in the last 30 days Read Read only
describe_monitor describes a monitor: filters, criteria, anomaly detection settings, last run and where alerts are sent Read Read only

Rules

Tool What it does Access Profile
list_rules lists the rules, with the event type, the active version and the number of conditions of each rule Read Read only
describe_rule describes a rule version, the active one by default: conditions in evaluation order, subconditions, expressions, actions and the mode of each level Read Read only
create_rule creates a rule on an event type, with an empty draft Read and change Editor
draft_rule creates a draft from a version, the active one by default Read and change Editor
add_rule_condition adds a condition or an Else to a draft: at the end, before or after another condition, or as a subcondition Read and change Editor
add_rule_action adds a standalone action to a draft Read and change Editor
update_rule_condition changes the expression, name, actions, mode, position or parent condition of a draft row Read and change Editor
remove_rule_condition removes a draft row, with its subconditions Read and change Editor
update_rule changes the evaluation mode of the top level of an event rule draft Read and change Editor
validate_rule validates the whole draft and returns the editor’s warnings Read and change Editor
compare_rule_versions compares two versions condition by condition, with the active version as the base by default Read Read only
simulate_rule simulates a version with given values, including a draft, and can test an analysis draft along with it Read Read only

Lists

Tool What it does Access Profile
list_lists lists the lists, with the value type, the number of items and the active rules that query each list Read Read only
describe_list describes a list and, row by row and in rule syntax, the rules that query the list (in or not in) or add items to it Read Read only
lookup_list_items checks whether up to 100 values are on the list, with the author, the date added, the expiry and the description of each item, without using the query limit Read Read only
list_list_items lists the items of a list in pages, with an optional search by part of the value, and uses the query limit Read Read only
add_list_items adds up to 1,000 values to a list, with an optional description and expiry, and replaces a value already on the list, reporting the item it replaced Read and change Analyst
remove_list_items removes up to 1,000 values from a list, reports the values that were not on the list, and warns when a rule adds items to it again. Removing every item is done in the panel Read and change Analyst

Additions and removals apply from the next event on, including in active rules.

Analyses

Tool What it does Access Profile
list_analyses lists the analyses, with the event type, the active version, the number of cells and the rules that run and record each analysis Read Read only
describe_analysis describes an analysis version: the cells in order and, on active versions or versions in observation (shadow), the effect of each cell over the last 30 days Read Read only
create_analysis creates an analysis on an event type, with a name that cannot be changed afterwards, and opens its first draft Read and change Editor
draft_analysis opens a draft from a version, the active one by default Read and change Editor
add_analysis_cell adds a cell to the draft, at the end, before or after another cell Read and change Editor
update_analysis_cell changes or moves a cell of the draft, and requires confirmation for a change that restarts the cell’s window Read and change Editor
remove_analysis_cell removes a cell from the draft Read and change Editor
compare_analysis_versions compares two versions cell by cell, with the changes that restart a cell’s window Read Read only
simulate_analysis simulates a version with given values and shows each cell’s measure against its trigger Read Read only

The agent publishes neither rules nor analyses: publishing is done in the panel, through comparison and publishing.