From e987639c24355b92b3fa2c692f7524b6a9505b54 Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:19:45 -0700 Subject: [PATCH 1/8] README: point to the hosted remote MCP server --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 553cf62..fbb61f7 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,15 @@ The official MCP server implementation for the Perplexity API Platform, providing AI assistants with real-time web search, reasoning, and research capabilities through the [Agent API](https://docs.perplexity.ai/docs/agent-api/quickstart) and the Search API. +> [!TIP] +> **No install needed:** Perplexity hosts this server as a remote MCP server at `https://api.perplexity.ai/mcp`. Connect over Streamable HTTP with your Perplexity API key and you get the same four tools with no local process to run or update: +> +> ```bash +> claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY" +> ``` +> +> See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for Cursor, VS Code, the Anthropic API, and other clients. + ## Available Tools ### **perplexity_search** @@ -118,7 +127,7 @@ If you'd rather use the standard variables, we support `HTTPS_PROXY` and `HTTP_P ### HTTP Server Deployment -For cloud or shared deployments, run the server in HTTP mode. +For cloud or shared deployments, run the server in HTTP mode. (If you just want a managed HTTP endpoint, Perplexity already hosts one at `https://api.perplexity.ai/mcp`; self-host only when you need your own infrastructure, network policies, or configuration.) #### Environment Variables From 78acbe48bdc0f77fc47a5cfaf625065e8ccc15a5 Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:26:54 -0700 Subject: [PATCH 2/8] README: give the remote server its own section --- README.md | 27 +++++++++++++++++++-------- 1 file changed, 19 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index fbb61f7..730ebd5 100644 --- a/README.md +++ b/README.md @@ -10,14 +10,25 @@ The official MCP server implementation for the Perplexity API Platform, providing AI assistants with real-time web search, reasoning, and research capabilities through the [Agent API](https://docs.perplexity.ai/docs/agent-api/quickstart) and the Search API. -> [!TIP] -> **No install needed:** Perplexity hosts this server as a remote MCP server at `https://api.perplexity.ai/mcp`. Connect over Streamable HTTP with your Perplexity API key and you get the same four tools with no local process to run or update: -> -> ```bash -> claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY" -> ``` -> -> See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for Cursor, VS Code, the Anthropic API, and other clients. +## Remote MCP Server + +[![Install in Cursor](https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https://cursor.com/install-mcp?name=perplexity&config=eyJ1cmwiOiJodHRwczovL2FwaS5wZXJwbGV4aXR5LmFpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciBZT1VSX0FQSV9LRVkifX0%3D) +  +[![Install in VS Code](https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=perplexity&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.perplexity.ai%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Aperplexity-api-key%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22perplexity-api-key%22%2C%22description%22%3A%22Perplexity%20API%20Key%22%2C%22password%22%3Atrue%7D%5D) + +The remote MCP server is hosted by Perplexity and is the easiest way to get started: same four tools, nothing to install or update. Connect over Streamable HTTP with your Perplexity API key: + +``` +https://api.perplexity.ai/mcp +``` + +For Claude Code: + +```bash +claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY" +``` + +See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for manual Cursor/VS Code configuration, usage from the Anthropic API, and other clients. The rest of this README covers running the server locally. ## Available Tools From fa1fe0ad572f6fde89a4d119e3ad999662c1835f Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:32:32 -0700 Subject: [PATCH 3/8] README: apply review fixes to the remote server section --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 730ebd5..fdb7ab9 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Perplexity API Platform MCP Server -[![Install in Cursor](https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https://cursor.com/en/install-mcp?name=perplexity&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwZXJwbGV4aXR5LWFpL21jcC1zZXJ2ZXIiXSwiZW52Ijp7IlBFUlBMRVhJVFlfQVBJX0tFWSI6IiJ9fQ==) +[![Install in Cursor](https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https://cursor.com/install-mcp?name=perplexity&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwZXJwbGV4aXR5LWFpL21jcC1zZXJ2ZXIiXSwiZW52Ijp7IlBFUlBMRVhJVFlfQVBJX0tFWSI6IiJ9fQ==)   [![Install in VS Code](https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=perplexity&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40perplexity-ai%2Fmcp-server%22%5D%2C%22env%22%3A%7B%22PERPLEXITY_API_KEY%22%3A%22%22%7D%7D)   @@ -16,7 +16,7 @@ The official MCP server implementation for the Perplexity API Platform, providin   [![Install in VS Code](https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=perplexity&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.perplexity.ai%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Aperplexity-api-key%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22perplexity-api-key%22%2C%22description%22%3A%22Perplexity%20API%20Key%22%2C%22password%22%3Atrue%7D%5D) -The remote MCP server is hosted by Perplexity and is the easiest way to get started: same four tools, nothing to install or update. Connect over Streamable HTTP with your Perplexity API key: +The remote MCP server is hosted by Perplexity and is the easiest way to get started: same four tools, nothing to install or update. If your MCP client does not support remote servers yet, skip to the local setup in [Configuration](#configuration) below. Connect over Streamable HTTP with your Perplexity API key: ``` https://api.perplexity.ai/mcp @@ -28,7 +28,7 @@ For Claude Code: claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` -See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for manual Cursor/VS Code configuration, usage from the Anthropic API, and other clients. The rest of this README covers running the server locally. +See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for manual Cursor/VS Code configuration, usage from the Anthropic API, and setup for other clients. The rest of this README covers running the server locally. ## Available Tools From 6e3f2688144a977fef34ee054bacbef4fd3a8457 Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:34:30 -0700 Subject: [PATCH 4/8] README: drop redundant hosted-endpoint note from the self-host section --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index fdb7ab9..0ff0879 100644 --- a/README.md +++ b/README.md @@ -138,7 +138,7 @@ If you'd rather use the standard variables, we support `HTTPS_PROXY` and `HTTP_P ### HTTP Server Deployment -For cloud or shared deployments, run the server in HTTP mode. (If you just want a managed HTTP endpoint, Perplexity already hosts one at `https://api.perplexity.ai/mcp`; self-host only when you need your own infrastructure, network policies, or configuration.) +For cloud or shared deployments, run the server in HTTP mode. #### Environment Variables From 4bf5b5380101ca7c749ed7f6556f13728b7dd26a Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:48:24 -0700 Subject: [PATCH 5/8] README: single badge row, top one-clicks now install the remote server --- README.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 0ff0879..53bcb73 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # Perplexity API Platform MCP Server -[![Install in Cursor](https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https://cursor.com/install-mcp?name=perplexity&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwZXJwbGV4aXR5LWFpL21jcC1zZXJ2ZXIiXSwiZW52Ijp7IlBFUlBMRVhJVFlfQVBJX0tFWSI6IiJ9fQ==) +[![Install in Cursor](https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https://cursor.com/install-mcp?name=perplexity&config=eyJ1cmwiOiJodHRwczovL2FwaS5wZXJwbGV4aXR5LmFpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciBZT1VSX0FQSV9LRVkifX0%3D)   -[![Install in VS Code](https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=perplexity&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40perplexity-ai%2Fmcp-server%22%5D%2C%22env%22%3A%7B%22PERPLEXITY_API_KEY%22%3A%22%22%7D%7D) +[![Install in VS Code](https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=perplexity&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.perplexity.ai%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Aperplexity-api-key%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22perplexity-api-key%22%2C%22description%22%3A%22Perplexity%20API%20Key%22%2C%22password%22%3Atrue%7D%5D)   [![Add to Kiro](https://img.shields.io/badge/Add_to_Kiro-9046FF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTkxIiBoZWlnaHQ9IjIyNi44MTQiIHZpZXdCb3g9IjAgMCAxOTEgMjI2LjgxNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cGF0aCBkPSJNMzUuNjA5IDE3My4xNjVjLTIzLjExMSA1MS4yMzUgMjYuMTA2IDY0LjA2OCA2Mi4zOTYgMzQuMTA2IDEwLjY2IDMzLjYwNSA1MC42OTggOC41MzQgNjUuMDU5LTE3LjUxMSAzMS42MzQtNTcuMzgzIDE4Ljg2Mi0xMTUuOTM3IDE1LjU3OS0xMjguMDE3LTIyLjUwMi04Mi4zNTctMTM0LjkyOS04Mi40MjktMTU0LjI4MS40MTgtNC41MjMgMTQuNTA1LTQuNTk1IDMxLjAwMy03LjE2MSA0OC4xMzItMS4yOSA4LjYzMS0yLjE5OCAxNC4xNDUtNS41MzkgMjMuMjMtMS45MjEgNS4yMTgtNC41NTkgOS44NDktOC43MTQgMTcuNjY2LTguMjEzIDEyLjU0NS4xNTUgMzguMiAzMi42NSAyMi4wMDF6IiBmaWxsPSIjZmZmIi8+PHBhdGggZD0iTTEwMi42MDMgOTYuODk4Yy05LjIyOSAwLTEwLjYxMy0xMS4wMzEtMTAuNjEzLTE3LjU5NyAwLTUuOTMyIDEuMDc0LTEwLjY0OSAzLjA2Ny0xMy42NDRhOC41OCA4LjU4IDAgMCAxIDcuNTIxLTMuOTY0YzMuMjM2IDAgNi4wMDQgMS4zNjIgNy45NjEgNC4wMzYgMi4yMDkgMy4wNDUgMy4zOTEgNy43NTkgMy4zOTEgMTMuNTg2IDAgMTEuMDE3LTQuMjM4IDE3LjU5Ny0xMS4zNDEgMTcuNTk3em0zNy45NDggMGMtOS4yNCAwLTEwLjYyNC0xMS4wMzEtMTAuNjI0LTE3LjU5NyAwLTUuOTMyIDEuMDc0LTEwLjY0OSAzLjA4MS0xMy42NDRhOC41OCA4LjU4IDAgMCAxIDcuNTIxLTMuOTY0IDkuNTEgOS41MSAwIDAgMSA3Ljk1IDQuMDM2YzIuMjIgMy4wNDUgMy40MDIgNy43NTkgMy40MDIgMTMuNTg2IDAgMTEuMDE3LTQuMjM4IDE3LjU5Ny0xMS4zNDEgMTcuNTk3eiIgZmlsbD0iIzAwMCIvPlw8L3N2Zz4=&logoColor=white)](https://kiro.dev/launch/mcp/add?name=perplexity&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40perplexity-ai%2Fmcp-server%22%5D%2C%22env%22%3A%7B%22PERPLEXITY_API_KEY%22%3A%22your_key_here%22%7D%7D)   @@ -12,11 +12,7 @@ The official MCP server implementation for the Perplexity API Platform, providin ## Remote MCP Server -[![Install in Cursor](https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white)](https://cursor.com/install-mcp?name=perplexity&config=eyJ1cmwiOiJodHRwczovL2FwaS5wZXJwbGV4aXR5LmFpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciBZT1VSX0FQSV9LRVkifX0%3D) -  -[![Install in VS Code](https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=perplexity&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.perplexity.ai%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Aperplexity-api-key%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22perplexity-api-key%22%2C%22description%22%3A%22Perplexity%20API%20Key%22%2C%22password%22%3Atrue%7D%5D) - -The remote MCP server is hosted by Perplexity and is the easiest way to get started: same four tools, nothing to install or update. If your MCP client does not support remote servers yet, skip to the local setup in [Configuration](#configuration) below. Connect over Streamable HTTP with your Perplexity API key: +The remote MCP server is hosted by Perplexity and is the easiest way to get started: same four tools, nothing to install or update. The Cursor and VS Code buttons at the top of this page connect to it with one click. If your MCP client does not support remote servers yet, skip to the local setup in [Configuration](#configuration) below. Connect over Streamable HTTP with your Perplexity API key: ``` https://api.perplexity.ai/mcp From e23641ddd6091a1a038c4764231838e0e2beb7fe Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:50:06 -0700 Subject: [PATCH 6/8] README: same tools --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 53bcb73..7c21259 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ The official MCP server implementation for the Perplexity API Platform, providin ## Remote MCP Server -The remote MCP server is hosted by Perplexity and is the easiest way to get started: same four tools, nothing to install or update. The Cursor and VS Code buttons at the top of this page connect to it with one click. If your MCP client does not support remote servers yet, skip to the local setup in [Configuration](#configuration) below. Connect over Streamable HTTP with your Perplexity API key: +The remote MCP server is hosted by Perplexity and is the easiest way to get started: same tools, nothing to install or update. The Cursor and VS Code buttons at the top of this page connect to it with one click. If your MCP client does not support remote servers yet, skip to the local setup in [Configuration](#configuration) below. Connect over Streamable HTTP with your Perplexity API key: ``` https://api.perplexity.ai/mcp From 7e93ad5221f778c4ae4209ad80a514bb7e00ac02 Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:53:48 -0700 Subject: [PATCH 7/8] README: scope the local-setup handoff to the Configuration section --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7c21259..04a5138 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ For Claude Code: claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` -See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for manual Cursor/VS Code configuration, usage from the Anthropic API, and setup for other clients. The rest of this README covers running the server locally. +See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for manual Cursor/VS Code configuration, usage from the Anthropic API, and setup for other clients. Everything from [Configuration](#configuration) down covers running the server locally. ## Available Tools From dab2fd30d0890c6b10ec9a1cc3b5d120e26cbb3a Mon Sep 17 00:00:00 2001 From: Ryan Buchmayer Date: Thu, 30 Jul 2026 13:55:35 -0700 Subject: [PATCH 8/8] README: drop the local-setup handoff sentence --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 04a5138..1158b2e 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ For Claude Code: claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` -See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for manual Cursor/VS Code configuration, usage from the Anthropic API, and setup for other clients. Everything from [Configuration](#configuration) down covers running the server locally. +See the [MCP integration docs](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server) for manual Cursor/VS Code configuration, usage from the Anthropic API, and setup for other clients. ## Available Tools