perplexity-mcp-server

MCP-Server für strukturierte Workflows zur Wettbewerbs- und Marktbeobachtung (Competitive/Market Intelligence) auf Basis der Perplexity Sonar API.

Korrektur (2026-08-26): Eine frühere Version dieser README behauptete, es gäbe nirgendwo einen nativen Perplexity-MCP-Connector. Das war falsch — Perplexity veröffentlicht einen offiziellen MCP-Server (github.com/perplexityai/modelcontextprotocol), einschließlich eines von Perplexity gehosteten Remote-Endpunkts unter https://api.perplexity.ai/mcp, der aus einer in der Cloud geplanten Sitzung ohne eigenes Hosting erreichbar ist. Wenn Sie nur generische Ad-hoc-Suche mit Sonar benötigen, registrieren Sie diesen, anstatt hier etwas zu bauen oder auszuführen.

Was der offizielle Server nicht bietet, ist eine strukturierte, vergleichbare wöchentliche Marktbeobachtungs-Ausgabe: Er stellt generische Such-/Reasoning-Funktionen bereit (Agent API, Search API), aber keinen Kurzbericht über ein Unternehmen mit festen Abschnitten oder einen durch JSON-Schema eingeschränkten Signal-Sweep. Das ist der eigentliche Grund für die Existenz dieses Servers — er ist eine dünne, schmale Schicht aus zwei Workflow-Tools, kein Ersatz für Perplexitys eigenen MCP-Server.

Stellen Sie dies einmal bereit (siehe „Remote-Bereitstellung“ unten) mit PERPLEXITY_API_KEY als Plattform-Secret, und jeder MCP-Client — einschließlich einer in der Cloud geplanten Cowork/Claude-Sitzung — kann es über HTTP aufrufen, ohne jemals die lokale Maschine oder eine Device-Bridge zu berühren. Registrieren Sie es zusätzlich zum offiziellen Perplexity-Server, nicht an seiner Stelle.

Tools

• perplexity_company_news — strukturierter Unternehmens-Kurzbericht (Unternehmensführung, Führungskräfte, strategische Ereignisse, Finanzlage, Personalbewegungen), feste Abschnittsüberschriften, lookback_days statt Freitext-Datumsbereichen.

• perplexity_market_signals — branchenweiter Signal-Sweep (M&A, Finanzierungen, Ernennungen, Umstrukturierungen), serverseitig auf ein JSON-Schema eingeschränkt, sodass das Ergebnis ein echtes Array diskreter Signale ist und kein Markdown, das erneut geparst werden muss. Gibt ein leeres Array zurück (keinen Fehler), wenn für den Zeitraum nichts Datierbares und Verlässliches gefunden wird — das ist ein aussagekräftiges Ergebnis, kein Fehlschlag.

Beide Tools unterstützen response_format: "markdown" | "json" und geben Zitate/Quellen zurück. Für allgemeine Suche verwenden Sie stattdessen Perplexitys offiziellen MCP-Server — siehe die Korrektur oben.

Related MCP server: Stelar Signals MCP

Einrichtung

npm install
cp .env.example .env   # then set PERPLEXITY_API_KEY
npm run build

Lokale Verwendung (stdio) — Schnellstart, behebt das Cloud-Scheduling-Problem NICHT

Gut zum Testen oder für jeden Workflow, der bereits auf Ihrer eigenen Maschine läuft. Registrieren Sie es in der Konfiguration Ihres MCP-Clients (z. B. der claude_desktop_config.json von Claude Desktop):

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/absolute/path/to/perplexity-mcp-server/dist/index.js"],
      "env": { "PERPLEXITY_API_KEY": "pplx-..." }
    }
  }
}

Das bindet die Verfügbarkeit weiterhin daran, dass diese Maschine eingeschaltet ist — es löst nicht das ursprüngliche Problem, dass eine in der Cloud geplante Aufgabe den Schlüssel benötigt. Verwenden Sie dafür die HTTP-Bereitstellung unten.

Remote-Bereitstellung (streamable HTTP) — die eigentliche Lösung für cloud-geplante Aufgaben

Führen Sie denselben Code mit TRANSPORT=http auf einem beliebigen Node-fähigen Host aus (ein kleiner VPS, Render, Railway, Fly.io, ein Container bei jedem Cloud-Anbieter). Die einzigen Anforderungen sind: Node 18+, die Möglichkeit, ein Secret als Umgebungsvariable zu setzen, und eine öffentliche HTTPS-URL.

PERPLEXITY_API_KEY=pplx-... TRANSPORT=http PORT=3000 npm start

Der Server stellt bereit:

• POST /mcp — der MCP-Endpunkt (streamable HTTP, zustandsloses JSON — ein neuer Server+Transport pro Anfrage, sodass nichts zwischen den Aufrufen durchsickert und es ohne geteilten Zustand horizontal skaliert)

• GET /health — einfacher Liveness-Check für den Health-Probe Ihrer Hosting-Plattform

Sobald es hinter HTTPS bereitgestellt ist (https://your-host/mcp), registrieren Sie diese URL im Workspace als Remote-MCP-Connector, damit die Perplexity-abhängige geplante Aufgabe ihn direkt erreichen kann, wobei der Schlüssel serverseitig liegt — dasselbe Betriebsmodell, das Pappers bereits verwendet (nativer Connector, kein lokales Secret im Credential-Pfad).

Was in diesem Build verifiziert wurde

• npm run build kompiliert sauber (strenges TypeScript, kein any).

• Beide Transports starten ohne Absturz (stdio und HTTP).

• GET /health antwortet korrekt.

• Der vollständige MCP-Handshake (initialize, tools/list) gibt beide Tools mit korrekten JSON-Schemas, Beschreibungen und Annotationen zurück.

• tools/call mit einem ungültigen API-Schlüssel liefert ein sauberes, umsetzbares Ergebnis mit isError: true (401-Hinweis, der auf das Perplexity-Dashboard verweist) — der Server stürzt nicht ab und bleibt danach ansprechbar.

Was noch NICHT verifiziert wurde

In der Build-Umgebung stand kein echtes PERPLEXITY_API_KEY zur Verfügung, daher wurde ein tatsächlich erfolgreicher Sonar-Aufruf — echte Antwortinhalte, echte Zitate, die per JSON-Schema eingeschränkte market_signals-Antwort, die tatsächlich als gültiges JSON geparst wird — nicht Ende-zu-Ende getestet. Bevor Sie sich in der Produktions-Marktbeobachtungsroutine darauf verlassen, führen Sie jedes der beiden Tools einmal mit einem echten Schlüssel aus (lokal über stdio genügt für diesen Check) und bestätigen Sie, dass die Ausgabe mit den oben dokumentierten Strukturen übereinstimmt.

Kostenhinweis

perplexity_company_news und perplexity_market_signals verwenden standardmäßig beide das sonar-pro-Modell (tiefere Suche, mehr Quellen, höhere Kosten pro Aufruf als sonar), weil der Marktbeobachtungs-Anwendungsfall Vollständigkeit und Zitierqualität über Latenz/Kosten stellt — das ist die bewusste Standardeinstellung für beide Tools dieses Servers, bestätigt am 2026-08-26. Es gibt hier kein perplexity_search-Tool, um für einmalige Abfragen ein günstigeres Modell zu wählen; verwenden Sie dafür den offiziellen MCP-Server von Perplexity (siehe die Korrektur weiter oben in dieser Datei). Prüfen Sie Perplexitys aktuelle Preise pro Modell, bevor Sie dies im wöchentlichen Routinemaßstab über dutzende Unternehmen hinweg ausführen — ein vollständiger Lauf reichert etwa 50–90 Unternehmen plus einen Marktsignal-Sweep an, sodass sich die Grenzkosten von sonar-pro gegenüber sonar schnell summieren.