Marginalia MCP Server
@bmorphism
About Marginalia MCP Server
An MCP server implementation for managing marginalia and annotations
Config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryTools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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.
Frequently asked questions
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.
Basic information
More Other MCP servers
Codelf
unbugA search tool helps dev to solve the naming things problem.
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Mcp
browsermcpBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
Comments