The only Perplexity MCP server with multi-account pooling, an admin dashboard, and zero-cost monitoring. No API keys. No per-query fees. Uses your existing Perplexity Pro session.
Features · Quick Start · Admin Panel · ·
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
The only Perplexity MCP server with multi-account pooling, an admin dashboard, and zero-cost monitoring. No API keys. No per-query fees. Uses your existing Perplexity Pro session.
Features · Quick Start · Admin Panel · ·
Free Perplexity AI MCP server with multi-account pooling, React admin dashboard, zero-cost health monitoring, and Telegram alerts. No API keys needed.
Most Perplexity MCP servers are single-account wrappers around the paid Sonar API. This one is different:
sonar · gpt-5.2 · claude-4.5-sonnet · grok-4.1gpt-5.2-thinking · claude-4.5-sonnet-thinkinggemini-3.0-pro · kimi-k2-thinking · grok-4.1-reasoningpool_state.jsonStats grid, monitor controls, sortable token table with per-account quotas (Pro / Research / Agentic), filter pills, and one-click actions.
Live log streaming with auto-refresh, level filtering, search highlighting, follow mode, and line numbers.
git clone https://github.com/teoobarca/perplexity-mcp.git
cd perplexity-mcp
uv sync
claude mcp add perplexity -s user -- uv --directory /path/to/perplexity-mcp run perplexity-mcp
Go to Settings → MCP → Add new server and paste:
{
"command": "uv",
"args": ["--directory", "/path/to/perplexity-mcp", "run", "perplexity-mcp"]
}
Add to your MCP config file:
{
"mcpServers": {
"perplexity": {
"command": "uv",
"args": ["--directory", "/path/to/perplexity-mcp", "run", "perplexity-mcp"]
}
}
}
That's it. Works immediately with anonymous sessions. Add your tokens for Pro access — see Authentication.
Two MCP tools with LLM-optimized descriptions so your AI assistant picks the right one automatically:
perplexity_askAI-powered answer engine for tech questions, documentation lookups, and how-to guides.
Mode auto-detection: Models with thinking or reasoning in the name automatically switch to Reasoning mode.
"gpt-5.2" → Pro Search
"gpt-5.2-thinking" → Reasoning Mode ← auto-detected
perplexity_researchDeep research agent for comprehensive analysis. Returns extensive reports with 10-30+ citations.
[!TIP] Deep research takes 2-5 minutes per query. Provide detailed context and constraints for better results. The server has a 15-minute timeout to accommodate this.
A built-in web dashboard for managing your token pool. Start it with:
perplexity-server
Opens automatically at http://localhost:8123/admin/
By default, the server uses anonymous Perplexity sessions (rate limited). For Pro access, add your session tokens.
next-auth.csrf-tokennext-auth.session-tokenCreate token_pool_config.json in the project root:
{
"tokens": [
{
"id": "my-account",
"csrf_token": "your-csrf-token-here",
"session_token": "your-session-token-here"
}
]
}
Add multiple accounts for round-robin rotation with automatic failover:
{
"monitor": {
"enable": true,
"interval": 6,
"tg_bot_token": "optional-telegram-bot-token",
"tg_chat_id": "optional-chat-id"
},
"fallback": {
"fallback_to_auto": true
},
"tokens": [
{ "id": "account-1", "csrf_token": "...", "session_token": "..." },
{ "id": "account-2", "csrf_token": "...", "session_token": "..." },
{ "id": "account-3", "csrf_token": "...", "session_token": "..." }
]
}
[!NOTE] Session tokens last ~30 days. The monitor detects expired tokens and alerts you via Telegram.
Token state is computed automatically from session_valid + rate_limits (never set manually):
When a Pro request fails, the server tries progressively:
1. ✅ Next client with Pro quota (round-robin)
2. ✅ Next client with Pro quota ...
3. 🟡 Any available client (auto mode)
4. 🔵 Anonymous session (auto mode)
5. ❌ Error returned to caller
┌─────────────────────────────────────────────────────────┐
│ Your AI Assistant (Claude Code / Cursor / Windsurf) │
└──────────────────────┬──────────────────────────────────┘
│ MCP (stdio)
▼
┌──────────────────────────────────────────────────────────┐
│ perplexity-mcp │
│ ┌────────────────┐ ┌────────────────────────────────┐ │
│ │ tools.py │ │ server.py │ │
│ │ • ask │──│ • Pool state sync │ │
│ │ • research │ │ • Timeout handling │ │
│ └────────────────┘ └────────────────────────────────┘ │
└──────────────────────┬───────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────┐
│ Backend Engine (perplexity/) │
│ │
│ ┌─────────────┐ ┌──────────────┐ ┌────────────────┐ │
│ │ client.py │ │ client_pool │ │ admin.py │ │
│ │ • Search │ │ • Rotation │ │ • REST API │ │
│ │ • Upload │ │ • Backoff │ │ • Static │ │
│ │ • Validate │ │ • Monitor │ │ files │ │
│ └──────┬───────┘ │ • Fallback │ └────────┬───────┘ │
│ │ └──────────────┘ │ │
│ ▼ ▼ │
│ ┌─────────────┐ ┌────────────────┐ │
│ │ Perplexity │ │ React Admin UI │ │
│ │ (web API) │ │ :8123/admin/ │ │
│ └─────────────┘ └────────────────┘ │
└──────────────────────────────────────────────────────────┘
# Install in development mode
uv pip install -e ".[dev]" --python .venv/bin/python
# Run unit tests (53 tests)
.venv/bin/python -m pytest tests/ -v
# Frontend development
cd perplexity/server/web
npm install
npm run dev # Dev server with proxy to :8123
npm run build # Production build
src/ # MCP stdio server (thin wrapper)
server.py # Entry point, pool state sync
tools.py # Tool definitions
perplexity/ # Backend engine
client.py # Perplexity API client (curl_cffi)
config.py # Constants, endpoints, model mappings
exceptions.py # Custom exception hierarchy
logger.py # Centralized logging
server/
app.py # Starlette app, query engine
client_pool.py # ClientPool, rotation, monitor
admin.py # Admin REST API
utils.py # Validation helpers
main.py # HTTP server entry point
web/ # React admin frontend (Vite + Tailwind)
tests/ # 53 unit tests
Free Perplexity AI MCP server with multi-account pooling, React admin dashboard, zero-cost health monitoring, and Telegram alerts. No API keys needed.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Perplexity 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 Free Perplexity AI MCP server with multi-account pooling, React admin dashboard, zero-cost health monitoring, and Telegram alerts. No API keys needed.