Skip to main content
Glama
belugatempo-dot

Perplexity Search MCP Server

Perplexity Search MCP Skill

A Claude Code skill that enables web search using Perplexity AI through SAP AI Core.

Overview

This skill provides real-time web search capabilities with source citations by leveraging Perplexity's Sonar models deployed on SAP AI Core. It works as an MCP (Model Context Protocol) server that integrates seamlessly with Claude Code.

Prerequisites

Installation

1. Clone and Build

git clone <repo-url> perplexity-skill cd perplexity-skill npm install npm run build

2. Install the Skill

npm run install-skill

This will:

  • Add the MCP server to ~/.claude/mcp.json

  • Install the skill definition to ~/.claude/skills/perplexity/

3. Restart Claude Code

Restart Claude Code to load the new MCP server.

Configuration

Environment Variables

Variable

Default

Description

SAP_AI_PROXY_URL

http://127.0.0.1:3030

URL of the sap-ai-proxy server

PERPLEXITY_DEFAULT_MODEL

sonar-pro

Default Perplexity model to use

To customize, edit the env section in ~/.claude/mcp.json:

{ "mcpServers": { "perplexity-search": { "command": "node", "args": ["/path/to/perplexity-skill/dist/index.js"], "env": { "SAP_AI_PROXY_URL": "http://127.0.0.1:3030", "PERPLEXITY_DEFAULT_MODEL": "sonar-pro" } } } }

Usage

Explicit Invocation

/perplexity What are the latest developments in AI?

Natural Language

The skill automatically triggers for web search queries:

What happened in tech news today? What's the current price of Bitcoin?

Available Tools

Full-featured web search with all configuration options.

Parameters:

  • query (required): The search query

  • model (optional): sonar | sonar-pro | sonar-reasoning

  • search_recency_filter (optional): day | week | month | year

  • return_citations (optional): boolean (default: true)

Simplified search for quick queries.

Parameters:

  • query (required): The search query

Supported Models

Model

Description

sonar

Fast real-time web search

sonar-pro

Enhanced reasoning with citations

sonar-reasoning

Deep analysis and reasoning

Response Format

Responses include:

  1. Main answer content

  2. Source citations (numbered URLs)

  3. Search results with titles and snippets

Example output:

**The capital of France is Paris.** Paris has served as the capital since 1944... --- **Sources:** 1. https://en.wikipedia.org/wiki/Paris 2. https://www.britannica.com/place/Paris **Search Results:** 1. [Paris - Wikipedia](https://en.wikipedia.org/wiki/Paris) Paris is the capital and largest city of France...

Uninstallation

npm run uninstall-skill

Then restart Claude Code.

Architecture

Claude Code → MCP Server (stdio) → sap-ai-proxy:3030 → SAP AI Core (Perplexity)

Troubleshooting

"Model sonar-pro is not available"

  1. Ensure the Perplexity model is deployed in SAP AI Core

  2. Restart sap-ai-proxy to refresh the deployment cache

  3. Verify with: curl http://127.0.0.1:3030/v1/models

MCP Server Not Loading

  1. Check ~/.claude/mcp.json configuration

  2. Ensure dist/index.js exists (run npm run build)

  3. Restart Claude Code

Connection Refused

Ensure sap-ai-proxy is running:

cd /path/to/sap-ai-proxy npm start

Development

# Watch mode for development npm run dev # Test the MCP server echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

License

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/belugatempo-dot/perplexity-skill'

If you have feedback or need assistance with the MCP directory API, please join our Discord server