Very close to this at my company. We have docs each of which having its description in the yaml. An MCP tool lists the doc sections, a full section with its des

Very close to this at my company. We have docs each of which having its description in the yaml. An MCP tool lists the doc sections, a full section with its descriptions, or the entire contents of a doc. A kind of progressive disclosure. Works really well. We even write "skills" this way so they can be used in all our chat environments.