[{"_1":2,"_287":-5,"_288":-5},"loaderData",{"_3":4,"_53":54,"_55":56,"_232":233},"root",{"_5":6,"_49":50,"_51":52},"appGlobal",{"_7":8,"_38":39,"_40":41},"config",{"_9":10,"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":-5,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":31,"_35":31,"_36":37},"APP_URL","https://glama.ai","CLIENT_ASSETS_URL","https://static.glama.ai/client/","ENVIRONMENT","LIVE","FACEBOOK_PIXEL_ID","1988603181578092","GOOGLE_ANALYTICS_MEASUREMENT_ID","G-GDQ5NW5CB5","GOOGLE_OAUTH2_CLIENT_ID","48173796263-7ohlqirg28gh2a7nel61coff3m1ogjtc.apps.googleusercontent.com","INTERCOM_APP_ID","wgcqevfz","INTERCOM_USER_HASH","POSTHOG_API_KEY","phc_aK0RnJxBEBRE0h0LIz21yyc9w6ylBxwUHMPB4712Bjc","REDDIT_PIXEL_ID","a2_fcqsoymvje51","RELEASE_VERSION","glama@production","SENTRY_DRY_RUN",false,"SENTRY_DSN","https://fc82aa9f808b13927ff29c56bda4d486@o4507975513735168.ingest.us.sentry.io/4507975514849280","SENTRY_SPOTLIGHT","SENTRY_TRACE","STRIPE_PUBLIC_KEY","pk_live_51QpZQ32LV3sZcHqzHlFuNhgSfggSNaQqCzZw9EMJ8tbhpQyZgcwQj1vz168FxQ35EGRcztKu2MankxiSs7zLCF4g00blUverGs","viewportWidth",1280,"visitorSession",{"_42":43,"_45":-5,"_46":47,"_48":-5},"attributes",[44],"BOT","membership","uid","9ep8cox7ot","userAccount","nonce","3175fdeaf1f1f35b62833a8d2366b20a","toasts",[],"routes/_public/_layout",{},"routes/_public/mcp/servers/~uid/_pages/_layout",{"_57":-5,"_58":59,"_150":151},"githubUser","mcpServer",{"_60":61,"_62":63,"_42":84,"_87":88,"_89":88,"_90":91,"_96":97,"_119":120,"_121":31,"_115":122,"_123":-5,"_124":-5,"_125":126,"_133":-5,"_134":135,"_140":-5,"_141":142,"_146":-5,"_46":147,"_148":149},"addedAt",["D",1738860516508],"argumentsJsonSchema",{"_64":65,"_66":67,"_69":70},"type","object","required",[68],"PERPLEXITY_API_KEY","properties",{"_71":72,"_68":76,"_78":79,"_81":82},"PERPLEXITY_MODEL",{"_64":73,"_74":75},"string","description","The Perplexity model to use (optional, defaults to the server's default model).",{"_64":73,"_74":77},"Your Perplexity API key.","PERPLEXITY_MODEL_ASK",{"_64":73,"_74":80},"Overrides PERPLEXITY_MODEL for the ask_perplexity tool.","PERPLEXITY_MODEL_CHAT",{"_64":73,"_74":83},"Overrides PERPLEXITY_MODEL for the chat_perplexity tool.",[85,86],"category:other","language:python","descriptionMarkdown","MCP Server for the Perplexity API.","descriptionPlainText","githubProject",{"_92":93,"_94":95},"readme","# Perplexity Chat MCP Server\n\nThe Perplexity MCP Server provides a Python-based interface to the Perplexity API, offering tools for querying responses, maintaining chat history, and managing conversations. It supports model configuration via environment variables and stores chat data locally. Built with Hatch, it's designed for integration with development environments.\n\nThe MCP Server is desined to mimick how users interact with the Perplexity Chat on their browser by allowing your models to ask questions, continue conversations, and list all your chats.\n\n[![smithery badge](https://smithery.ai/badge/@daniel-lxs/mcp-perplexity)](https://smithery.ai/server/@daniel-lxs/mcp-perplexity) [![Release and Publish](https://github.com/daniel-lxs/mcp-perplexity/actions/workflows/release.yml/badge.svg)](https://github.com/daniel-lxs/mcp-perplexity/actions/workflows/release.yml)\n\n\n\n\n

\n\n\n## Components\n\n### Tools\n\n- **ask_perplexity**: Request expert programming assistance through Perplexity. Focuses on coding solutions, error debugging, and technical explanations. Returns responses with source citations and alternative suggestions.\n- **chat_perplexity**: Maintains ongoing conversations with Perplexity AI. Creates new chats or continues existing ones with full history context. Returns chat ID for future continuation.\n- **list_chats_perplexity**: Lists all available chat conversations with Perplexity AI. Returns chat IDs, titles, and creation dates (displayed in relative time format, e.g., \"5 minutes ago\", \"2 days ago\"). Results are paginated with 50 chats per page.\n- **read_chat_perplexity**: Retrieves the complete conversation history for a specific chat. Returns the full chat history with all messages and their timestamps. No API calls are made to Perplexity - this only reads from local storage.\n\n## Key Features\n\n- **Model Configuration via Environment Variable:** Allows you to specify the Perplexity model using the `PERPLEXITY_MODEL` environment variable for flexible model selection.\n\n You can also specify `PERPLEXITY_MODEL_ASK` and `PERPLEXITY_MODEL_CHAT` to use different models for the `ask_perplexity` and `chat_perplexity` tools, respectively.\n\n These will override `PERPLEXITY_MODEL`. You can check which models are available on the [Perplexity](https://docs.perplexity.ai/guides/model-cards) documentation.\n- **Persistent Chat History:** The `chat_perplexity` tool maintains ongoing conversations with Perplexity AI. Creates new chats or continues existing ones with full history context. Returns chat ID for future continuation.\n- **Streaming Responses with Progress Reporting:** Uses progress reporting to prevent timeouts on slow responses.\n\n## Quickstart\n\n### Prerequisites\n\nBefore using this MCP server, ensure you have:\n\n- Python 3.10 or higher\n- [uvx](https://docs.astral.sh/uv/#installation) package manager installed\n\nNote: Installation instructions for uvx are available [here](https://docs.astral.sh/uv/#installation).\n\n### Configuration for All Clients\n\nTo use this MCP server, configure your client with these settings (configuration method varies by client):\n\n```json\n\"mcpServers\": {\n \"mcp-perplexity\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-perplexity\"],\n \"env\": {\n \"PERPLEXITY_API_KEY\": \"your-api-key\",\n \"PERPLEXITY_MODEL\": \"sonar-pro\",\n \"DB_PATH\": \"chats.db\"\n }\n }\n}\n```\n\n**Key Configuration Notes:**\n- Replace `\"your-api-key\"` with your Perplexity API key\n- Environment variables can specify different models for ask/chat tools\n- `DB_PATH` sets custom chat history location (default: chats.db)\n\n### Cursor IDE Installation Helpers\n\nFor Cursor users, we provide automated scripts that:\n\n1. Install uvx (Python package manager) if missing\n2. Set up the `mcp-starter` helper tool\n3. Generate appropriate Cursor command to be added to the MCP settings.\n\n

Windows Installation

\n\n1. Download the `install.ps1` script\n2. Open PowerShell as Administrator\n3. Allow script execution and run:\n```powershell\nSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force\n.\\install.ps1\n```\n\nThe script will:\n- Check for required dependencies (curl, PowerShell)\n- Install uvx if not present\n- Install mcp-starter to `%USERPROFILE%\\.local\\bin`\n- Create a configuration file at `%USERPROFILE%\\.config\\mcp-starter\\config.json`\n- Prompt for your Perplexity API key and model preferences\n

\n\n

Unix Installation (Linux/MacOS)

\n\n1. Download the `install.sh` script\n2. Open Terminal\n3. Navigate to the directory containing the script\n4. Make the script executable and run it:\n```bash\nchmod +x install.sh # Only needed if downloaded directly from browser\n./install.sh\n```\n\nThe script will:\n- Check for required dependencies (curl)\n- Install uvx if not present\n- Install mcp-starter to `$HOME/.local/bin`\n- Create a configuration file at `$HOME/.config/mcp-starter/config.json`\n- Prompt for your Perplexity API key and model preferences\n

\n\n#### Using Smithery CLI (Cursor Only)\n```bash\nnpx -y @smithery/cli@latest run @daniel-lxs/mcp-perplexity --config \"{\\\"perplexityApiKey\\\":\\\"pplx-abc\\\",\\\"perplexityModel\\\":\\\"sonar-pro\\\"}\"\n```\n\n## Usage\n\n### ask_perplexity\n\nThe `ask_perplexity` tool is used for specific questions, this tool doesn't maintain a chat history, every request is a new chat.\n\nThe tool will return a response from Perplexity AI using the `PERPLEXITY_MODEL_ASK` model if specified, otherwise it will use the `PERPLEXITY_MODEL` model.\n\n### chat_perplexity\n\nThe `chat_perplexity` tool is used for ongoing conversations, this tool maintains a chat history.\nA chat is identified by a chat ID, this ID is returned by the tool when a new chat is created. Chat IDs look like this: `wild-horse-12`.\n\nThis tool is useful for debugging, research, and any other task that requires a chat history.\n\nThe tool will return a response from Perplexity AI using the `PERPLEXITY_MODEL_CHAT` model if specified, otherwise it will use the `PERPLEXITY_MODEL` model.\n\n### list_chats_perplexity\nLists all available chat conversations. It returns a paginated list of chats, showing the chat ID, title, and creation time (in relative format). You can specify the page number using the `page` argument (defaults to 1, with 50 chats per page).\n\n### read_chat_perplexity\nRetrieves the complete conversation history for a given `chat_id`. This tool returns all messages in the chat, including timestamps and roles (user or assistant). This tool does *not* make any API calls to Perplexity; it only reads from the local database.\n\n\n## Development\n\nThis project uses [Hatch](https://hatch.pypa.io/latest/) for development and builds. To get started:\n\n1. Install Hatch (if not already installed):\n ```bash\n pip install hatch\n ```\n\n2. Create and activate the Hatch environment:\n ```bash\n hatch env create\n hatch shell\n ```\n\n3. Build the project:\n ```bash\n hatch build\n ```\n\nThe Hatch environment will automatically install all required dependencies.\n\n## Contributing\n\nThis project is open to contributions. Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for more information.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n\n\n\n","url","https://github.com/daniel-lxs/mcp-perplexity","githubRepository",{"_98":99,"_100":101,"_102":-5,"_103":104,"_105":106,"_111":112,"_113":114,"_117":118},"defaultBranch","main","fullName","daniel-lxs/mcp-perplexity","githubTreeId","language","Python","owner",{"_107":108,"_109":110},"login","daniel-lxs","verified",true,"recentStargazers",6,"spdxLicense",{"_115":116},"name","MIT License","stargazers",24,"id",875,"inspectable","mcp-perplexity","npmPackage","prompts","relatedMcpServerIds",[127,128,129,130,131,132],305,826,490,873,717,472,"resources","scores",{"_136":137,"_138":-5,"_139":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[143,144,145],"WINDOWS","LINUX","MACOS","tools","0nggjl0ohi","updatedAt",["D",1740226320686],"meta",[152,155,157,164,167,169,172,175,178,181,184,186,189,192,194,196,198,200,202],{"_153":154},"title","mcp-perplexity | Glama",{"_156":88,"_115":74},"content",{"_158":159,"_160":161,"_162":163},"href","https://glama.ai/mcp/servers/0nggjl0ohi","rel","canonical","tagName","link",{"_156":122,"_165":166},"property","og:title",{"_156":88,"_165":168},"og:description",{"_156":170,"_165":171},"https://glama.ai/logo.png","og:logo",{"_156":173,"_165":174},"https://glama.ai/mcp/servers/0nggjl0ohi/og-image","og:image",{"_156":176,"_165":177},"630","og:image:height",{"_156":179,"_165":180},"1200","og:image:width",{"_156":182,"_165":183},"website","og:type",{"_156":159,"_165":185},"og:url",{"_156":187,"_165":188},"ChatGPT alternative for power users","og:site_name",{"_156":190,"_115":191},"summary_large_image","twitter:card",{"_156":187,"_115":193},"twitter:title",{"_156":88,"_115":195},"twitter:description",{"_156":173,"_115":197},"twitter:image",{"_156":176,"_115":199},"twitter:image:height",{"_156":179,"_115":201},"twitter:image:width",{"_203":204},"script:ld+json",{"_205":206,"_207":208},"@context","http://schema.org","@graph",[209],{"_205":210,"_211":212,"_213":214},"https://schema.org","@type","BreadcrumbList","itemListElement",[215,222,226,230],{"_211":216,"_217":218,"_115":219,"_220":221},"ListItem","item","https://glama.ai/","Glama","position",1,{"_211":216,"_217":223,"_115":224,"_220":225},"https://glama.ai/mcp","MCP",2,{"_211":216,"_217":227,"_115":228,"_220":229},"https://glama.ai/mcp/servers","Servers",3,{"_211":216,"_217":159,"_115":122,"_220":231},4,"routes/_public/mcp/servers/~uid/_pages/reviews/_route",{"_57":-5,"_58":234,"_150":252,"_286":-5},{"_60":235,"_62":236,"_42":243,"_87":88,"_89":88,"_90":244,"_96":245,"_119":120,"_121":31,"_115":122,"_123":-5,"_124":-5,"_125":248,"_133":-5,"_134":249,"_140":-5,"_141":250,"_146":-5,"_46":147,"_148":251},["D",1738860516508],{"_64":65,"_66":237,"_69":238},[68],{"_71":239,"_68":240,"_78":241,"_81":242},{"_64":73,"_74":75},{"_64":73,"_74":77},{"_64":73,"_74":80},{"_64":73,"_74":83},[85,86],{"_92":93,"_94":95},{"_98":99,"_100":101,"_102":-5,"_103":104,"_105":246,"_111":112,"_113":247,"_117":118},{"_107":108,"_109":110},{"_115":116},[127,128,129,130,131,132],{"_136":137,"_138":-5,"_139":-5},[143,144,145],["D",1740226320686],[253,255,256,258,260,261,262,263,264,265,266,267,268,269,270,271,272,273,274],{"_153":254},"Reviews | mcp-perplexity | Glama",{"_156":88,"_115":74},{"_158":257,"_160":161,"_162":163},"https://glama.ai/mcp/servers/0nggjl0ohi/reviews",{"_156":259,"_165":166},"Reviews | mcp-perplexity",{"_156":88,"_165":168},{"_156":170,"_165":171},{"_156":173,"_165":174},{"_156":176,"_165":177},{"_156":179,"_165":180},{"_156":182,"_165":183},{"_156":257,"_165":185},{"_156":187,"_165":188},{"_156":190,"_115":191},{"_156":187,"_115":193},{"_156":88,"_115":195},{"_156":173,"_115":197},{"_156":176,"_115":199},{"_156":179,"_115":201},{"_203":275},{"_205":206,"_207":276},[277],{"_205":210,"_211":212,"_213":278},[279,280,281,282,283],{"_211":216,"_217":218,"_115":219,"_220":221},{"_211":216,"_217":223,"_115":224,"_220":225},{"_211":216,"_217":227,"_115":228,"_220":229},{"_211":216,"_217":159,"_115":122,"_220":231},{"_211":216,"_217":257,"_115":284,"_220":285},"Reviews",5,"review","actionData","errors"]

Rate & Review