drio
Open app

Marginalia MCP Server

Source

An MCP server implementation for managing marginalia and annotations

Catalog onlyCatalog onlySTDIO

Overview

Marginalia MCP Server is an implementation of an MCP (Model Context Protocol) server designed for managing marginalia and annotations, providing access to the Marginalia Search engine that focuses on discovering non-commercial content and hidden gems on the internet.

To use the server, install it via npm, configure it with your Marginalia Search API key (if needed), and utilize the search tool by providing a query and optional parameters.

  • Access to Marginalia Search API for web searching - Configurable search parameters including index and result count - Robust error handling for various issues - Integration with text-to-speech capabilities
  1. Searching for unique non-commercial websites.
  2. Managing and annotating web content.
  3. Integrating search functionalities into applications using the MCP protocol.

Add to your AI client

Use these steps to connect Marginalia MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "marginalia-mcp-server-bmorphism": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-marginalia-mcp-server-bmorphism"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "marginalia-mcp-server-bmorphism": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-marginalia-mcp-server-bmorphism"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "marginalia-mcp-server-bmorphism": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-marginalia-mcp-server-bmorphism"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "marginalia-mcp-server-bmorphism": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-marginalia-mcp-server-bmorphism"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "marginalia-mcp-server-bmorphism": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-marginalia-mcp-server-bmorphism"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "marginalia-mcp-server-bmorphism": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-marginalia-mcp-server-bmorphism"
      ]
    }
  }
}

FAQ

How do I get an API key for Marginalia Search?

You can request a dedicated API key by contacting kontakt@marginalia.nu.

What programming language is used for the server?

The server is built using JavaScript and can be installed via npm.

Can I customize the search results?

Yes, you can configure the search parameters such as index and result count.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1122,"uuid":"812e6daa-83ee-4f0e-bb91-a426066aa257","name":"marginalia-mcp-server","title":"Marginalia MCP Server","description":"An MCP server implementation for managing marginalia and annotations","avatar_url":"https://avatars.githubusercontent.com/u/1236584?v=4","created_at":"2025-01-28T02:33:11.015Z","updated_at":"2025-02-23T07:12:46.966Z","status":"created","author_name":"bmorphism","author_avatar_url":"https://avatars.githubusercontent.com/u/1236584?v=4","tags":"marginalia,mcp-server,annotations","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/bmorphism/marginalia-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data