# perplexityai/modelcontextprotocol architecture

> Architecture diagram of the GitHub repository perplexityai/modelcontextprotocol, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/perplexityai/modelcontextprotocol
- Repository: https://github.com/perplexityai/modelcontextprotocol

## Overview

This is Perplexity’s MCP server, exposing live web search and Agent API capabilities to MCP clients over local stdio or self-hosted Streamable HTTP. The server registers four tools: direct search, quick answers, deep research, and reasoning. Agent-backed tools call the Agent API; search calls the Search API. Shared server code handles upstream requests and responses, while validation defines response schemas. The excerpts show the main wiring; HTTP configuration and logging are visible in source, while some upstream details are not.

Main entry points: [`src/server.ts`](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts) (MCP Server), [`src/http.ts`](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/http.ts) (HTTP Entry), [`src/index.ts`](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/index.ts) (Stdio Entry), [`src/validation.ts`](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/validation.ts) (Response Schemas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP Entry Points"]
  node_stdio["Stdio Entry<br/>[index.ts]"]
  node_http["HTTP Entry<br/>[http.ts]"]
end

subgraph group_tools["Research Tools"]
  node_mcp["MCP Server<br/>[server.ts]"]
  node_search["Web Search<br/>[server.ts]"]
  node_ask["Quick Answers<br/>[server.ts]"]
  node_research["Deep Research<br/>[server.ts]"]
  node_reason["Advanced Reasoning<br/>[server.ts]"]
end

subgraph group_upstream["Perplexity APIs"]
  node_agentapi["Agent API"]
  node_searchapi["Search API"]
end

subgraph group_shared["Shared Runtime"]
  node_response["Response Handling<br/>[server.ts]"]
  node_schemas["Response Schemas<br/>[validation.ts]"]
  node_logger["Structured Logger<br/>[logger.ts]"]
end

node_client(("MCP Client"))

node_client -->|"connects locally"| node_stdio
node_client -->|"connects remotely"| node_http
node_stdio -->|"starts"| node_mcp
node_http -->|"creates per request"| node_mcp
node_mcp -->|"registers"| node_search
node_mcp -->|"registers"| node_ask
node_mcp -->|"registers"| node_research
node_mcp -->|"registers"| node_reason
node_search -->|"requests search"| node_searchapi
node_ask -->|"requests answer"| node_agentapi
node_research -->|"requests research"| node_agentapi
node_reason -->|"requests reasoning"| node_agentapi
node_ask -->|"formats result"| node_response
node_research -->|"formats result"| node_response
node_reason -->|"formats result"| node_response
node_response -->|"validates against"| node_schemas
node_http -->|"logs events"| node_logger

click node_stdio "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/index.ts"
click node_http "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/http.ts"
click node_mcp "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts"
click node_search "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts"
click node_ask "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts"
click node_research "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts"
click node_reason "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts"
click node_response "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts"
click node_schemas "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/validation.ts"
click node_logger "https://github.com/perplexityai/modelcontextprotocol/blob/main/src/logger.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_stdio,node_http,node_client toneBlue
class node_mcp,node_search,node_ask,node_research,node_reason toneAmber
class node_agentapi,node_searchapi toneMint
class node_response,node_schemas,node_logger toneRose
```

## Components

### MCP Entry Points

- [Stdio Entry](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/index.ts): `src/index.ts`
- [HTTP Entry](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/http.ts): `src/http.ts`

### Research Tools

- [MCP Server](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts): `src/server.ts`
- [Web Search](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts): `src/server.ts`
- [Quick Answers](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts): `src/server.ts`
- [Deep Research](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts): `src/server.ts`
- [Advanced Reasoning](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts): `src/server.ts`

### Perplexity APIs

- **Agent API**
- **Search API**

### Shared Runtime

- [Response Handling](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/server.ts): `src/server.ts`
- [Response Schemas](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/validation.ts): `src/validation.ts`
- [Structured Logger](https://github.com/perplexityai/modelcontextprotocol/blob/main/src/logger.ts): `src/logger.ts`

### Other components

- **MCP Client**

## Connections

- MCP Client → Stdio Entry: connects locally (evidence: `README.md`)
- MCP Client → HTTP Entry: connects remotely (evidence: `README.md`)
- Stdio Entry → MCP Server: starts (evidence: `src/index.ts`)
- HTTP Entry → MCP Server: creates per request (evidence: `src/http.ts`)
- MCP Server → Web Search: registers (evidence: `src/server.ts`)
- MCP Server → Quick Answers: registers (evidence: `src/server.ts`)
- MCP Server → Deep Research: registers (evidence: `src/server.ts`)
- MCP Server → Advanced Reasoning: registers (evidence: `src/server.ts`)
- Web Search → Search API: requests search (evidence: `src/server.ts`)
- Quick Answers → Agent API: requests answer (evidence: `src/server.ts`)
- Deep Research → Agent API: requests research (evidence: `src/server.ts`)
- Advanced Reasoning → Agent API: requests reasoning (evidence: `src/server.ts`)
- Quick Answers → Response Handling: formats result (evidence: `src/server.ts`)
- Deep Research → Response Handling: formats result (evidence: `src/server.ts`)
- Advanced Reasoning → Response Handling: formats result (evidence: `src/server.ts`)
- Response Handling → Response Schemas: validates against (evidence: `src/server.ts`)
- HTTP Entry → Structured Logger: logs events (evidence: `src/http.ts`)
