diff --git a/pipecat/get-started/ai-tools.mdx b/pipecat/get-started/ai-tools.mdx
index 1d4e02f9..a3994450 100644
--- a/pipecat/get-started/ai-tools.mdx
+++ b/pipecat/get-started/ai-tools.mdx
@@ -5,70 +5,9 @@ description: "Use AI coding tools with Pipecat documentation and source code."
Pipecat offers several ways to give AI coding tools access to documentation and source code context, helping you build voice and multimodal applications faster.
-## MCP Server
+## Pipecat Context Hub (MCP Server)
-The Pipecat docs MCP server is a cloud-hosted service powered by [Kapa.ai](https://www.kapa.ai/) that searches across the full Pipecat documentation site. It returns synthesized answers with source citations, covering guides, API references, and other docs content. No local setup required.
-
-
-
- ```bash
- claude mcp add --transport http pipecat-docs https://daily-docs.mcp.kapa.ai
- ```
-
-
- ```bash
- codex mcp add pipecat-docs --url "https://daily-docs.mcp.kapa.ai"
- ```
-
-
-
- 
-
-
- Or manually add to your Cursor MCP config:
-
- ```json
- {
- "mcpServers": {
- "pipecat-docs": {
- "url": "https://daily-docs.mcp.kapa.ai"
- }
- }
- }
- ```
-
-
-
- 
-
-
- Or manually add to your VS Code MCP config (`.vscode/mcp.json`):
-
- ```json
- {
- "servers": {
- "pipecat-docs": {
- "url": "https://daily-docs.mcp.kapa.ai"
- }
- }
- }
- ```
-
-
-
-## Pipecat Context Hub
-
-[Pipecat Context Hub](https://github.com/pipecat-ai/pipecat-context-hub) is a local-first MCP server that indexes Pipecat documentation, code examples, and framework API source on your machine. Unlike the cloud-hosted MCP server above, Context Hub runs a local vector database and is optimized for coding workflows — it returns relevant source code and snippets rather than synthesized answers, giving your AI coding tool the raw context it needs to solve implementation problems.
+[Pipecat Context Hub](https://github.com/pipecat-ai/pipecat-context-hub) is a local-first MCP server that indexes Pipecat documentation, code examples, and framework API source on your machine. It runs a local vector database and is optimized for coding workflows. It returns relevant source code and snippets rather than synthesized answers, giving your AI coding tool the raw context it needs to solve implementation problems.
Because it runs locally, you can also add your own repositories (public or private) to the index for a more customized context.
@@ -76,11 +15,10 @@ Available tools include `search_docs`, `search_examples`, `search_api`, `get_cod
### Setup
+The hub is published to PyPI as `pipecat-ai-context-hub` and runs with [`uv`](https://docs.astral.sh/uv/) — no clone required. Build the local index once:
+
```bash
-git clone https://github.com/pipecat-ai/pipecat-context-hub.git
-cd pipecat-context-hub
-uv sync
-uv run pipecat-context-hub refresh # build local index (~2 min first run)
+uvx pipecat-ai-context-hub refresh # build local index (~2 min first run)
```
### Add to your coding tool
@@ -88,14 +26,12 @@ uv run pipecat-context-hub refresh # build local index (~2 min first run)
```bash
- claude mcp add pipecat-context-hub \
- -- uv run --directory /path/to/pipecat-context-hub pipecat-context-hub serve
+ claude mcp add pipecat-context-hub -- uvx pipecat-ai-context-hub serve
```
```bash
- codex mcp add pipecat-context-hub \
- -- uv run --directory /path/to/pipecat-context-hub pipecat-context-hub serve
+ codex mcp add pipecat-context-hub -- uvx pipecat-ai-context-hub serve
```
@@ -105,18 +41,13 @@ uv run pipecat-context-hub refresh # build local index (~2 min first run)
{
"mcpServers": {
"pipecat-context-hub": {
- "command": "uv",
- "args": [
- "run",
- "--directory",
- "/path/to/pipecat-context-hub",
- "pipecat-context-hub",
- "serve"
- ]
+ "command": "uvx",
+ "args": ["pipecat-ai-context-hub", "serve"]
}
}
}
```
+
Add to `.vscode/mcp.json`:
@@ -125,21 +56,30 @@ uv run pipecat-context-hub refresh # build local index (~2 min first run)
{
"servers": {
"pipecat-context-hub": {
- "command": "uv",
- "args": [
- "run",
- "--directory",
- "/path/to/pipecat-context-hub",
- "pipecat-context-hub",
- "serve"
- ]
+ "command": "uvx",
+ "args": ["pipecat-ai-context-hub", "serve"]
}
}
}
```
+
+A newly added MCP server loads when your coding tool starts a session, so add it before opening the session you want to use it in.
+
+### Use it without MCP
+
+The same tools are available as one-shot CLI commands, so you can query the index from a shell with no MCP setup — handy in a session where the MCP server isn't connected yet:
+
+```bash
+uvx pipecat-ai-context-hub check-deprecation PipelineTask
+uvx pipecat-ai-context-hub search-api "WebsocketServerParams"
+uvx pipecat-ai-context-hub status # index health / freshness
+```
+
+Each command prints the tool's JSON to stdout. The package name is `pipecat-ai-context-hub`; the command and MCP server are named `pipecat-context-hub` (both spellings of the command resolve once installed).
+
See the [repo docs](https://github.com/pipecat-ai/pipecat-context-hub) for additional configuration options, including pinning to a specific Pipecat version.
## CLAUDE.md