Skip to content

Search Tools GET


Overview

Searches for tools by name or description.

Endpoint URL

GET /api/tools/search

Endpoint Data

This endpoint has no URL parameters.
Parameter Description Type Required
q Search query String Yes
This endpoint has no request body.

Example Request

curl -X GET "http://localhost:3026/api/tools/search?q=search" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -b cookies.txt

Example Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "tools": [
      {
        "id": "exa-web-search",
        "name": "Web Search",
        "description": "Search the web using Exa AI-powered search",
        "category": "search",
        "inputSchema": {
          "type": "object",
          "properties": {
            "query": {"type": "string"}
          },
          "required": ["query"]
        }
      }
    ],
    "total": 1
  }
}

Response Fields

Field Type Description
tools Array List of matching tool objects
total Integer Total number of matches

Error Responses

Status Code Error Description
400 Bad Request Missing search query
401 Unauthorized Invalid or missing session