Give Feedback

pydo.tools.list()

Generated on 1 Oct 2026 from pydo version v0.43.0

Copy page as Markdown View page as Markdown

Usage

client.tools.list(
    toolkit_id=None,
    page=1,
    per_page=100,
)

Returns JSONRaises HttpResponseError

Description

Returns one page of the tools your team can use: released catalog tools plus the enabled tools of your team’s MCP servers. definitions[i] describes tools[i]. Offset-paged with page and per_page; an unknown toolkitId returns an empty page.

Parameters

toolkit_id string optional

Restricts the page to one provider. It accepts the provider ID the catalog returns, including the serverRef of one of your team's MCP servers.

page integer optional

1-based page index; values below 1 are treated as 1. A page past the end returns an empty tools list with the real total.

Min: 1

Default: 1

per_page integer optional

Page size. Defaults to 100 when omitted or 0; values above 100 are capped at 100.

Min: 1

Max: 100

Default: 100

Pagination

This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page parameter:

from urllib.parse import urlparse, parse_qs

resp = client.tools.list()
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.tools.list(page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

Show Response Example

{
  "version": "v1",
  "tools": [
    {
      "name": "web_search",
      "toolkitId": "exa",
      "title": "Web Search",
      "description": "Search the public web with Exa and return relevant results with normalized text snippets.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search query string."
          },
          "max_results": {
            "type": "integer",
            "description": "Maximum number of search results to return."
          }
        },
        "required": [
          "query"
        ]
      },
      "annotations": {
        "title": "Web Search",
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true,
        "destructiveHint": false
      },
      "version": "v1",
      "parallelizable": true,
      "streamingSafe": true,
      "outputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "publishedDate": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "toolSlug": "exa_web_search"
    }
  ],
  "definitions": [
    {
      "toolId": "tul_exa_web_search",
      "name": "web_search",
      "toolkitId": "exa",
      "title": "Web Search",
      "description": "Search the public web with Exa and return relevant results with normalized text snippets.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search query string."
          },
          "max_results": {
            "type": "integer",
            "description": "Maximum number of search results to return."
          }
        },
        "required": [
          "query"
        ]
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string"
          },
          "provider": {
            "type": "string"
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "publishedDate": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "annotations": {
        "title": "Web Search",
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true,
        "destructiveHint": false
      },
      "version": "v1",
      "auth": {
        "modes": [
          "shared_key"
        ],
        "provider": "exa",
        "scopes": []
      },
      "toolSlug": "exa_web_search",
      "providerKind": "managed_api"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 100,
    "total": 1
  }
}

More Information

See /v2/action-gateway/tools in the API reference for additional detail on responses, headers, parameters, and more.