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
say
for 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
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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Provides access to Marginalia Search for discovering non-commercial and independent web content, returning unique sites with URLs, titles, and descriptions.
- Features
- Installation
- Configuration
- Usage
- Response Format
- Error Handling
- Adding Text-to-Speech Support
- License
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityEnables users to search for academic articles on platforms like arXiv using specific keywords, with plans to integrate more scholarly databases in the future.Last updated -2137PythonMIT License
- AsecurityAlicenseAqualityEnables efficient web search integration with Jina.ai's Search API, offering clean, LLM-optimized content retrieval with support for various content types and configurable caching.Last updated -15604JavaScriptMIT License
- AsecurityAlicenseAqualityThis server provides a privacy-focused meta search capability by integrating multiple search engines without tracking or user profiling, supporting various categories and languages for filtered searches.Last updated -163818JavaScriptMIT License
- -securityFlicense-qualityEnables free web searching using Google search results with no API keys required, returning structured results with titles, URLs, and descriptions.Last updated -51