Expose a Docs API for Model Context Protocol servers

[dangdennis]

What’s the best way today to query for all the docs that ocaml.org generates? Is there an HTTP API available for this yet?

I’d like to build an MCP server for ocaml.org to facilitate more LLM use cases with OCaml. The model context protocol defines APIs for LLMs to query data that it may not yet have.

My use case is that I’d like an easy way to have Claude add all the generated odoc artifacts of any particular opam library (that has docs). This guarantees Claude will have an updated and deeper understanding of what’s available in the library.

Today I have to either hope that an LLM corpus cutoff date included the version of an opam library I need or have to manually copy/paste texts into the LLM input myself.

[cuihtlauac]

Hi @dangdennis

Packages are queried with requests looking like this:

https://docs-data.ocaml.org/live/p/fmt/0.10.0/status.json
https://docs-data.ocaml.org/live/p/fmt/0.10.0/index.js

Let us know if you can use that and what you achieve.

We'd love to provide support from MCP inside ocaml.org.

[dangdennis]

Thank you. That example link is exactly what I needed.

MCP servers can only be run locally today unfortunately. The docs say remote hosts are WIP. So maybe one day, yes, Claude/other MCP clients can directly query ocaml.org for the docs and specific versions, but not today.

[dangdennis]

Is there a way to get the latest version of a lib without explicitly setting a version? Ocaml.org uses https://ocaml.org/p/fmt/latest so I was hoping something like https://docs-data.ocaml.org/live/p/fmt/latest/status.json would work.

[cuihtlauac]

latest is handled in the ocaml.org source code, and https://docs-data.ocaml.org/ doesn't support it. ocaml.org clones and polls https://github.com/ocaml/opam-repository.git (it only contains metadata) to maintain the list of versions and determine what latest is.