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