perplexity-mcp-server

Servidor MCP para flujos de trabajo estructurados de vigilancia competitiva / inteligencia de mercado sobre la API Perplexity Sonar.

Corrección (2026-08-26): una versión anterior de este README afirmaba que no existía ningún conector MCP nativo de Perplexity en ninguna parte. Eso era incorrecto: Perplexity publica un servidor MCP oficial (github.com/perplexityai/modelcontextprotocol), que incluye un endpoint remoto alojado por Perplexity en https://api.perplexity.ai/mcp accesible desde una sesión programada en la nube sin necesidad de autoalojamiento. Si solo necesitas una búsqueda Sonar ad hoc genérica, regístralo en lugar de construir o ejecutar cualquier cosa aquí.

Lo que el servidor oficial no te ofrece es una salida de vigilancia semanal estructurada y comparable: expone búsqueda/razonamiento genéricos (Agent API, Search API), no un informe de empresa de secciones fijas ni un barrido de señales restringido por un esquema JSON. Esa es la razón real de que este servidor exista: es una capa fina y estrecha de dos herramientas de flujo de trabajo, no un reemplazo del propio servidor MCP de Perplexity.

Despliega esto una vez (consulta «Despliegue remoto» más abajo) con PERPLEXITY_API_KEY configurada como secreto de plataforma, y cualquier cliente MCP — incluyendo una sesión de Cowork/Claude programada en la nube — podrá llamarlo por HTTP sin tocar nunca la máquina local ni un puente de dispositivo. Regístralo junto al servidor oficial de Perplexity, no en su lugar.

Herramientas

• perplexity_company_news — informe estructurado de noticias de empresa (gobernanza, directivos, eventos estratégicos, situación financiera, movimientos de RR. HH.), encabezados de sección fijos, lookback_days en lugar de rangos de fechas en texto libre.

• perplexity_market_signals — barrido de señales de todo el sector (M&A, financiación, nombramientos, reestructuraciones) restringido a un esquema JSON en el lado del servidor, de modo que el resultado es un array real de señales discretas, no markdown que haya que volver a parsear. Devuelve un array vacío (no un error) cuando no se encuentra nada fechado y fiable para el período — ese es un resultado significativo, no un fallo.

Ambas herramientas admiten response_format: "markdown" | "json" y devuelven citas/fuentes. Para búsquedas de uso general, usa en su lugar el servidor MCP oficial de Perplexity — consulta la corrección anterior.

Related MCP server: Stelar Signals MCP

Configuración

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

Uso local (stdio) — inicio rápido, NO resuelve el problema de la programación en la nube

Útil para probar, o para cualquier flujo de trabajo que ya se ejecute en tu propia máquina. Regístralo en la configuración de tu cliente MCP (p. ej., el claude_desktop_config.json de Claude Desktop):

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

Esto sigue supeditando la disponibilidad a que esa máquina esté encendida — no resuelve el problema original de una tarea programada en la nube que necesita la clave. Para eso, usa el despliegue HTTP que se indica a continuación.

Despliegue remoto (HTTP en streaming) — la solución real para tareas programadas en la nube

Ejecuta el mismo código con TRANSPORT=http en cualquier host compatible con Node.js (una VPS pequeña, Render, Railway, Fly.io, un contenedor en cualquier proveedor de nube). Los únicos requisitos son: Node 18+, la posibilidad de establecer un secreto en una variable de entorno y una URL HTTPS pública.

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

El servidor expone:

• POST /mcp — el endpoint de MCP (HTTP en streaming, JSON sin estado — un nuevo servidor+transporte por solicitud, de modo que nada se filtra entre llamadas y se escala horizontalmente sin estado compartido)

• GET /health — comprobación simple de actividad para la sonda de salud de tu plataforma de alojamiento

Una vez desplegado detrás de HTTPS (https://your-host/mcp), registra esa URL como conector MCP remoto en el espacio de trabajo para que la tarea programada que depende de Perplexity pueda alcanzarlo directamente, con la clave residiendo en el lado del servidor — el mismo modelo operativo que Pappers ya utiliza (conector nativo, sin secreto local en la ruta de credenciales).

Qué se ha verificado en esta compilación

• npm run build compila sin errores (TypeScript estricto, sin any).

• Ambos transportes se inician sin fallos (stdio y HTTP).

• GET /health responde correctamente.

• El protocolo de enlace completo de MCP (initialize, tools/list) devuelve ambas herramientas con esquemas JSON, descripciones y anotaciones correctos.

• tools/call con una clave de API no válida devuelve un resultado isError: true limpio y procesable (orientación 401 que apunta al panel de Perplexity) — el servidor no se bloquea y sigue respondiendo después.

Qué NO se ha verificado aún

No había ninguna PERPLEXITY_API_KEY real disponible en el entorno de compilación, por lo que una llamada real exitosa a Sonar — contenido de respuesta real, citas reales, la respuesta de market_signals restringida por esquema JSON parseándose realmente como JSON válido — no se ha probado de extremo a extremo. Antes de confiar en esto en la rutina de vigilancia de producción, ejecuta cada una de las dos herramientas una vez con una clave real (localmente vía stdio es suficiente para esta comprobación) y confirma que la salida coincide con las estructuras documentadas anteriormente.

Nota sobre el coste

perplexity_company_news y perplexity_market_signals usan por defecto el modelo sonar-pro (búsqueda más profunda, más fuentes, mayor coste por llamada que sonar) porque el caso de uso de vigilancia prioriza la exhaustividad y la calidad de las citas sobre la latencia/el coste — este es el valor predeterminado deliberado para ambas herramientas de este servidor, confirmado el 2026-08-26. Aquí no hay ninguna herramienta perplexity_search para optar por un modelo más barato en consultas puntuales; usa el servidor MCP oficial de Perplexity para eso (consulta la corrección al principio de este archivo). Revisa los precios actuales por modelo de Perplexity antes de ejecutar esto a la escala de la rutina semanal en docenas de empresas — una ejecución completa enriquece del orden de 50-90 empresas más un barrido de señales de mercado, por lo que el coste marginal de sonar-pro frente a sonar se acumula rápidamente.