Image missing.
We revamped our docs for AI-driven development

created: July 26, 2025, 11:19 p.m. | updated: Aug. 1, 2025, 5:07 a.m.

When we launched them, their descriptions looked like:listDocs : "List the available Freestyle documentation": "List the available Freestyle documentation" getDocById : "Get a specific documentation page by its id"This lead to the AI never using these tools — Cursor/AI Agents had access to our documentation, but they never read them. In version 2 of our MCP, we changed the descriptions to:listDocs : "This tool lists all available Freestyle documentation pages. Whenever you're using Freestyle and you aren't sure how to do something, you should use this tool to check if there is documentation for it." : "This tool lists all available Freestyle documentation pages. getDocById : "This tool gets a specific Freestyle documentation page by its id.

5 days, 6 hours ago: Hacker News