Lunoo Rankings MCP server

lunoo-mcp

Public Model Context Protocol (MCP) server for Lunoo, a rankings platform covering more than 231,000 items across more than 2,600 categories on a 0-10 scale.

Ask for rankings in normal language, from anime and laptops to software, travel, books, and thousands of other categories. The server resolves the closest live category, returns scored items with Lunoo links, and refuses unsupported queries instead of inventing a result.

Overview

This is a read-only public proxy over Lunoo's public web API. No authentication required, no database access, no API keys, no cost.

• Live endpoint: https://lunoo.com/mcp (Streamable HTTP, JSON-RPC 2.0)
• Transport: Stateless POST over HTTP
• Caching: Browse page 24h, rankings and items 15 minutes
• Timeout: 10 seconds per upstream request
• Coverage: 2,677+ categories and 231,982+ ranked items, verified on 2026-08-21
• Privacy: No raw prompts, tool arguments, or tool results are stored. See https://lunoo.com/privacy
• Safety: All three tools are read-only and expose MCP read-only annotations

Security and abuse controls

• The server listens on 127.0.0.1 by default so a reverse proxy can expose only the intended HTTPS route.
• Each client is limited to 120 MCP requests per minute.
• No more than 20 MCP requests and 12 upstream Lunoo requests run at once.
• JSON bodies are limited to 32 KB, JSON-RPC batches to 20 messages, and tool inputs to documented lengths.
• The in-memory cache is limited to 256 entries and evicts old keys.
• User input is encoded into fixed Lunoo paths. It cannot select an arbitrary upstream host.
• The server does not execute commands, evaluate user code, read local files, or expose environment variables.

Self-hosted deployments should keep the Node port private and expose /mcp through an HTTPS reverse proxy. Do not publish port 8972 directly.

Quick Start

Claude custom connector

Open Claude's connector settings, choose Add custom connector, and enter:

Name: Lunoo Rankings
URL: https://lunoo.com/mcp

No authentication is required. Test with a request such as Find the best laptop for video editing using Lunoo.

Claude Code

In your project's .claude/settings.json:

{
  "mcpServers": {
    "lunoo": {
      "url": "https://lunoo.com/mcp"
    }
  }
}

Or run from any Claude Code session:

claude mcp add --transport http lunoo https://lunoo.com/mcp

Generic HTTP Client

Post JSON-RPC 2.0 requests to https://lunoo.com/mcp. Example:

curl -X POST https://lunoo.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

Local Development (self-hosted)

npm install
npm start
# Server listens on http://localhost:8972

Health check:

curl http://localhost:8972/healthz
# {"ok":true,"service":"lunoo-mcp"}

Tools

find_niche

Resolve a normal-language request to live ranking categories. Returns up to 10 matches with confidence, matched terms, item counts, and tracked Lunoo links.

Input:

{
  "query": "string - normal-language request, e.g. 'best laptop for video editing'"
}

Output: Array of niches with slug, display name, Lunoo URL, and JSON endpoint URL.

Example Request:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "find_niche",
    "arguments": { "query": "anime" }
  },
  "id": 1
}

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "isError": false,
    "content": [
      {
        "type": "text",
        "text": "[\n  {\n    \"slug\": \"anime\",\n    \"name\": \"anime\",\n    \"url\": \"https://lunoo.com/best/anime\",\n    \"rankings_json\": \"https://lunoo.com/best/anime.json\"\n  },\n  ...\n]"
      }
    ]
  },
  "id": 1
}

get_rankings

Shortened. The full README is on GitHub.