AX MCP Conventions

A few rules apply across every tool in the catalog, not just one.

Pagination

Every list tool takes the same two arguments:

Argument	Type	Default	Description
`limit`	int	50	Items to return, between 1 and 100
`cursor`	string	none	Pagination cursor from a previous response

Each response carries a pagination object:

{
  "pagination": {
    "hasMore": true,
    "nextCursor": "<opaque-cursor-string>"
  }
}

When hasMore is true, pass nextCursor back in as the next call’s cursor. Agents pick this up on their own once they see a first response, though it’s worth telling yours to stop after a page or two when you only need a sample rather than the full set.

Span limits

list_spans caps out at 100 items per page regardless of the limit you pass, since span payloads are large enough to fill a context window on their own. Point your agent at a specific trace when you’re debugging rather than paging through a busy project’s full span list.

Timeouts

Requests time out after 30 seconds.

Errors

Failures come back in RFC 9457 problem format — a JSON body with type, title, status, and detail fields — which most agents read and explain rather than retry blindly.

Skills

MCP server

API reference

API clients

Span limits

Timeouts

Errors

Next steps

Tool catalog

Connect your client

​Pagination

​Span limits

​Timeouts

​Errors

​Next steps

Tool catalog

Connect your client

Pagination

Span limits

Timeouts

Errors

Next steps