Skip to main content

Install

Integrate

Call track after defining your server and tools, before running:
Get your org ID from app.agnost.ai.

Identify users

Pass an identify function to resolve a user from the incoming request context. It receives the raw request object and the process environment, and should return a dict with at least a userId key:
The function can also be async. Return None to skip user attribution for a request.

Options

UserIdentity is a Dict[str, Any] that must contain a userId key. Other fields (e.g. email, role) are optional and forwarded as user traits. The identify callable can be sync or async, and may return None to skip attribution for a request.

What appears in Agnost AI

  • Tool calls for FastMCP tool invocations.
  • Events for every tracked call.
  • Failed tool calls remain visible in Events with their error details.

Verify

Call one FastMCP tool from your MCP client, then open app.agnost.ai. Check Events first, then Tool calls.

Troubleshooting

  • Call track(...) after defining tools and before server.run().
  • Confirm the org ID is correct.

Next steps

  • Tool calls: analyze calls from your FastMCP server.
  • Events: verify call fields and execution details.
  • Alerts: monitor important MCP tool conditions.