Improved
MCP Server v0.0.1-beta.7
4 months ago by ReadMe API
What's New
AI Agent Usability Overhaul
- Auto-extracted body schema hints — agents now see valid enums and required fields for every write endpoint, extracted automatically from the OpenAPI spec
- Hand-curated ACTION_NOTES — working examples, gotcha warnings, and required field hints for the trickiest endpoints (experiences, locations, audiences, hypotheses, etc.)
- Error response hints — when an action fails, the error now includes contextual guidance so agents self-correct on retry
Tool Discoverability Fix
- Rewrote SERVER_INSTRUCTIONS so MCP clients (Claude Desktop, ChatGPT, etc.) correctly reach for the 13 namespace API tools instead of only using
search_knowledge_base - All namespace descriptions now clearly indicate direct API access to the user's Convert.com account
Embedded Knowledge Base (Hybrid Search)
- MiniSearch (BM25 keyword) + Zvec (semantic vector store) with Reciprocal Rank Fusion
- The server can now answer Convert platform questions and guide users through concepts without external docs
Shutdown Crash Fix
- Fixed SIGABRT on shutdown when semantic search init partially loads native modules but falls back to keyword-only mode
- Smoke tests now validate clean shutdown (catch abnormal exits)
Other
- Dynamic account ID discovery in real API smoke test (no more hardcoded IDs)
- MCP spec-compliant tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
- Updated OpenAPI spec and dependency refresh
Test Evidence
- 123 unit tests passing (action-notes, annotations, RRF fusion)
- Stdio smoke test passing (14 tools, clean shutdown)
- Live API smoke test passing (accounts → projects → experiences chain)