DigitalOcean API (unofficial showcase)
GET/v2/action-gateway/tools

List Tools

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.

3 parameters
toolkit_idstringoptional
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.
pageintegeroptional
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.
Default:1
per_pageintegeroptional
Page size. Defaults to 100 when omitted or 0; values above 100 are capped at 100.
Default:100

5 status codes
200The request was successful.
versionstringoptional
Catalog version identifier, for example `v1`.
toolsarray<object>optional
Tools on this page, grouped by provider and sorted by name within a provider.
definitionsarray<object>optional
definitions[i] describes tools[i].
paginationobjectoptional
page and `per_page` echo the values applied; total is the number of tools matching `toolkitId` across all pages.
401Authentication failed due to invalid credentials.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
429The API rate limit has been exceeded.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
500There was a server error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
defaultThere was an unexpected error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.

Error handling

A 401 is returned: Authentication failed due to invalid credentials. A 429 is returned: The API rate limit has been exceeded. A 500 is returned: There was a server error. Any other status is an error: There was an unexpected error.