Marginalia MCP Server logo

Marginalia MCP Server

by bmorphism

An MCP server that provides access to Marginalia Search, a search engine focused on finding non-commercial content. It allows users to search the web for hidden gems and alternative perspectives.

View on GitHub

Last updated: N/A

What is Marginalia MCP Server?

This is an MCP (Model Context Protocol) server that allows access to the Marginalia Search engine. It enables users to search the web for non-commercial content and hidden gems through the MCP interface.

How to use Marginalia MCP Server?

Install the server using npm install and npm run build. Configure the server using environment variables, specifically the MARGINALIA_API_KEY (optional). Use the search tool with parameters like query, index, and count through an MCP client.

Key features of Marginalia MCP Server

  • Search the web using Marginalia Search API

  • Configurable search parameters

  • Rate limiting protection

  • Built using the MCP SDK

Use cases of Marginalia MCP Server

  • Finding non-commercial websites

  • Discovering hidden gems on the internet

  • Searching for alternative perspectives

  • Integrating Marginalia Search into MCP-compatible applications

FAQ from Marginalia MCP Server

What is Marginalia Search?

Marginalia Search is a search engine focused on finding non-commercial content and hidden gems of the internet.

Do I need an API key to use this server?

An API key is optional. Public access is available, but a dedicated API key can be requested for higher rate limits.

What is the format of the search results?

The search results are returned in JSON format, including the query, license information, and an array of results with URL, title, and description.

What kind of error handling is included?

The server includes robust error handling for rate limiting, invalid requests, network errors, and API-specific errors.

How can I add text-to-speech support?

You can enable text-to-speech capabilities by configuring the server to work with the say MCP server, following the instructions provided for Cline (VSCode Extension) or Claude Desktop.