> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcp-use.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Search Tools
> Search Tools API Documentation
export const RandomGradientBackground = ({className, color, children, grayscaled = false}) => {
const saturation = useMemo(() => {
if (color) {
const values = color.split("(")[1].split(")")[0].trim().split(/\s+/);
return parseFloat(values[1] || "0");
}
return grayscaled ? 0 : 0.2;
}, [color, grayscaled]);
const lightness = useMemo(() => {
if (color) {
const values = color.split("(")[1].split(")")[0].trim().split(/\s+/);
return parseFloat(values[0] || "0.5");
}
return grayscaled ? 0.3 : 0.4;
}, [color, grayscaled]);
const randomHue = useMemo(() => {
if (color) {
const values = color.split("(")[1].split(")")[0].trim().split(/\s+/);
return parseFloat(values[2] || "0");
}
return Math.floor(Math.random() * 360);
}, [color]);
const randomColor = useMemo(() => {
if (color) {
return color;
}
return `oklch(${Math.min(lightness, 1)} ${saturation} ${randomHue})`;
}, [randomHue, saturation, lightness]);
const lightColor = useMemo(() => {
return `oklch(${Math.min(lightness * 2, 1)} ${saturation} ${randomHue})`;
}, [randomHue, saturation, lightness, color]);
const direction = useMemo(() => {
return Math.floor(Math.random() * 360);
}, [randomHue]);
const brightnessFilter = useMemo(() => {
return "1000%";
}, []);
return ;
};
View the source code for this module on GitHub: [https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp\_use/agents/managers/tools/search\_tools.py](https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/agents/managers/tools/search_tools.py)
## SearchToolsTool
class SearchToolsTool
Tool for searching for tools across all MCP servers using semantic search.
```python theme={null}
from mcp_use.agents.managers.tools.search_tools import SearchToolsTool
```
**Attributes**
>
Name identifier
Parameter value
Parameter value
### `method` **init**
Initialize with server manager and create a search tool.
**Parameters**
> Server name or configuration
**Signature**
```python wrap theme={null}
def __init__(server_manager):
```
## ToolSearchEngine
class ToolSearchEngine
Provides semantic search capabilities for MCP tools.
Uses vector similarity for semantic search with optional result caching.
```python theme={null}
from mcp_use.agents.managers.tools.search_tools import ToolSearchEngine
```
### `method` **init**
Initialize the tool search engine.
**Parameters**
> The ServerManager instance to get tools from
> Whether to cache query results
**Signature**
```python wrap theme={null}
def __init__(server_manager = None, use_caching: bool = True):
```
### `method` index\_tools
Index all tools from all servers for search.
**Parameters**
> dictionary mapping server names to their tools
**Signature**
```python wrap theme={null}
def index_tools(server_tools: dict[str, list[langchain_core.tools.base.BaseTool]]):
```
### `method` search
Search for tools that match the query using semantic search.
**Parameters**
> The search query
> Number of top results to return
**Returns**
> list of tuples containing (tool, server\_name, score)
**Signature**
```python wrap theme={null}
def search(query: str, top_k: int = 5):
```
### `method` search\_tools
Search for tools across all MCP servers using semantic search.
**Parameters**
> The search query to find relevant tools
> Number of top results to return
> Name of the currently active server (for highlighting)
**Returns**
> String with formatted search results
**Signature**
```python wrap theme={null}
def search_tools(query: str, top_k: int = 100, active_server: str = None):
```
### `method` start\_indexing
Index the tools from the server manager.
**Signature**
```python wrap theme={null}
def start_indexing():
```
## ToolSearchInput
class ToolSearchInput
Input for searching for tools across MCP servers
```python theme={null}
from mcp_use.agents.managers.tools.search_tools import ToolSearchInput
```
**Attributes**
>
Query string or input
Integer value
### `method` **init**
Create a new model by parsing and validating input data from keyword arguments.
Raises \[`ValidationError`]\[pydantic\_core.ValidationError] if the input data cannot be
validated to form a valid model.
`self` is explicitly positional-only to allow `self` as a field name.
**Parameters**
> Parameter value
**Signature**
```python wrap theme={null}
def __init__(data: Any):
```