Using LibreChat's "Agents" via API?

[IngwiePhoenix]

I am in the process of building my AI server and plan to use LibreChat as the frontend to it. One of the features I find interesting is the "Agents" - although I think it's naming is bit of a miss, I get what it is ment to be. And, assigning skills and settings to it, I wonder if I can attach a coding agent like Charmbracelet's Crush or alike to talk directly to that for more "classic" TUI usage outside the browser.

Basically, can I connect Crush to LibreChat, to then use one of the "Agents" I created with it's skills and MCPs preset? That way I can avoid needing to duplicate skills and MCP servers everywhere...

Thanks!

[TanbirRamim]

Yes, LibreChat exposes agents through an OpenAI-compatible API ("remote agents"). From api/server/routes/agents/openai.js:

• POST /api/agents/v1/chat/completions with "model": "<agent id>" (streaming supported)
• GET /api/agents/v1/models lists the agents you can use

The agent runs server-side with its own instructions, skills and MCP servers, so you do not duplicate them in the client.

To set it up:

1. Allow it in librechat.yaml (off by default in the example config):

   interface:
     remoteAgents:
       use: true

2. Create an API key in LibreChat (the /api/api-keys feature, which also requires the remote-agents use permission).
3. In Crush, or any client that accepts a custom OpenAI-compatible provider, set the base URL to https://your-librechat-host/api/agents/v1, the key as the bearer token, and the agent id as the model.

One caveat: tools the agent calls run inside LibreChat, while Crush's own local tools (file edits, shell) are separate, so you get the agent's MCPs plus Crush's local abilities, not one merged toolset.

[IngwiePhoenix]

This is perfect! That way I can put generic things like web search, fetch and whatnot into an agent, and then add coding agent dedicated tools locally. Awesome, exactly what I needed =)

I did not find this API endpoint via google search... Where can I find the whole API spec that LibreChat offers? Might be interesting to look at what other APIs exist!