Home / Fixes

MCP search returns results for nonsense queries

Error: Search returns unrelated hits instead of nothing

What causes it

Most docs and search servers we tested (Exa, Microsoft Learn, AWS Knowledge, Astro, and every Mintlify-hosted docs server) always return their nearest matches. Only a few return a clean empty result: OpenAI Docs, Retool Docs, LiveKit Docs, grep.app, CoinGecko, and Cohere Docs, which refuses off-topic questions. A nonsense query gave unrelated pages in our runs, so an agent cannot tell "nothing found" from a weak match.

How to fix it

  1. Check relevance yourself (title or URL contains your key term) before trusting a result.
  2. Ask the agent to verify a hit with a fetch before citing it.

Where we hit it

Related fixes

All MCP fixes | Setup guides | Hit a different error? Request a test