[PR #1275] [MERGED] docs: clarify MCP tools in chat API #1258

New issue

Closed

opened 2026-10-18 14:18:22 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:18:22 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1275
Author: @xuyua9
Created: 5/31/2026
Status: ✅ Merged
Merged: 5/31/2026
Merged by: @Classic298

Base: dev ← Head: docs/mcp-tools-api-xuyua9

📝 Commits (1)

0310a00 docs: clarify MCP tools in chat API

📊 Changes

1 file changed (+25 additions, -0 deletions)

View changed files

📝 docs/reference/api-endpoints.md (+25 -0)

📄 Description

Summary

document that /api/chat/completions can resolve Open WebUI tool_ids
call out MCP tool server IDs (server:mcp:<server-id>) and access checks
clarify that caller-provided OpenAI-style tools arrays bypass server-side tool_ids resolution

Closes https://github.com/open-webui/docs/issues/645

Validation

git diff --check
static check for the new tool_ids / MCP documentation block
verified against open-webui backend origin/main paths: main.py stores tool_ids / tool_servers metadata and utils/middleware.py resolves server:mcp: tool IDs

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/1275 **Author:** [@xuyua9](https://github.com/xuyua9) **Created:** 5/31/2026 **Status:** ✅ Merged **Merged:** 5/31/2026 **Merged by:** [@Classic298](https://github.com/Classic298) **Base:** `dev` ← **Head:** `docs/mcp-tools-api-xuyua9` --- ### 📝 Commits (1) - [`0310a00`](https://github.com/open-webui/docs/commit/0310a00b9a63c7b0a46512c60da4ee53337b4479) docs: clarify MCP tools in chat API ### 📊 Changes **1 file changed** (+25 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/reference/api-endpoints.md` (+25 -0) </details> ### 📄 Description ## Summary - document that `/api/chat/completions` can resolve Open WebUI `tool_ids` - call out MCP tool server IDs (`server:mcp:<server-id>`) and access checks - clarify that caller-provided OpenAI-style `tools` arrays bypass server-side `tool_ids` resolution Closes https://github.com/open-webui/docs/issues/645 ## Validation - `git diff --check` - static check for the new `tool_ids` / MCP documentation block - verified against open-webui backend `origin/main` paths: `main.py` stores `tool_ids` / `tool_servers` metadata and `utils/middleware.py` resolves `server:mcp:` tool IDs --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:18:22 +00:00