mcpField
P
Perplexity Ask OpenRouter

Perplexity Ask OpenRouter

Local
github.com/elct9620AI & Agents8Updated 53w ago
Repository

About Perplexity Ask OpenRouter

Perplexity Ask OpenRouter is an MCP server connecting the OpenRouter API to MCP clients for Perplexity-model queries, research, and reasoning. It supports SSE and Streamable HTTP transports and Docker deployment.

Key features

  1. 01General query answering
  2. 02In-depth research queries
  3. 03Complex reasoning tasks
  4. 04SSE and Streamable HTTP
  5. 05Docker deployment

Use cases

  1. 01Answer general questions with Sonar
  2. 02Conduct research with Sonar Deep Research
  3. 03Handle complex reasoning with Sonar Reasoning

MCP support

The server exposes ask, research, and reasoning tools over MCP, with SSE and Streamable HTTP transport support.

#perplexity#openrouter#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "perplexity-ask-openrouter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "\\"
      ]
    }
  }
}
Run commanddocker run -i --rm '\'

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
oci\

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Perplexity Ask OpenRouter

A Model Context Protocol (MCP) server implementation that makes OpenRouter available for Perplexity Ask.

Overview

This project is inspired by Perplexity Ask and provides an MCP server implementation that connects to OpenRouter's API. It allows you to use Perplexity's models through OpenRouter with any MCP-compatible client.

Features

  • Full implementation of the Model Context Protocol
  • Support for Perplexity's models via OpenRouter:
    • perplexity_ask - Uses Sonar model for general queries
    • perplexity_research - Uses Sonar Deep Research model for in-depth research
    • perplexity_reason - Uses Sonar Reasoning model for complex reasoning tasks
  • Server-Sent Events (SSE) support
  • Streamable HTTP transport implementation
  • Docker containerization for easy deployment

Getting Started

Environment Variables

The server requires the following environment variables:

  • OPENROUTER_API_KEY - Your OpenRouter API key (required)
  • PORT - Port to run the server on (default: 3000)
  • BASE_URL - Custom OpenRouter base URL (optional)
  • ASK_MODEL - Model to use for ask tool (default: perplexity/sonar-pro)
  • RESEARCH_MODEL - Model to use for research tool (default: perplexity/sonar-deep-research)
  • REASON_MODEL - Model to use for reason tool (default: perplexity/sonar-reasoning-pro)
  • DISABLE_ASK - Disable the ask tool (default: false)
  • DISABLE_RESEARCH - Disable the research tool (default: false)
  • DISABLE_REASON - Disable the reason tool (default: false)
Running with Docker

The easiest way to run the server is using Docker:

docker run -p 3000:3000 \
  -e OPENROUTER_API_KEY=your_api_key_here \
  ghcr.io/elct9620/perplexity-ask-openrouter:latest
Building from Source

If you prefer to build from source:

# Clone the repository
git clone https://github.com/elct9620/perplexity-ask-openrouter.git
cd perplexity-ask-openrouter

# Build Docker image
docker build -t perplexity-ask-openrouter .

API Endpoints

The server exposes the following endpoints:

  • /sse - SSE endpoint for establishing a connection
  • /messages - Endpoint for sending messages to an established SSE connection
  • /mcp - Streamable HTTP endpoint implementing the MCP protocol

Usage with MCP Clients

This server implements the Model Context Protocol, so it can be used with any MCP-compatible client. The server supports both SSE and Streamable HTTP transport modes.

Docker Deployment

The project includes a Dockerfile and GitHub Actions workflow for building and publishing the Docker image to GitHub Container Registry (ghcr.io).

License

MIT License

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.