Answers from the documentation; checking which model is on duty
Hi - I answer from the OpenSmartRoute documentation: routing, the API, plans and quotas, self-hosting. Ask away, or open a support ticket if you need a person.
Grounded in the docs - follow a source before acting on it.
perplexity-search - Skill - OpenSmartRoute
Skillv1.0.0
perplexity-search
AI-powered web search, research, and reasoning via Perplexity
Imported from parcadei/continuous-claude-v3 (.claude/skills/perplexity-search/SKILL.md) via skills.sh. Install upstream with npx skills add parcadei/continuous-claude-v3 --skill perplexity-search. Copyright stays with the author.
Perplexity AI Search
Web search with AI-powered answers, deep research, and chain-of-thought reasoning.
When to Use
Direct web search for ranked results (no AI synthesis)
AI-synthesized research with citations
Chain-of-thought reasoning for complex decisions
Deep comprehensive research on topics
Models (2025)
Model
Purpose
sonar
Lightweight search with grounding
sonar-pro
Advanced search for complex queries
sonar-reasoning-pro
Chain of thought reasoning
sonar-deep-research
Expert-level exhaustive research
Usage
Quick question (AI answer)
uv run python scripts/mcp/perplexity_search.py \ --ask "What is the latest version of Python?"
uv run python scripts/mcp/perplexity_search.py \ --research "compare FastAPI vs Django for microservices"
Chain-of-thought reasoning
uv run python scripts/mcp/perplexity_search.py \ --reason "should I use Neo4j or SQLite for small graph under 10k nodes?"
Deep comprehensive research
uv run python scripts/mcp/perplexity_search.py \ --deep "state of AI agent observability 2025"
Parameters
Parameter
Description
--ask
Quick question with AI answer (sonar)
--search
Direct web search - ranked results without AI synthesis
--research
AI-synthesized research (sonar-pro)
--reason
Chain-of-thought reasoning (sonar-reasoning-pro)
--deep
Deep comprehensive research (sonar-deep-research)
Search-specific options
Parameter
Description
--max-results N
Number of results (1-20, default: 10)
--recency
Filter: day, week, month, year
--domains
Limit to specific domains
Mode Selection Guide
Need
Use
Why
Quick fact
--ask
Fast, lightweight
Find sources
--search
Raw results, no AI overhead
Synthesized answer
--research
AI combines multiple sources
Complex decision
--reason
Chain-of-thought analysis
Comprehensive report
--deep
Exhaustive multi-source research
Examples
# Find recent sources on a topicuv run python scripts/mcp/perplexity_search.py \ --search "OpenTelemetry AI agent tracing" \ --recency month --max-results 5# Get AI synthesisuv run python scripts/mcp/perplexity_search.py \ --research "best practices for AI agent logging 2025"# Make a decisionuv run python scripts/mcp/perplexity_search.py \ --reason "microservices vs monolith for startup MVP"# Deep diveuv run python scripts/mcp/perplexity_search.py \ --deep "comprehensive guide to building feedback loops for autonomous agents"
API Key Required
Requires PERPLEXITY_API_KEY in environment or ~/.claude/.env.
Installed into a catalogue, chosen by a router
Install perplexity-search and it becomes one more candidate the router can pick - when it fits.
A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.
When a provider is down or over quota the request moves on; the trace says it did.
Use it
Copy one of these into your project. Installing also returns the manifest and these snippets.
# after Install: the listing is in your workspace's routing pool - a plan picks it for its slotcurl-s-X POST https://osr-api.kindrock-caaab1a2.centralindia.azurecontainerapps.io/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'
Manifest
An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.
