Skip to content

MCP tools

All tools are served through the single endpoint described in MCP. Your agent sees every tool your role allows; tools marked admin return a clear “requires the ADMIN role” message to other callers.

Query your monitoring data: the same surface as the Logs and Metrics pages, tool-shaped.

ToolWhat it does
logssearch logs with filters (service, level, trace id, time range, text) and cursor pagination
get_logfetch one complete log record by its log_id
get_log_neighborsthe logs immediately before/after a given log, for context around a suspicious line
spanssearch spans (service, operation name, status, kind, minimum duration, trace id, time range)
get_traceevery span of one trace, plus a summary
aggregate_spansrequest count, error rate, and latency percentiles, grouped by service or operation
list_metricsdiscover which metrics exist per service
metricsquery one metric’s time series (with step, grouping, filters)
correlateone-shot pivot for a trace id: its spans, its logs, and related metric exemplars
describe_schemawhat’s queryable: fixed fields and your own dynamic attribute keys, per table
run_sqlrun a read-only QuerySQL statement

Author and manage alert rules: the tool shape of the Alerts pages.

ToolWhat it does
describe_alertinghow Fixter alert rules work: the shapes and options, self-describing for agents
get_alert_ruleslist your alert rules
save_alert_rulecreate or update a rule (thresholds or anomaly conditions over a QuerySQL-filtered signal)
preview_alert_ruledry-run a rule against recent data before saving it
set_alert_rule_statusenable or disable a rule
delete_alert_ruleremove a rule
suppress_signal / unsuppress_signal / list_suppressionstemporarily silence matching alerts
create_ignore_rule / delete_ignore_rule / list_ignore_rulespermanently ignore known-noise signals

Synthetic probes against your HTTP endpoints and MCP servers: the tool shape of the API Tests page.

ToolWhat it does
create_api_test / update_api_test / delete_api_testdefine probes, with assertions on status, latency, headers, body, or MCP handshake/tools
list_api_tests / get_api_testinspect configured tests
enable_api_test / disable_api_testpause and resume a test
get_api_test_runsrun history with outcomes, filterable by time and status
get_uptimeuptime percentage over a window
create_api_test_credential / list_api_test_credentials / delete_api_test_credentialmanage the credentials probes authenticate with (basic, bearer, API key, OAuth2); values are write-only and never echoed back

Work investigations and configure how they run. Setup changes require the admin role; reads are open to any role.

ToolWhat it does
list_investigationsrecent investigations, newest first
get_investigation_briefthe full transcript of one investigation, read-only
start_investigationclaim an investigation (by id or its pick-up slug) and continue it in your editor with its complete context
ToolWhat it does
list_investigation_alert_channelsSlack channels Fixter watches for alerts
add_investigation_alert_channel / remove_investigation_alert_channel (admin)add or remove a watched channel by id. Every bot-posted alert in a watched channel is investigated automatically; there is no per-alert rule to configure
list_investigation_agent_context_credentialswhich monitoring-provider credentials are configured (names only; values are never readable)
set_investigation_datadog_credentials (admin)store Datadog keys so investigations can run against your existing monitoring during migration
set_investigation_cloudwatch_credentials (admin)store AWS CloudWatch credentials, same purpose
get_issue_digest_config / set_issue_digest_config (admin, set only)the issue digest’s mode, schedule, timezone, and delivery channel
  • Results are capped for agent-friendliness (long strings and large result sets are truncated); every search tool takes limits and filters for precise paging.
  • Destructive setup tools (channel removal, rule deletion) act immediately.
  • This page is hand-maintained against the current tool surface; your agent’s live tool list is always authoritative, so ask it to list its Fixter tools.