---
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`

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-09-18** `082b5fabd909` — 1 info
  - endpoint added

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

---

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