perplexity

1# Perplexity Tools
2 
3Use ONLY when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7), gt CLI (use Graphite MCP), or workspace questions (use Nx MCP).
4 
5## Quick Reference
6 
7**Which Perplexity tool?**
8- Need search results/URLs? → **Perplexity Search**
9- Need conversational answer? → **Perplexity Ask**
10- Need deep research? → **Researcher agent** (`/research <topic>`)
11 
12**NOT Perplexity - use these instead:**
13- Library/framework docs → **Context7 MCP**
14- Graphite `gt` CLI → **Graphite MCP**
15- THIS workspace → **Nx MCP**
16- Specific URL → **URL Crawler**
17 
18## Perplexity Search
19 
20**When to use:**
21- Generic searches, finding resources
22- Current best practices, recent information
23- Tutorial/blog post discovery
24- User says "search for...", "find...", "look up..."
25 
26**Default parameters (ALWAYS USE):**
27```typescript
28mcp__perplexity__perplexity_search({
29  query: "your search query",
30  max_results: 3,           // Default is 10 - too many!
31  max_tokens_per_page: 512  // Reduce per-result content
32})
33```
34 
35**When to increase limits:**
36Only if:
37- User explicitly needs comprehensive results
38- Initial search found nothing useful
39- Complex topic needs multiple sources
40 
41```typescript
42// Increased limits (use sparingly)
43mcp__perplexity__perplexity_search({
44  query: "complex topic",
45  max_results: 5,
46  max_tokens_per_page: 1024
47})
48```
49 
50## Perplexity Ask
51 
52**When to use:**
53…