Skip to content

Commit 0c40510

Browse files
ankur-archclaude
andauthored
blog: search the Prisma docs from your coding agent (#7973)
* blog: search the Prisma docs from your coding agent Draft post introducing the search_prisma_documentation MCP tool: what it does, how it proxies Kapa under the hood, how to use it, and a closing nod to Prisma Postgres and Compute. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Update apps/blog/content/blog/search-prisma-docs-from-your-coding-agent/index.mdx * Update apps/blog/content/blog/search-prisma-docs-from-your-coding-agent/index.mdx * Update apps/blog/content/blog/search-prisma-docs-from-your-coding-agent/index.mdx * blog: tighten prose, cross-link MCP docs, de-salesify closing Re-apply the prose cleanups on top of the PR edits: drop conditional "if you..." openers, link the MCP server docs page, and rewrite the closing as a plain pointer to the products the docs search covers (ORM/Next, Postgres, Compute) instead of a product pitch. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * blog: apply Sentry blog-writing-guide pass Problem-first opening (state the problem in the first two sentences), specific section headings instead of generic labels, and a short FAQ targeting long-tail questions. Removes the duplicated problem statement. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * blog: align metaTitle with title, name more MCP clients for SEO Match metaTitle to the post title, and call out Cursor, Codex, Windsurf, and VS Code alongside Claude Code in the how-to and FAQ. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Update apps/blog/content/blog/search-prisma-docs-from-your-coding-agent/index.mdx * Update apps/blog/content/blog/search-prisma-docs-from-your-coding-agent/index.mdx * Update apps/blog/content/blog/search-prisma-docs-from-your-coding-agent/index.mdx * blog: add hero/meta image for Prisma docs search post Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * blog: use SVG hero and PNG meta image for docs search post Replace hero.png with hero.svg (hero) and meta.png (social/OG), matching the repo's hero.svg + meta.png convention. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * blog: shrink hero/meta images (23MB SVG -> 350KB PNG) Replace the 23MB wrapped-raster hero.svg with an optimized 1688px hero.png (350KB) and a 1200px OG meta.png (190KB). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent e0c66b8 commit 0c40510

3 files changed

Lines changed: 63 additions & 0 deletions

File tree

  • apps/blog
    • content/blog/search-prisma-docs-from-your-coding-agent
    • public/search-prisma-docs-from-your-coding-agent/imgs
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
title: "Search the Prisma Docs Using Your Coding Agent"
3+
slug: "search-prisma-docs-from-your-coding-agent"
4+
date: "2026-06-23"
5+
authors:
6+
- "Ankur Datta"
7+
metaTitle: "Search the Prisma Docs Using Your Coding Agent"
8+
metaDescription: "The Prisma MCP server now answers documentation questions in your editor. Ask about ORM, Postgres, or Compute and get a cited answer, no tab-switching, no extra setup."
9+
heroImagePath: "/search-prisma-docs-from-your-coding-agent/imgs/hero.png"
10+
heroImageAlt: "Your coding agent can now search the Prisma docs"
11+
metaImagePath: "/search-prisma-docs-from-your-coding-agent/imgs/meta.png"
12+
tags:
13+
- "ai"
14+
- "orm"
15+
---
16+
17+
Your coding agent is mid-task and needs one specific answer from the Prisma docs. The usual move is to switch to a browser, search, scan a page, and come back, losing your place along the way.
18+
19+
The Prisma MCP server now skips that trip. Ask a documentation question about Prisma ORM, Prisma Postgres, schema design, or migrations, and get a cited answer assembled from the official docs, right where your agent is working. The tool rides along on the MCP server you already use to spin up databases: no new server to register, no extra auth, no client-side config.
20+
21+
## What the docs tool does
22+
23+
`search_prisma_documentation` takes a natural-language question and returns a cited answer with links back to the source. It is read-only, so it also works when your client runs in a restricted mode.
24+
25+
## What the Prisma MCP server already does
26+
27+
The [Prisma MCP server](/about-mcp-servers-and-how-we-built-one-for-prisma) lets AI tools manage Prisma Postgres through a standard interface: list databases, run SQL, introspect schemas. Docs search is the newest tool in that set, on the same server and connection. See the [MCP server docs](https://www.prisma.io/docs/ai/tools/mcp-server) for setup and the full tool list.
28+
29+
## How docs search proxies Kapa
30+
31+
Under the hood, `search_prisma_documentation` proxies [Kapa's hosted MCP server](https://docs.kapa.ai/integrations/mcp/guides/tutorial-proxy-kapa-from-your-mcp). Per call, our server connects to Kapa as a client, forwards your question, and returns the answer. Your client only ever talks to one endpoint, ours, while Kapa handles retrieval behind it.
32+
33+
The Kapa API key stays server-side and never reaches your machine. Calls run through the same auth, rate limiting, and tracing as every other tool.
34+
35+
## How to use it
36+
37+
Connect to the Prisma MCP server as usual. For Claude Code:
38+
39+
```bash
40+
claude mcp add --transport http prisma https://mcp.prisma.io/mcp
41+
```
42+
43+
The same works in any MCP client, Cursor, Codex, Windsurf, VS Code, or the Vercel MCP integration, using that client's own MCP config and the `https://mcp.prisma.io/mcp` endpoint.
44+
45+
Then just ask, and your agent picks the tool up on its own:
46+
47+
> Use the Prisma docs search to find out how connection pooling works on Prisma Postgres.
48+
49+
Or call it directly from any MCP client:
50+
51+
```json
52+
{
53+
"name": "search_prisma_documentation",
54+
"arguments": { "query": "How do I deploy my project to Prisma Compute" }
55+
}
56+
```
57+
58+
You get back a markdown answer with links to the relevant pages on [prisma.io/docs](https://www.prisma.io/docs).
59+
60+
## One tool to access the entire Prisma docs
61+
62+
The answers come from the full Prisma docs, so the same tool spans every latest product changes. Ask it about [Prisma Next](https://pris.ly/pn-ea), [Prisma Postgres](https://www.prisma.io/postgres), or [Prisma Compute](https://www.prisma.io/compute), and the answer comes back without leaving the editor.
63+
342 KB
Loading
186 KB
Loading

0 commit comments

Comments
 (0)