This server provides an MCP tool to integrate with Marginalia Search, a search engine focused on non-commercial content.
Capabilities include:
Search the web using Marginalia Search API with customizable parameters
Configure searches by specifying indexes and limiting results (1-100)
Utilize an optional API key for potentially higher limits or features
Protection against rate limiting and handling of other errors
Potential to extend functionality by integrating with other MCP servers (like
sayfor text-to-speech)
Marginalia MCP Server
An MCP (Model Context Protocol) server that provides access to Marginalia Search, a search engine focused on finding non-commercial content and hidden gems of the internet.
Features
Search the web using Marginalia Search API
Configurable search parameters including index and result count
Rate limiting protection with helpful error messages
Built using the MCP SDK for seamless integration
Related MCP server: SearXNG MCP Server
Installation
Configuration
The server can be configured using environment variables:
MARGINALIA_API_KEY: Your Marginalia Search API key (optional, defaults to public access)
To request a dedicated API key, contact: kontakt@marginalia.nu
Usage
The server provides the following MCP tool:
search
Search the web using Marginalia Search with the following parameters:
query(required): Search query stringindex(optional): Search index number (corresponds to dropdown in main GUI)count(optional): Number of results to return (1-100, default: 10)
Example usage through MCP:
Response Format
The search results are returned in the following format:
Error Handling
The server includes robust error handling for:
Rate limiting (503 responses)
Invalid requests
Network errors
API-specific errors
Adding Text-to-Speech Support
To enable text-to-speech capabilities using the say MCP server, add the following configuration:
For Cline (VSCode Extension)
Add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
For Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
The say MCP server provides text-to-speech capabilities with multiple voices and languages. Available tools:
speak: Read text aloud using specified voice and ratelist_voices: List all available text-to-speech voices
License
MIT License - See LICENSE file for details