List available tools

1 import requests 2 3 url = "https://backend.composio.dev/api/v3/tools" 4 5 querystring = {"toolkit_slug":"foo","tool_slugs":"foo","important":"true","tags":"[\"foo\"]","scopes":"[\"foo\"]","search":"foo","limit":"42","cursor":"foo"} 6 7 headers = {"x-api-key": "<x-api-key>"} 8 9 response = requests.get(url, headers=headers, params=querystring) 10 11 print(response.json())

1 { 2 "items": [ 3 { 4 "slug": "github-actions", 5 "name": "GitHub Actions", 6 "description": "Automate GitHub workflows including CI/CD, issue management, and release processes", 7 "toolkit": { 8 "slug": "github", 9 "name": "GitHub", 10 "logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png" 11 }, 12 "input_parameters": {}, 13 "no_auth": false, 14 "available_versions": [ 15 "foo" 16 ], 17 "version": "latest", 18 "output_parameters": {}, 19 "scopes": [ 20 "foo" 21 ], 22 "tags": [ 23 "foo" 24 ], 25 "deprecated": { 26 "displayName": "GitHub Actions", 27 "version": "0_1", 28 "available_versions": [ 29 "foo" 30 ], 31 "is_deprecated": false, 32 "toolkit": { 33 "logo": "https://github.githubassets.com/assets/GitHub-Mark-ea2971cee799.png" 34 } 35 } 36 } 37 ], 38 "total_pages": 42, 39 "current_page": 42, 40 "total_items": 42, 41 "next_cursor": "foo" 42 }

Retrieve a paginated list of available tools with comprehensive filtering, sorting and search capabilities. Use query parameters to narrow down results by toolkit, tags, or search terms.

Query parameters

toolkit_slugstringOptional

The slug of the toolkit to filter by

tool_slugsstringOptional

Comma-separated list of specific tool slugs to retrieve (overrides other filters)

importantenumOptional

Filter to only show important/featured tools (set to “true” to enable)

Allowed values:

tagslist of stringsOptional

Filter tools by one or more tags (can be specified multiple times)

scopeslist of stringsOptional

Array of scopes to filter tools by)

searchstringOptional

Free-text search query to find tools by name, description, or functionality

limitintegerOptional

Number of items per page

cursorstringOptional

Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

Response

Successfully retrieved tools list with pagination information

itemslist of objects

total_pagesinteger

current_pageinteger

total_itemsinteger

next_cursorstring or null

Headers

Query parameters

Response