Tutorial

How to Build a Perplexity-Style MCP Search Tool

Build a search tool that gives Claude Perplexity-like capabilities: multi-source search with citations, all via MCP without paying per-token API fees.

Perplexity's MCP integration costs $5-14/1K requests plus per-token fees. You can build a similar capability using a structured search API: multi-source search with citation URLs that Claude can synthesize into cited answers. This tutorial builds that pattern using Scavio's MCP server.

Prerequisites

  • Claude Desktop or Claude Code with MCP support
  • A Scavio API key

Walkthrough

Step 1: Connect Scavio MCP to Claude

Add Scavio's hosted MCP server to your Claude Desktop or Claude Code configuration.

JSON
// For Claude Desktop, add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "scavio": {
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "your_scavio_api_key"
      }
    }
  }
}

// For Claude Code, add to .mcp.json in your project:
{
  "mcpServers": {
    "scavio": {
      "url": "https://mcp.scavio.dev/mcp",
      "headers": { "x-api-key": "your_scavio_api_key" }
    }
  }
}

Step 2: Use multi-source search for cited answers

Ask Claude to search multiple platforms and cite sources in its response.

Bash
# In Claude Desktop/Code, you can now ask:
# 'Search Google and Reddit for the current state of the SerpAPI lawsuit
#  and summarize with citations.'

# Claude will:
# 1. Call google_search('serpapi google lawsuit 2026')
# 2. Call reddit_search('serpapi lawsuit update')
# 3. Synthesize results with [Source](URL) citations

# This gives Perplexity-style cited answers without per-token API fees.
# Cost: 2 credits ($0.01) vs Perplexity Sonar ($0.005-0.014 per request + tokens)

Step 3: Build a custom multi-search prompt

Create a system prompt pattern that instructs Claude to search multiple sources and cite them.

Python
# Save this as a Claude Code custom command or system prompt:
RESEARCH_PROMPT = """
When answering research questions:
1. Search Google for factual/official sources
2. Search Reddit for community opinions and experiences
3. Search YouTube for relevant video content (if applicable)
4. Synthesize findings into a clear answer
5. Cite each claim with [Source Title](URL)
6. Note any conflicting information between sources

Always search at least 2 platforms before answering.
"""

Step 4: Compare costs with Perplexity Sonar

Calculate the cost difference between this approach and Perplexity's API.

Python
# Perplexity Sonar API pricing (verified May 2026):
# - Base model: $1/$1 per million tokens + $5/1K requests
# - Pro model: $3/$15 per million tokens + $14/1K requests

# Example: 100 research queries per day
perplexity_base = (100 * 5 / 1000) + (100 * 500 * 2 / 1_000_000)  # ~$0.60/day
perplexity_pro = (100 * 14 / 1000) + (100 * 500 * 18 / 1_000_000)  # ~$2.30/day

# Scavio MCP approach: 2-3 searches per query * 100 queries = 200-300 credits
scavio_cost = 300 * 0.005  # $1.50/day
# But Claude is already paid for (subscription). Only additional cost is search API.
# If on free tier: 500 free credits covers 166 multi-source queries/month

print(f'Perplexity Base: ${perplexity_base:.2f}/day for 100 queries')
print(f'Perplexity Pro: ${perplexity_pro:.2f}/day for 100 queries')
print(f'Scavio MCP: ${scavio_cost:.2f}/day for 100 queries (search cost only)')

Python Example

Python
# No Python SDK needed - MCP handles the integration.
# Scavio MCP server URL: https://mcp.scavio.dev/mcp
# Claude automatically discovers: google_search, reddit_search, youtube_search,
# amazon_search, walmart_search tools when connected.

JavaScript Example

JavaScript
// MCP configuration is JSON-based, no code needed:
// Add to your MCP client config:
const mcpConfig = {
  scavio: {
    url: 'https://mcp.scavio.dev/mcp',
    headers: { 'x-api-key': process.env.SCAVIO_API_KEY }
  }
};

Expected Output

JSON
A Perplexity-style research capability in Claude Desktop/Code using Scavio MCP, providing multi-source cited answers at lower cost than Perplexity Sonar API.

Related Tutorials

Frequently Asked Questions

Most developers complete this tutorial in 15 to 30 minutes. You will need a Scavio API key (free tier works) and a working Python or JavaScript environment.

Claude Desktop or Claude Code with MCP support. A Scavio API key. A Scavio API key gives you 500 free credits per month.

Yes. The free tier includes 500 credits per month, which is more than enough to complete this tutorial and prototype a working solution.

Scavio has a native LangChain package (langchain-scavio), an MCP server, and a plain REST API that works with any HTTP client. This tutorial uses the raw REST API, but you can adapt to your framework of choice.

Start Building

Build a search tool that gives Claude Perplexity-like capabilities: multi-source search with citations, all via MCP without paying per-token API fees.