Skip to content

Commit 2011e91

Browse files
Merge pull request #122 from rbuchmayer-pplx/agent-api-migration
Move model-backed tools from Sonar models to Agent API presets (v1.0.0)
2 parents 29e6ab5 + 4bcc433 commit 2011e91

11 files changed

Lines changed: 1368 additions & 1006 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@
66
},
77
"metadata": {
88
"description": "Official Perplexity AI plugin providing real-time web search, reasoning, and research capabilities",
9-
"version": "0.9.0"
9+
"version": "1.0.0"
1010
},
1111
"plugins": [
1212
{
1313
"name": "perplexity",
1414
"source": "./",
1515
"description": "Real-time web search, reasoning, and research through Perplexity's API",
16-
"version": "0.9.0",
16+
"version": "1.0.0",
1717
"author": {
1818
"name": "Perplexity AI",
1919
"email": "api@perplexity.ai"

README.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,26 +8,24 @@
88
 
99
[![npm version](https://img.shields.io/npm/v/%40perplexity-ai%2Fmcp-server?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@perplexity-ai/mcp-server)
1010

11-
The official MCP server implementation for the Perplexity API Platform, providing AI assistants with real-time web search, reasoning, and research capabilities through Sonar models and the Search API.
11+
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.
1212

1313
## Available Tools
1414

1515
### **perplexity_search**
1616
Direct web search using the Perplexity Search API. Returns ranked search results with metadata, perfect for finding current information.
1717

1818
### **perplexity_ask**
19-
General-purpose conversational AI with real-time web search using the `sonar-pro` model. Great for quick questions and everyday searches.
19+
General-purpose conversational AI with real-time web search, backed by the Agent API `fast` preset. Great for quick questions and everyday searches.
2020

2121
### **perplexity_research**
22-
Deep, comprehensive research using the `sonar-deep-research` model. Ideal for thorough analysis and detailed reports.
22+
Deep, comprehensive research backed by the Agent API `high` preset. Ideal for thorough analysis and detailed reports. Runs can take minutes; the server streams the run and reports progress to clients that request it.
2323

2424
### **perplexity_reason**
25-
Advanced reasoning and problem-solving using the `sonar-reasoning-pro` model. Perfect for complex analytical tasks.
25+
Advanced reasoning and problem-solving backed by the Agent API `medium` preset. Perfect for complex analytical tasks.
2626

27-
> [!TIP]
28-
> Available as an optional parameter for **perplexity_reason** and **perplexity_research**: `strip_thinking`
29-
>
30-
> Set to `true` to remove `<think>...</think>` tags from the response, saving context tokens. Default: `false`
27+
> [!NOTE]
28+
> Presets are managed configurations (model, search setup, step budget) that Perplexity keeps tuned over time; see the [presets guide](https://docs.perplexity.ai/docs/agent-api/presets). Earlier versions of this server called the legacy `sonar-pro`, `sonar-reasoning-pro`, and `sonar-deep-research` models and accepted `strip_thinking` / `reasoning_effort` parameters. Those parameters are no longer part of the tool schemas and are ignored if sent; the Agent API produces no `<think>` tags.
3129
3230
## Configuration
3331

package-lock.json

Lines changed: 6 additions & 6 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@perplexity-ai/mcp-server",
3-
"version": "0.9.0",
3+
"version": "1.0.0",
44
"mcpName": "ai.perplexity/mcp-server",
55
"description": "Real-time web search, reasoning, and research through Perplexity's API",
66
"keywords": [
@@ -49,7 +49,7 @@
4949
"test:coverage": "vitest run --coverage"
5050
},
5151
"dependencies": {
52-
"@modelcontextprotocol/sdk": "^1.21.1",
52+
"@modelcontextprotocol/sdk": "^1.29.0",
5353
"cors": "^2.8.5",
5454
"express": "^4.21.2",
5555
"undici": "^6.20.0",

server.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@
33
"name": "ai.perplexity/mcp-server",
44
"title": "Perplexity API Platform",
55
"description": "Real-time web search, reasoning, and research through Perplexity's API",
6-
"version": "0.9.0",
6+
"version": "1.0.0",
77
"packages": [
88
{
99
"registryType": "npm",
1010
"identifier": "@perplexity-ai/mcp-server",
11-
"version": "0.9.0",
11+
"version": "1.0.0",
1212
"transport": {
1313
"type": "stdio"
1414
}

0 commit comments

Comments
 (0)