MCP servers enabled but not seeing it in UI

[AngusHsu-cubewise]

I've set up mcpServers in librechat.yml, and the log shows it has initialized, but the server doesn't show up in the UI. Is there any additional configuration I need to modify to make the mcpServer appear in the UI?

librechat.yml

mcpServers:
  server:
    command: npx
    args:
      - "@modelcontextprotocol/server-memory"

logs:

4f753562f8cb 2025-04-25 07:17:38 info: [MCP] Initialized 1/1 app-level server(s)
4f753562f8cb 2025-04-25 07:17:38 info: [MCP][memory] ✓ Initialized
4f753562f8cb 2025-04-25 07:17:38 info: [MCP] All app-level servers initialized successfully

[danny-avila]

Make sure you update, then you will see it in the chatarea.

Otherwise, you can use it with Agents:
https://www.librechat.ai/docs/features/agents#model-context-protocol-mcp

---

Updating Instructions (docker):

# Linux command to Remove all existing images
docker images -a | grep "librechat" | awk '{print $3}' | xargs docker rmi

# Windows Powershell
docker images -a | findstr "librechat" | ForEach-Object { docker rmi $_.Split()[2] }

Then follow the directions here: https://www.librechat.ai/docs/local/docker#update-librechat

[yohannj]

Thanks @todiadiyatmo , I was able to investigate further thanks to you.
You need to include agents inside ENDPOINTS for mcp servers to show up.

So in your case, ENDPOINTS=groq,OpenRouter,agents should do the trick.
I suppose it would help to add this value inside .env.example, so that it's easier to find. Potentially with it's own comment because "agents" doesn't feel obvious either.

[keskinberkem]

@yohannj Thanks for your solution. I want to remove agent builder from ui, however when I set agents to false in interface field, also mcp servers are disappearing. Is there a way to keep only mcp and remove agent builder ? Thanks.

[danny-avila]

https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/agents#disablebuilder

[kshitijg30]

Hi, i tried adding agents inside the ENDPOINTS, still i cant see the MCP Server in ui.

ENDPOINTS=openAI,agents,assistants,gptPlugins,azureOpenAI,google,anthropic

[MaLub]

@light23-i
make sure that your MCP-Servers are connected without any errors.

docker logs LibreChat

In my case there were an error and so no mcp-server will be shown (what is correct)

2025-05-25 10:15:03 error: [MCP][filesystem] Connection failed: MCP error -32000: Connection closed
2025-05-25 10:15:03 error: [MCP][filesystem] Failed to connect after 3 attempts MCP error -32000: Connection closed
2025-05-25 10:15:03 error: [MCP][filesystem] Initialization failed MCP error -32000: Connection closed
2025-05-25 10:15:03 info: [MCP] Initialized 0/1 app-level server(s)
2025-05-25 10:15:03 warn: [MCP] 1/1 app-level server(s) failed to initialize
2025-05-25 10:15:03 info: [MCP][filesystem] ✗ Failed

[estone81]

In your librechat.yaml file you need to also turn on the agents endpoints.

Definition of custom endpoints

endpoints:
#assistants:

disableBuilder: false # Disable Assistants Builder Interface by setting to true

pollIntervalMs: 3000 # Polling interval for checking assistant updates

timeoutMs: 180000 # Timeout for assistant operations

# Should only be one or the other, either supportedIds or excludedIds

supportedIds: ["asst_supportedAssistantId1", "asst_supportedAssistantId2"]

# excludedIds: ["asst_excludedAssistantId"]

Only show assistants that the user created or that were created externally (e.g. in Assistants playground).

# privateAssistants: false # Does not work with supportedIds or excludedIds

# (optional) Models that support retrieval, will default to latest known OpenAI models that support the feature

retrievalModels: ["gpt-4-turbo-preview"]

# (optional) Assistant Capabilities available to all users. Omit the ones you wish to exclude. Defaults to list below.

capabilities: ["code_interpreter", "retrieval", "actions", "tools", "image_vision"]

agents:

# (optional) Default recursion depth for agents, defaults to 25

recursionLimit: 50

# (optional) Max recursion depth for agents, defaults to 25

maxRecursionLimit: 100

# (optional) Disable the builder interface for agents

disableBuilder: false

# (optional) Agent Capabilities available to all users. Omit the ones you wish to exclude. Defaults to list below.

capabilities: ["execute_code", "file_search", "actions", "tools"]

[torcato]

I am having the same problem.
I have set in the .env file:

ENDPOINTS=openAI,agents,assistants,gptPlugins,azureOpenAI,google,anthropic

my librechat.yaml

# For more information, see the Configuration Guide:
# https://www.librechat.ai/docs/configuration/librechat_yaml

# Configuration version (required)
version: 1.2.1

# Cache settings: Set to true to enable caching
cache: true

# File strategy s3/firebase
# fileStrategy: "s3"


# Example MCP Servers Object Structure
mcpServers:
  raw-oxial:
    type: sse
    url: http://172.17.0.1:8000/sse
    timeout: 30000  


# Definition of custom endpoints
endpoints:
  assistants:
    disableBuilder: false # Disable Assistants Builder Interface by setting to `true`
    pollIntervalMs: 3000  # Polling interval for checking assistant updates
    timeoutMs: 180000  # Timeout for assistant operations
    # Should only be one or the other, either `supportedIds` or `excludedIds`
    supportedIds: ["asst_supportedAssistantId1", "asst_supportedAssistantId2"]
    # excludedIds: ["asst_excludedAssistantId"]
    # Only show assistants that the user created or that were created externally (e.g. in Assistants playground).
    # privateAssistants: false # Does not work with `supportedIds` or `excludedIds`
    # (optional) Models that support retrieval, will default to latest known OpenAI models that support the feature
    retrievalModels: ["gpt-4-turbo-preview"]
    # (optional) Assistant Capabilities available to all users. Omit the ones you wish to exclude. Defaults to list below.
    capabilities: ["code_interpreter", "retrieval", "actions", "tools", "image_vision"]
  agents:
    # (optional) Default recursion depth for agents, defaults to 25
    recursionLimit: 50
    # (optional) Max recursion depth for agents, defaults to 25
    maxRecursionLimit: 100
    # (optional) Disable the builder interface for agents
    disableBuilder: false
    # (optional) Agent Capabilities available to all users. Omit the ones you wish to exclude. Defaults to list below.
    capabilities: ["execute_code", "file_search", "actions", "tools"]
  custom:
    - name: "ollama"
      apiKey: ollama
      # use 'host.docker.internal' instead of localhost if running LibreChat in a docker container
      baseURL: "http://172.17.0.1:11434" 
      models:
        default: [
            "qwen3:32b",
            "qwen3:30b",
            "qwen2.5-coder:32b",
            "qwq:latest",
            "deepseek-r1:70b",
            "deepseek-r1:32b",
            "codestral:latest",
            "mistral-small:latest",
            "qwen:32b",
            "deepseek-v2:16b",
            "deepseek-coder:33b"
          ]
        # fetching list of models is supported but the `name` field must start
        # with `ollama` (case-insensitive), as it does in this example.
        fetch: true

I can see that the mcp server was initialized without errors:

LibreChat         | 2025-06-05 14:07:53 info: RAG API is running and reachable at http://rag_api:8000.
LibreChat         | 2025-06-05 14:07:53 info: [MCP] Initializing app-level servers
LibreChat         | 2025-06-05 14:07:53 info: [MCP][raw-oxial] Creating SSE transport: http://172.17.0.1:8000/sse
LibreChat         | 2025-06-05 14:07:53 info: [MCP][raw-oxial] Capabilities: {"experimental":{},"prompts":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"tools":{"listChanged":false}}
LibreChat         | 2025-06-05 14:07:53 info: [MCP] Initialized 1/1 app-level server(s)
LibreChat         | 2025-06-05 14:07:53 info: [MCP][raw-oxial] ✓ Initialized
LibreChat         | 2025-06-05 14:07:53 info: [MCP] All app-level servers initialized successfully

Am I doing something wrong ?

[torcato]

Ok, my mcp server had a bug and did not have any tools.
Sorry for the spam

[hinewin]

Im getting a different issue where I'm getting a Access token missing from my MCP server connection
#8594