MCP Server (Model Context Protocol)
The MCP server exposes each registered model as a separate tool. Enable only the tools your MCP client needs.
Configuration
Add one of the following entries to your MCP client configuration. uvx creates an isolated Python environment for the server.
Claude Desktop (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"perplexity-webui-scraper": {
"command": "uvx",
"args": [
"--from",
"perplexity-webui-scraper[mcp]@latest",
"perplexity-webui-scraper",
"mcp"
],
"env": {
"PERPLEXITY_SESSION_TOKEN": "your_token_here"
}
}
}
}
From GitHub prod branch:
{
"mcpServers": {
"perplexity-webui-scraper": {
"command": "uvx",
"args": [
"--from",
"perplexity-webui-scraper[mcp]@git+https://github.com/henrique-coder/perplexity-webui-scraper.git@prod",
"perplexity-webui-scraper",
"mcp"
],
"env": {
"PERPLEXITY_SESSION_TOKEN": "your_token_here"
}
}
}
}
From local directory (for development):
{
"mcpServers": {
"perplexity-webui-scraper": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/perplexity-webui-scraper",
"run",
"perplexity-webui-scraper",
"mcp"
],
"env": {
"PERPLEXITY_SESSION_TOKEN": "your_token_here"
}
}
}
}
Optional Podman Image
For containerized stdio setups only:
# Pull published MCP image
podman pull ghcr.io/henrique-coder/perplexity-webui-scraper:mcp
# Run MCP server (requires token)
podman run --rm -it -e PERPLEXITY_SESSION_TOKEN=your_token ghcr.io/henrique-coder/perplexity-webui-scraper:mcp
This is niche. Prefer uvx for normal MCP client setups.
Available Tools
Each tool uses a specific AI model. Enable only the ones you need:
Tools marked [AVAILABLE] can be called normally. [UNKNOWN] and [UNAVAILABLE] tools require allow_risky_model=true. Official listing is exposed separately as is_official; it does not imply that a tool has been tested. The generic pplx_custom tool accepts an internal identifier, which always starts with unknown status and is_official=false.
Status reference
| Status | Meaning | Runtime behavior |
|---|---|---|
available |
Confirmed to work normally. | Normal use; the local minimum-tier check applies. |
unknown |
Current availability has not been confirmed. | Requires allow_risky_model; this is the default for unverified entries. |
unavailable |
Confirmed not to work with the current backend. | Requires allow_risky_model; retained for history and expected to fail. |
Model tools
| Tool | Model ID | Name | Official | Min. tier | Status | Last tested (UTC) |
|---|---|---|---|---|---|---|
pplx_best |
perplexity/best |
Best | true |
free | available |
2026-08-05T23:31:27.726694Z |
pplx_deep_research |
perplexity/deep-research |
Deep research | true |
pro | available |
2026-08-05T23:31:30.488422Z |
pplx_sonar |
perplexity/sonar-2 |
Sonar 2 | true |
pro | available |
2026-08-05T23:31:35.277279Z |
pplx_gpt56_terra |
openai/gpt-5.6-terra |
GPT-5.6 Terra | true |
pro | available |
2026-08-05T23:31:39.397301Z |
pplx_gpt56_terra_thinking |
openai/gpt-5.6-terra-thinking |
GPT-5.6 Terra Thinking | true |
pro | available |
2026-08-05T23:31:43.633312Z |
pplx_gpt56_sol |
openai/gpt-5.6-sol |
GPT-5.6 Sol | true |
max | available |
2026-08-05T23:31:48.536501Z |
pplx_gpt56_sol_thinking |
openai/gpt-5.6-sol-thinking |
GPT-5.6 Sol Thinking | true |
max | available |
2026-08-05T23:31:54.067766Z |
pplx_claude_s50 |
anthropic/claude-sonnet-5 |
Claude Sonnet 5 | true |
pro | available |
2026-08-05T23:31:57.917346Z |
pplx_claude_s50_think |
anthropic/claude-sonnet-5-thinking |
Claude Sonnet 5 Thinking | true |
pro | available |
2026-08-05T23:32:01.771184Z |
pplx_glm52 |
z-ai/glm-5.2 |
GLM 5.2 Thinking | true |
pro | available |
2026-08-05T23:32:05.681327Z |
pplx_gemini37_flash |
google/gemini-3.7-flash |
Gemini 3.7 Flash | true |
pro | available |
2026-08-18T06:24:44Z |
pplx_kimi_k3_thinking |
moonshot/kimi-k3-thinking |
Kimi K3 Thinking | true |
pro | available |
2026-08-05T23:32:13.388185Z |
pplx_gemini37_flash_think |
google/gemini-3.7-flash-thinking |
Gemini 3.7 Flash Thinking | true |
pro | available |
2026-08-18T06:24:50Z |
pplx_grok46 |
x-ai/grok-4.6 |
Grok 4.6 | true |
pro | available |
2026-08-18T06:24:56Z |
pplx_grok46_think |
x-ai/grok-4.6-thinking |
Grok 4.6 Thinking | true |
pro | available |
2026-08-18T06:25:02Z |
pplx_nemotron3_ultra_think |
nvidia/nemotron-3-ultra-thinking |
Nemotron 3 Ultra | true |
pro | available |
2026-08-05T23:32:26.248167Z |
pplx_claude_o50 |
anthropic/claude-opus-5 |
Claude Opus 5 | true |
max | available |
2026-08-05T23:32:30.076411Z |
pplx_claude_o50_think |
anthropic/claude-opus-5-thinking |
Claude Opus 5 Thinking | true |
max | available |
2026-08-05T23:32:35.570998Z |
pplx_gemini31_pro_think_high |
google/gemini-3.1-pro-thinking-high |
Gemini 3.1 Pro Thinking | false |
pro | available |
2026-08-05T23:32:09.529962Z |
pplx_grok45 |
x-ai/grok-4.5 |
Grok 4.5 | false |
pro | available |
2026-08-05T23:32:17.793450Z |
pplx_grok45_think |
x-ai/grok-4.5-thinking |
Grok 4.5 Thinking | false |
pro | available |
2026-08-05T23:32:21.682832Z |
pplx_claude_o48 |
anthropic/claude-opus-4.8 |
Claude Opus 4.8 | false |
max | available |
2026-08-05T23:32:40.127829Z |
pplx_claude_o48_think |
anthropic/claude-opus-4.8-thinking |
Claude Opus 4.8 Thinking | false |
max | available |
2026-08-05T23:32:43.944074Z |
pplx_gemini31_pro_think_low |
google/gemini-3.1-pro-thinking-low |
Gemini 3.1 Pro | false |
pro | available |
2026-08-05T23:32:46.838191Z |
pplx_kimi_k26_instant |
moonshot/kimi-k2.6-instant |
Kimi K2.6 | false |
pro | available |
2026-08-05T23:32:49.769820Z |
pplx_kimi_k26_thinking |
moonshot/kimi-k2.6-thinking |
Kimi K2.6 Thinking | false |
pro | available |
2026-08-05T23:32:52.594354Z |
pplx_nemotron3_super_think |
nvidia/nemotron-3-super-thinking |
Nemotron 3 Super | false |
pro | available |
2026-08-05T23:32:55.399808Z |
pplx_gpt54 |
openai/gpt-5.4 |
GPT-5.4 | false |
pro | available |
2026-08-05T23:32:57.888766Z |
pplx_gpt54_thinking |
openai/gpt-5.4-thinking |
GPT-5.4 Thinking | false |
pro | available |
2026-08-05T23:33:08.325486Z |
pplx_gpt55_thinking |
openai/gpt-5.5-thinking |
GPT-5.5 Thinking | false |
max | available |
2026-08-05T23:33:11.939198Z |
pplx_claude_o47 |
anthropic/claude-opus-4.7 |
Claude Opus 4.7 | false |
max | available |
2026-08-05T23:33:17.004817Z |
pplx_claude_o47_think |
anthropic/claude-opus-4.7-thinking |
Claude Opus 4.7 Thinking | false |
max | available |
2026-08-05T23:33:21.643555Z |
pplx_claude_s46 |
anthropic/claude-sonnet-4.6 |
Claude Sonnet 4.6 | false |
pro | available |
2026-08-05T23:33:24.724002Z |
pplx_claude_s46_think |
anthropic/claude-sonnet-4.6-thinking |
Claude Sonnet 4.6 Thinking | false |
pro | available |
2026-08-05T23:33:27.861669Z |
pplx_gpt4o |
openai/gpt4o |
GPT-4o | false |
unknown | available |
2026-08-05T23:33:31.502542Z |
pplx_gpt41 |
openai/gpt41 |
GPT-4.1 | false |
unknown | available |
2026-08-05T23:33:34.451036Z |
pplx_gpt5 |
openai/gpt5 |
GPT-5 | false |
unknown | available |
2026-08-05T23:33:37.081277Z |
pplx_gpt5_thinking |
openai/gpt5-thinking |
GPT-5 Thinking | false |
unknown | available |
2026-08-05T23:33:40.097475Z |
pplx_gpt51 |
openai/gpt51 |
GPT-5.1 | false |
unknown | available |
2026-08-05T23:33:43.180232Z |
pplx_gpt51_thinking |
openai/gpt51-thinking |
GPT-5.1 Thinking | false |
unknown | available |
2026-08-05T23:33:45.785394Z |
pplx_gpt51_low_thinking |
openai/gpt51-low-thinking |
GPT-5.1 Low Thinking | false |
unknown | available |
2026-08-05T23:33:48.638838Z |
pplx_gpt5_mini |
openai/gpt5-mini |
GPT-5 Mini | false |
unknown | available |
2026-08-05T23:33:53.467647Z |
pplx_gpt5_nano |
openai/gpt5-nano |
GPT-5 Nano | false |
unknown | available |
2026-08-05T23:33:56.805390Z |
pplx_gpt5_pro |
openai/gpt5-pro |
GPT-5 Pro | false |
unknown | available |
2026-08-05T23:34:01.165691Z |
pplx_gpt52 |
openai/gpt52 |
GPT-5.2 | false |
unknown | available |
2026-08-05T23:34:04.095823Z |
pplx_gpt52_thinking |
openai/gpt52-thinking |
GPT-5.2 Thinking | false |
unknown | available |
2026-08-05T23:34:07.087989Z |
pplx_gpt52_pro |
openai/gpt52-pro |
GPT-5.2 Pro | false |
unknown | available |
2026-08-05T23:34:11.454227Z |
pplx_gpt55 |
openai/gpt55 |
GPT-5.5 | false |
unknown | available |
2026-08-05T23:34:15.837430Z |
pplx_claude2 |
anthropic/claude2 |
Claude Sonnet 4.0 | false |
unknown | available |
2026-08-05T23:34:18.806306Z |
pplx_claude37sonnetthinking |
anthropic/claude37sonnetthinking |
Claude Sonnet 4.0 Thinking | false |
unknown | available |
2026-08-05T23:34:22.075182Z |
pplx_claude40sonnetthinking |
anthropic/claude40sonnetthinking |
Claude Sonnet 4.0 Thinking | false |
unknown | available |
2026-08-05T23:34:26.521079Z |
pplx_gemini25pro |
google/gemini25pro |
Gemini 2.5 Pro | false |
unknown | available |
2026-08-05T23:38:44.044228Z |
pplx_gemini30pro |
google/gemini30pro |
Gemini 3 Pro | false |
unknown | available |
2026-08-05T23:38:47.111485Z |
pplx_gemini30flash |
google/gemini30flash |
Gemini 3 Flash | false |
unknown | available |
2026-08-05T23:38:50.036192Z |
pplx_gemini30flash_high |
google/gemini30flash-high |
Gemini 3 Flash Thinking | false |
unknown | available |
2026-08-05T23:38:55.887205Z |
pplx_gemini35flash |
google/gemini35flash |
Gemini 3.5 Flash | false |
unknown | available |
2026-08-05T23:38:59.146680Z |
pplx_gemini35flash_medium |
google/gemini35flash-medium |
Gemini 3.5 Flash Medium Thinking | false |
unknown | available |
2026-08-05T23:39:02.043511Z |
pplx_gemini35flash_high |
google/gemini35flash-high |
Gemini 3.5 Flash Thinking | false |
unknown | available |
2026-08-05T23:39:05.934013Z |
pplx_grok |
x-ai/grok |
Grok 3 Beta | false |
unknown | available |
2026-08-05T23:39:08.797817Z |
pplx_claude40opus |
anthropic/claude40opus |
Claude Opus 4.0 | false |
unknown | available |
2026-08-05T23:39:11.760884Z |
pplx_claude40opusthinking |
anthropic/claude40opusthinking |
Claude Opus 4.0 Thinking | false |
unknown | available |
2026-08-05T23:39:15.658726Z |
pplx_claude41opus |
anthropic/claude41opus |
Claude Opus 4.1 | false |
unknown | available |
2026-08-05T23:39:20.431045Z |
pplx_claude41opusthinking |
anthropic/claude41opusthinking |
Claude Opus 4.1 Thinking | false |
unknown | available |
2026-08-05T23:39:24.984906Z |
pplx_claude45opus |
anthropic/claude45opus |
Claude Opus 4.5 | false |
unknown | available |
2026-08-05T23:39:29.543839Z |
pplx_claude45opusthinking |
anthropic/claude45opusthinking |
Claude Opus 4.5 Thinking | false |
unknown | available |
2026-08-05T23:39:33.615918Z |
pplx_claude46opus |
anthropic/claude46opus |
Claude Opus 4.6 | false |
unknown | available |
2026-08-05T23:39:41.127287Z |
pplx_claude46opusthinking |
anthropic/claude46opusthinking |
Claude Opus 4.6 Thinking | false |
unknown | available |
2026-08-05T23:39:46.076227Z |
pplx_claude45sonnet |
anthropic/claude45sonnet |
Claude Sonnet 4.5 | false |
unknown | available |
2026-08-05T23:39:49.423367Z |
pplx_claude45sonnetthinking |
anthropic/claude45sonnetthinking |
Claude Sonnet 4.5 Thinking | false |
unknown | available |
2026-08-05T23:39:52.219963Z |
pplx_claude45haiku |
anthropic/claude45haiku |
Claude Haiku 4.5 | false |
unknown | unavailable |
2026-08-05T23:39:58.315774Z |
pplx_claude45haikuthinking |
anthropic/claude45haikuthinking |
Claude Haiku 4.5 Thinking | false |
unknown | unavailable |
2026-08-05T23:40:05.034769Z |
pplx_kimik2thinking |
moonshot/kimik2thinking |
Kimi K2 | false |
unknown | available |
2026-08-05T23:40:08.660424Z |
pplx_kimik25thinking |
moonshot/kimik25thinking |
Kimi K2.5 Thinking | false |
unknown | available |
2026-08-05T23:40:11.576027Z |
pplx_grok4 |
x-ai/grok4 |
Grok 4 | false |
unknown | available |
2026-08-05T23:40:14.422712Z |
pplx_grok4nonthinking |
x-ai/grok4nonthinking |
Grok 4 | false |
unknown | available |
2026-08-05T23:40:17.401221Z |
pplx_grok41reasoning |
x-ai/grok41reasoning |
Grok 4.1 | false |
unknown | available |
2026-08-05T23:35:53.563433Z |
pplx_grok41nonreasoning |
x-ai/grok41nonreasoning |
Grok 4.1 | false |
unknown | available |
2026-08-05T23:35:56.433394Z |
pplx_o4mini |
openai/o4mini |
o4-mini | false |
unknown | available |
2026-08-05T23:35:59.335468Z |
pplx_o3pro |
openai/o3pro |
o3-pro | false |
unknown | available |
2026-08-05T23:36:02.896320Z |
Custom tool
pplx_custom accepts an arbitrary custom:<identifier> model and requires explicit risky-model acknowledgement.
All tools support source_focus: web, academic, social, finance, all