Swift Poe Search MCP

A Swift MCP (Model Context Protocol) server providing AI-powered search and research tools via the Poe API proxy. Supports 4 providers with 16 specialized tools.

If you found this helpful, you can support more open source work!

---

Overview

This server acts as a bridge between MCP clients and multiple AI/search providers through Poe's unified API:

Provider	Tools	Description
Perplexity	3	Web search with citations, reasoning, deep research
Reka	3	Agentic research, fact-checking, similarity finding
Exa	9	Neural search, code context, company research, crawling
Linkup	1	#1 ranked factual accuracy on OpenAI's SimpleQA

Quick Start

Requirements

• Poe subscription with API access
• API key from poe.com/api_key
• Linux: Ubuntu 20.04+ or Debian 11+, requires apt-get install libcurl4
• macOS: macOS 14+ (Sonoma), Intel Macs supported via Rosetta
• Swift: 6.2+ (for building from source)

Installation

Via NPM (no build required):

npx @mehmetbaykar/swift-poe-search-mcp@latest

Via Swift (build from source):

git clone https://github.com/mehmetbaykar/swift-poe-search-mcp.git
cd swift-poe-search-mcp
swift build -c release

Configuration

# Required
export POE_API_KEY=your_api_key

# Optional
export POE_BASE_URL=https://api.poe.com/v1  # default
export POE_TIMEOUT_MS=600000                 # default: 10 minutes
export ENABLED_PROVIDERS=perplexity,reka,exa,linkup  # default: all

MCP Client Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "swift-poe-search": {
      "command": "npx",
      "args": ["@mehmetbaykar/swift-poe-search-mcp@latest"],
      "env": {
        "POE_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "swift-poe-search": {
      "command": "npx",
      "args": ["@mehmetbaykar/swift-poe-search-mcp@latest"],
      "env": {
        "POE_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Code CLI

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "swift-poe-search": {
      "command": "npx",
      "args": ["@mehmetbaykar/swift-poe-search-mcp@latest"],
      "env": {
        "POE_API_KEY": "your_api_key"
      }
    }
  }
}

Testing with MCP Inspector

POE_API_KEY=your_key npx @modelcontextprotocol/inspector@latest swift run

---

Available Tools

Perplexity Tools

perplexity_ask

Conversational web search using Sonar API with 200k context.

Parameter	Type	Default	Description
messages	[Message]	required	Conversation messages
searchContextSize	enum	low	low, medium, high
searchMode	enum	default	default, academic, sec
searchDomainFilter	string	""	Comma-separated domains (prefix with - to exclude)
searchLanguageFilter	string	""	ISO 639-1 codes (max 10)
searchRecencyFilter	enum	none	none, day, week, month, year
searchAfterDate	string	""	Publication date filter
searchBeforeDate	string	""	Publication date filter
country	string	""	ISO 3166-1 alpha-2 code
region	string	""	State/Province name
city	string	""	City name
latitude	string	""	Requires longitude + country
longitude	string	""	Requires latitude + country
returnImages	bool	false	Include images
returnVideos	bool	false	Include videos
imageDomainFilter	string	""	Domains for images (max 10)
imageF

... View full README on GitHub