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
- How search mode works: Help agents find the right tool before they call it.
See also
- Audit trail: Call record fields, audit query API, access rules, and limits.
- Compare agent usage: Agent spend and errors alongside MCP usage.