{"id":"thetom42-perplexica-mcp","name":"perplexica-mcp","homepage":null,"repo_url":"https://github.com/thetom42/perplexica-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","model-context-protocol","perplexica","search","python","fastmcp","stdio","sse","streamable-http","docker"],"what_it_does":"Provides an MCP server (via FastMCP) that exposes a Perplexica-backed search tool to MCP clients. Supports multiple MCP transport modes: stdio, SSE, and Streamable HTTP (with Docker deployment options).","use_cases":["Enable MCP-compatible IDE/desktop tools to perform Perplexica search from within workflows","Web/academic/discussion search via a unified MCP tool interface","Self-hosted deployment of Perplexica search accessible to various MCP clients","Prototype and production use with containerized SSE/HTTP transports"],"not_for":["Use cases that require a dedicated/authenticated API surface with OAuth for the MCP server itself (it appears to rely on Perplexica backend configuration)","Environments that cannot provide the required Perplexica backend URL and model/provider env vars","Apps needing first-class pagination or cursor-style result APIs (not described)"],"best_when":"You want a drop-in MCP server that bridges MCP clients to a self-hosted Perplexica search backend using stdio (most compatible) or SSE/HTTP for networked use.","avoid_when":"You need strict rate-limit guarantees, strong end-user auth, or documented error codes/retry semantics at the MCP tool level (not evidenced in the provided content).","alternatives":["Use Perplexica directly via its own REST API (if available) rather than MCP","Build a lightweight MCP wrapper around the Perplexica search endpoint (custom)","Use an existing Perplexica/MCP community integration (if available)","Use an MCP server that directly supports search for your specific content sources"],"af_score":60.2,"security_score":38.2,"reliability_score":31.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:23:55.328681+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":"http://localhost:3001/sse (SSE) or http://localhost:3002/mcp/ (Streamable HTTP; server URL varies by transport)","has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["None documented for the MCP server itself; relies on backend access via PERPLEXICA_BACKEND_URL and model provider environment configuration"],"oauth":false,"scopes":false,"notes":"No authentication mechanism for the MCP server is described. Environment variables are used to connect to the Perplexica backend and configure model providers."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Pricing not mentioned; likely costs depend on Perplexica backend and underlying model providers (e.g., OpenAI/others) configured via environment variables."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.2,"security_score":38.2,"reliability_score":31.2,"mcp_server_quality":78.0,"documentation_accuracy":72.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":10.0,"tls_enforcement":55.0,"auth_strength":20.0,"scope_granularity":10.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"Uses HTTPS/TLS is not explicitly documented; deployments may expose SSE/HTTP endpoints without guidance on TLS. No authentication/authorization for the MCP server is described (likely relies on network controls and the Perplexica backend). Environment variables are used for backend URL and model provider names; no explicit guidance on secret storage/logging is provided in the excerpt. Dependencies include fastmcp, httpx, and python-dotenv, but no vulnerability status is provided.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":40.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Misconfiguration risk: required PERPLEXICA_BACKEND_URL and model provider/name env vars may not be set, causing connection/model initialization failures.","Transport mismatch: some MCP clients expect stdio configuration; SSE/HTTP require separate server startup and different client settings.","No documented retry/idempotency guidance at the tool level; agents may need to implement safe retries themselves if desired.","As a bridge to Perplexica, runtime errors may originate from Perplexica/backend dependencies rather than the MCP wrapper."]}}