Skip to main content
Every tool call through MCP Gateway is recorded in one place, whichever server answered it. Use the record to see what an agent did and why, find failing or slow tools, and report on usage.

Before you begin

Before you start, make sure you have:
  • Gateway access: Access to the workspaces whose MCP servers you want to audit.
  • Connected agents: Agents that call tools through the gateway inside a session; see Connect client to MCP Gateway.

Usage in MCP Gateway studio

The gateway records each session an agent opens and each tool call made inside it. Open the MCP Gateway studio and choose a workspace, or All workspaces.
1

Check gateway health and volume on Overview

Overview shows Servers in service, Tools available, Tool calls · 7 days with the failure rate, Sessions · 7 days, and Questions to users · 7 days. Below them are a Tool calls, last 14 days chart, the Most-called tools, and Recent sessions. Needs attention lists servers that are disconnected, waiting for sign-in, or whose hourly tool updates are paused.
2

Review every call on Tool calls

Tool calls lists each call, newest first, with When, Tool, Why, Outcome, Time, Session, and By. Filter by outcome (All, Failed, Succeeded), or by server to see everything agents did on one MCP server. The page shows the call count, failures, and the Median and p95 duration. Where recorded, a call’s time also shows how much of it Atlan added. Select a call to see what the gateway recorded about it. A call that was traced shows the id of the trace it belongs to; choose Open trace beside it to read the trace in the dashboard’s trace view. To see what agents did with one tool, pick it on the server’s Tools tab: its Recent calls tab lists the calls it made in the last 30 days, newest first, with When, On behalf of, From, Result, and Time. Where the tab lists only your own calls, it leaves out On behalf of. When more calls exist than fit, See all N calls opens the tool’s page, which lists every call.
3

Filter one tool's calls on Tools

Pick a tool on Tools and open its Recent calls tab: up to 10 of the tool’s calls in the last 30 days, newest first. Three filters narrow the list. On behalf of — only when you can see other people’s calls — offers the people who called the tool in the last 30 days, Anyone by default. Date switches between Last 30 days (the default), Last 7 days, and Today. Result switches between Any (the default), Succeeded, and Failed. A filter combination with no calls says No calls match these filters. See all N calls opens the tool’s own page, which lists every call; with a filter applied, the link reads See all calls.
4

Replay one agent's work on Sessions

Sessions lists each session’s When, What the agent set out to do, the person it ran for (For), its Client, and how many calls it made, grouped under each day’s heading — Today, Yesterday, then the weekday and date. Open a session to read its calls in the order the agent made them. Questions the gateway passed to a person are under Questions to the user.

Troubleshooting

If calls are missing from the trail or fail with Not in the catalogue, see Connect client to MCP Gateway.

Next steps

See also