MDV vs Tavily Deep Research API

“I've been writing separate README, dashboard, and slide deck for the same data for years. MDV collapsing those into one source-of-truth file is the kind of DRY solution I didn't know I needed. The frontmatter-extension approach means it works in existing markdown tooling. Shipping for internal docs immediately.”

“The primitive here is clean: you POST a query, you get back a structured citation graph plus a synthesized summary, all under the same API key you're already using. The DX bet is zero-new-surface-area — no new SDK, no new auth, no new mental model if you're already a Tavily customer, which is exactly right. The moment of truth is 'does this handle multi-hop queries better than chaining my own search calls,' and from the documented output schema the citation graph is a genuine differentiator — not just a list of URLs but a graph of which sources informed which claims. A competent engineer can chain search calls themselves, but normalizing source attribution across async fetches is the exact tedious thing worth outsourcing. Ships on the strength of that specific decision.”

“Embedding live SQL queries in documentation is a security and maintainability footgun. Who reviews the data access in a markdown file? The concept is compelling but the execution needs a clear story for access control, query sandboxing, and handling stale or broken data connections in production docs.”

“Direct competitors are Perplexity's API and Exa's research features, both of which also return cited sources. Tavily's differentiator is the citation graph structure rather than a flat list — that's a real distinction if your downstream pipeline actually consumes graph data, and nobody else is returning it in this shape. The scenario where this breaks: long-horizon research tasks where source freshness and hallucination compound across five or more hops, because the autonomy of the 'multi-step' loop is only as good as the model driving it, which Tavily doesn't control. What kills this in 12 months is OpenAI or Anthropic shipping native grounded search with structured attribution inside their flagship APIs, which they are actively building. I'm shipping it because the citation graph is genuinely differentiated today, but the moat has an expiration date.”

“The next evolution of documentation is documents that are executable — that don't just describe the system but are the system. MDV is an early step toward that: markdown that isn't just readable by humans but queryable, renderable, and automatable by agents. Worth watching closely.”

“The thesis here is that citation graphs become load-bearing infrastructure in agentic pipelines — specifically that as agents make consequential decisions, the humans overseeing them will demand auditable source chains, not just answers. That's a falsifiable claim: it pays off if AI governance pressure increases and 'show your work' becomes a compliance requirement, and it falls apart if agents stay in low-stakes consumer contexts where nobody cares. The second-order effect that isn't obvious: if citation graphs become standard output, the tools that aggregate and visualize those graphs become the new UI layer — Tavily is quietly positioning as the data producer for a knowledge-graph ecosystem that doesn't fully exist yet. They're early on the structured-provenance trend line, which is exactly where you want to be — before the tooling around it matures but after the demand signal is clear.”

“Being able to write a client report in markdown that automatically pulls live data and renders as a slide deck is genuinely transformative for independent consultants and content creators. MDV could replace Notion, Google Slides, and a BI tool for a substantial percentage of small team workflows.”

“The buyer is clear: it's the developer building an agent or RAG product who needs research grounding without building their own crawler stack. That budget comes from engineering headcount avoided, not from a discretionary AI tools line item — that's a durable purchase. The moat question is the hard one: Tavily's defensibility is their search index and crawling infrastructure, which is real but not impenetrable given how fast Exa and others are scaling. The smart move they've made is embedding citation graphs as a structured output format — that creates mild workflow lock-in because downstream code starts depending on that schema. What I want to see is whether they have volume commitment deals or enterprise contracts, because pay-per-use at this price point gets renegotiated the moment usage scales and the cost per query becomes visible on someone's AWS bill.”