MCP.so
Sign In

Marginalia MCP Server

@bmorphism

Basic information

Category

Other

Transports

stdio

Author

bmorphism

About Marginalia MCP Server

An MCP server implementation for managing marginalia and annotations

#marginalia#mcp-server#annotations

Marginalia MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Marginalia MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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

Contact kontakt@marginalia.nu to request a dedicated API key. The server defaults to public access if no key is set.

2

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).

3

How does Marginalia MCP Server handle rate limiting?

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

4

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.

5

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.

Comments

More Other MCP servers