---
title: "Update Mcp Tool Search Settings"
method: PATCH
path: "/update/mcp_tool_search_settings"
tags: ["Settings"]
---

# Update Mcp Tool Search Settings

`PATCH /update/mcp_tool_search_settings`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/update/mcp_tool_search_settings`
- Auth: API key in header `x-litellm-api-key`

Update `litellm_settings.mcp_tool_search` in the database.
Settings will be picked up by all pods within approximately 10 seconds via background polling.

## Request body

- MCPToolSearchSettings: `litellm_settings.mcp_tool_search`: how the native `mcp_tool_search` virtual tool ranks the caller's tools.
  - `embedding_model` string, nullable: Embedding model from model_list used to rank tools by meaning. Unset keeps keyword matching.
  - `top_k` integer: Most ranked tools a search returns. A smaller top_k in the tool call wins. Core tools do not count.
  - `similarity_threshold` number: Lowest cosine similarity a tool needs to appear in semantic results (0.0 = no cutoff).
  - `core_tools` string[]: Tool names always returned first when the caller can access them, e.g. `my_server-get_rates`.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/update/mcp_tool_search_settings/patch.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)