Marginalia MCP Server

What is 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.

How to use Marginalia MCP Server?

Install using npm install and npm run build. Configure an optional MARGINALIA_API_KEY environment variable (defaults to public access). Use the search MCP tool with a required query parameter and optional index and count parameters.

Key features of Marginalia MCP Server

• Search the web using Marginalia Search API
• Configurable search parameters including index and result count
• Rate limiting protection with helpful error messages
• Built using MCP SDK for seamless integration

Use cases of Marginalia MCP Server

• Search for interesting non-commercial websites
• Discover hidden gems of the internet through an MCP interface
• Integrate Marginalia Search into AI assistants and tools

FAQ from Marginalia MCP Server

How do I get an API key for Marginalia MCP Server?

Contact [email protected] to request a dedicated API key. The server defaults to public access if no key is set.

What search parameters are available?

The search tool requires a query string. Optional parameters are index (search index number) and count (number of results, 1–100, default 10).

How does Marginalia MCP Server handle rate limiting?

The server includes robust error handling for rate limiting (503 responses) and returns helpful error messages.

What format do search results come in?

Results are returned as a JSON object containing query, license, and an array of results with url, title, and description fields.

Can I use Marginalia MCP Server without an API key?

Yes, if no MARGINALIA_API_KEY environment variable is set, the server uses public access to Marginalia Search.