openwebui-tools MCP server

A single MCP server that bundles four tools originally written for Open WebUI, so they can be used from any MCP-capable client (Claude Desktop, IDEs, custom agents, Open WebUI's MCP support, etc.).

Bundled tools:

Tool group	MCP tools exposed
Agentic Web Search	search_web, fetch_page
Stock Data	get_stock_quote, get_company_profile, get_financials, get_earnings, get_company_news, get_analyst_recommendations, search_symbol
Wolfram Alpha	query_wolfram_alpha
YouTube Transcript	get_youtube_transcript

Built on FastMCP. The default transport is streamable-http so the server is reachable over the network at http://<host>:8000/mcp.

Configuration

Every Open WebUI "valve" became an environment variable. Copy the example file and edit it:

cp .env.example .env

See .env.example for the full list with defaults. Key things to set:

• WOLFRAM_APP_ID — required for the Wolfram tool (free AppID).
• STOCK_FINNHUB_API_KEY — recommended for Stock Data (the search_symbol tool requires it; everything else falls back to keyless yfinance).
• WEB_SEARCH_SEARXNG_URL — points at the bundled SearXNG service by default.

Variables are grouped by prefix: MCP_ (server), WEB_SEARCH_, STOCK_, WOLFRAM_, YOUTUBE_.

Authentication

Set MCP_AUTH_TOKEN to require a bearer token on every HTTP request. Clients must then send an Authorization: Bearer <token> header; anything else gets a 401. Leaving it blank disables auth and leaves the server open to anyone who can reach it (the server logs a warning at startup in that case). The token is ignored for the stdio transport, which has no network surface.

Generate a strong token, e.g.:

openssl rand -hex 32

and put it in your .env:

MCP_AUTH_TOKEN=<your-generated-token>

Open WebUI per-user valves and UI-only behaviors that don't apply to MCP were dropped: status/progress events, citation events, the Wolfram HTML result "card" (it now returns plain text), and the stock tool's verbose_status / include_raw_numbers per-user toggles.

Run with Docker Compose (recommended)

The compose file builds the server and also starts the supporting services the web search tool expects — SearXNG (search), FlareSolverr (Cloudflare fallback), and Apache Tika (PDF extraction):

cp .env.example .env        # then edit it
docker compose up --build

The MCP endpoint is then available at http://localhost:8000/mcp.

If you don't need web search, delete the searxng/flaresolverr/tika services (and the depends_on block) from docker-compose.yml. The other three tools have no local-service dependencies.

SearXNG note: JSON output must be enabled for search_web to work — the bundled searxng/settings.yml does this. Set a real SEARXNG_SECRET in your .env.

Run with Docker (server only)

docker build -t openwebui-tools-mcp .
docker run --rm -p 8000:8000 --env-file .env openwebui-tools-mcp

Run locally (no Docker)

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env        # then edit it
python server.py

Set MCP_TRANSPORT=stdio to run as a stdio MCP server instead (useful for clients that spawn the process directly rather than connecting over HTTP).

Connecting a client

For an HTTP client, point it at http://<host>:8000/mcp (streamable-http). For example, a Claude Desktop / generic client config using a stdio bridge or native streamable-http support would reference that URL. If MCP_AUTH_TOKEN is set, configure the client to send an Authorization: Bearer <token> header (most MCP clients expose a "headers" or "auth token" field for HTTP servers). For stdio mode, configure the client to launch python server.py with the environment variables set.