MCP Tools - Middleware MCP Server

The Middleware MCP Server exposes 19 tools, grouped by product area. Your assistant calls these tools to read and manage your Middleware data.

Each tool is marked Read or Write:

Read tools (list_*, get_*, and query) never change your data.
Write tools create, update, or delete resources.

To connect a client and start using these tools, see Setup.

Dashboards#

Manage the full dashboard lifecycle, including cloning and favorites.

Tool	Access	Description
`list_dashboards`	Read	List dashboards and reports, with filtering and pagination. Use it to discover what exists before reading or editing.
`get_dashboard`	Read	Get a single dashboard by its key, including its layout and widgets.
`create_dashboard`	Write	Create a new dashboard.
`update_dashboard`	Write	Update an existing dashboard's properties.
`delete_dashboard`	Write	Delete a dashboard.
`clone_dashboard`	Write	Duplicate an existing dashboard into a new one.
`set_dashboard_favorite`	Write	Mark a dashboard as a favorite, or remove it from favorites.

Widgets#

Build and adjust the widgets on a dashboard, and pull their data.

Tool	Access	Description
`list_widgets`	Read	List the widgets on a report or display scope.
`get_widget_data`	Read	Fetch the data for a single widget.
`get_multi_widget_data`	Read	Fetch data for several widgets in one call.
`create_widget`	Write	Add a new widget.
`update_widget`	Write	Update an existing widget's configuration.
`delete_widget`	Write	Remove a widget.
`update_widget_layouts`	Write	Update the position and size of widgets on a dashboard.

Metrics and resources#

Discover what telemetry is available, then query it.

Tool	Access	Description
`get_metrics`	Read	List the available metrics, along with their filters and group-by tags.
`get_resources`	Read	List the resource types available to query (for example hosts, services, or containers).
`query`	Read	Run a flexible query to retrieve logs, metrics, traces, and other telemetry over a time range.

Error tracking#

Triage errors and incidents.

Tool	Access	Description
`list_errors`	Read	List errors and incidents with filtering and pagination. Each entry includes a clickable `issue_url` you can open in Middleware.
`get_error_details`	Read	Get detailed information about a specific error or incident, looked up by its fingerprint.

Restricting the available tools#

You can expose a narrower set of tools on a connection by adding the exclude_tools query parameter to the endpoint URL. Listed tools are hidden from the client and cannot be called:

https://mcp.middleware.io/mcp?exclude_tools=create_dashboard,update_dashboard,delete_dashboard,clone_dashboard,set_dashboard_favorite,create_widget,update_widget,delete_widget,update_widget_layouts

The example above removes every write tool, leaving a read-only connection. See Setup for details.

Need assistance or want to learn more about Middleware? Contact our support team at [email protected] or join our Slack channel.