Wire the DeepWiki MCP into your agent so it looks up repos instead of hallucinating

The Stack

Steps

1. 1

   Write the MCP client config and validate the tools + round-trip

   Declare the DeepWiki MCP server and the three tools your agent will call, plus a round-trip fixture describing what an ask_question call should return. CI checks the config parses, all three tools are present, and the fixture is defined. The live index call is fenced.

   cat > deepwiki-mcp.json <<'JSON'
   {
     "mcpServers": {
       "deepwiki": {
         "url": "https://mcp.deepwiki.com/mcp",
         "tools": ["read_wiki_structure", "read_wiki_contents", "ask_question"]
       }
     },
     "roundtrip_fixture": {
       "tool": "ask_question",
       "input": { "repo": "vercel/next.js", "question": "where is request auth validated" },
       "expected_shape": { "answer": "string", "citations": "array" }
     }
   }
   JSON
   node -e '
   const fs = require("fs");
   const c = JSON.parse(fs.readFileSync("deepwiki-mcp.json", "utf8"));
   function bad(m) { console.error("BAD: " + m); process.exit(1); }
   const srv = (c.mcpServers && c.mcpServers.deepwiki) || null;
   if (!srv || !srv.url) bad("no deepwiki MCP server with a url");
   const required = ["read_wiki_structure", "read_wiki_contents", "ask_question"];
   const tools = srv.tools || [];
   const missing = required.filter(function (t) { return tools.indexOf(t) === -1; });
   if (missing.length) bad("MCP config is missing documented tool(s): " + missing.join(", "));
   const f = c.roundtrip_fixture || {};
   if (!f.tool || !f.input || !f.expected_shape) bad("round-trip fixture needs a tool, input, and expected_shape");
   console.log("config OK: DeepWiki MCP wired (" + required.length + "/3 tools present); round-trip fixture for " + f.tool + " defined (live index fenced)");
   '

2. 2

   Let the agent query it mid-task (the live index step, not checked by CI)

   Point your agent at the DeepWiki MCP and let it call ask_question when it hits an unfamiliar dependency. Cross-check anything security-sensitive against the real source, because the index can be stale. The live call and its freshness are fenced.