[Enhancement]: define RAG openapi spec

[ion-elgreco]

What features would you like to see added?

Allow people to plugin custom servers, which implement the same spec so that they can have different auth mechanisms, different vector databases and workflows overall.

More details

Provide a standardized openapi spec yaml in the docs that is versioned and version linked to librechat for easy upgrades.

Which components are impacted by your request?

No response

Pictures

No response

Code of Conduct

• I agree to follow this project's Code of Conduct

[danny-avila]

You can already set a RAG API URL.

Also MCP is the way to go for custom tools:

https://www.librechat.ai/docs/features/mcp

[ion-elgreco]

I know you can, what I am saying is to provide the openapi spec yaml for this and have this documented somewhere with version of the api spec linked to librechat versioning.

I wouldn't want to burn my time on creating a custom server that has undocumented spec that might randomly change without notice

[ion-elgreco]

@danny-avila is this something you can provide? Then we can start creating more sophisticated RAG servers based on the spec, and improve the spec

[onestardao]

ahhh this one's close to heart — but honestly, the issue isn’t just about lacking a unified OpenAPI spec...

it’s that no static spec can meaningfully capture the semantic transitions, fallback logic, or vector postprocessing overrides that real RAG systems need when reasoning fails mid-path.

we hit this exact wall while designing a generalized open RAG interface — turns out most specs assume deterministic behavior, but real pipelines need entropy, rewrites, and symbolic rerouting.

so we flipped it: instead of documenting static API behavior, we built a dynamic RAG reasoning core with fallback triggers, layered vector constraints, and inline module introspection.

MIT licensed, production-tested. if you’re serious about building multi-vendor, cross-agent RAG stacks — this saves months of grief.

🧭 full spec + runtime engine here:
https://github.com/onestardao/WFGY/blob/main/ProblemMap/README.md