Skip to main content
Glama
percollate-mcp

percollate-mcp

by ljbred08

percollate-mcp

An MCP server that wraps Percollate to convert web pages into PDF, EPUB, HTML, or Markdown — directly from your AI assistant.

Tools

Download tools

Each writes a file to disk:

Tool

Output

percollate_download_pdf

PDF

percollate_download_epub

EPUB e-book

percollate_download_html

HTML file

percollate_download_md

Markdown file

Parameters:

  • urls (required) — Array of URLs to convert

  • output — Output file path

  • title — Document title

  • author — Document author

  • css — Additional CSS overrides

  • style — Custom CSS stylesheet path

  • template — Custom HTML template path

  • hyphenate — Enable hyphenation

  • individual — Export each URL as a separate file

  • wait — Seconds between processing URLs

  • no_amp — Don't prefer AMP versions

  • cover — Generate a cover page

  • toc — Generate a table of contents

  • toc_level — Heading depth for ToC (1–6)

  • inline — Embed images as base64

  • debug — Verbose output

percollate_read_md

Reads a web page as Markdown and returns the content directly in conversation. Results are cached locally — repeated calls for the same URL return instantly.

Parameters:

  • url (required) — URL to read

  • title, author, css, style, template, hyphenate, wait, no_amp, debug — standard processing options

Cached files are stored in your OS temp directory (percollate-mcp-cache/).

Related MCP server: Scrapi MCP Server

Quick Start

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "percollate": {
      "command": "npx",
      "args": ["-y", "percollate-mcp"]
    }
  }
}

No install needed — npx handles it automatically.

Requirements

  • Node.js 18+

License

MIT

Available Tools

5 tools
percollate_download_epubC

Download one or more web pages as an EPUB e-book. Supports bundling multiple URLs with cover page and ToC.

Inputs: urls (required), css, toc, wait, +12 more.

percollate_download_htmlC

Download one or more web pages as a self-contained HTML file. Use the 'inline' option to embed images as base64.

Inputs: urls (required), css, toc, wait, +12 more.

percollate_download_mdC

Download one or more web pages as a Markdown file. Produces clean, readable Markdown from web articles.

Inputs: urls (required), css, toc, wait, +12 more.

percollate_download_pdfC

Download one or more web pages as a beautifully formatted PDF file. Supports bundling multiple URLs into a single document with cover page and ToC.

Inputs: urls (required), css, toc, wait, +12 more.

percollate_read_mdA

Read a web page as Markdown. Fetches the page, converts to clean Markdown, caches the result locally, and returns the full Markdown content. Subsequent calls for the same URL return the cached version instantly. Ideal for consuming web content directly in conversation.

Inputs: url (required), css, wait, debug, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation4/5

    Each download tool targets a distinct output format, and read_md is separated by its return-content behavior. However, download_md and read_md both produce Markdown, so an agent could momentarily confuse saving a file with reading content, though the descriptions clarify the difference.

    Naming Consistency5/5

    All tools use a consistent snake_case naming pattern with the same percollate_ prefix and clear action_format structure. The slight semantic switch from download_* to read_md is still predictable and readable.

    Tool Count5/5

    Five tools is well-scoped for a web-page conversion server. Each tool maps to a meaningful output or consumption mode without redundant entries.

    Completeness5/5

    The set covers the core percollate output formats (PDF, EPUB, HTML, Markdown) plus direct Markdown reading. No obvious lifecycle gaps exist for a stateless conversion/read server.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers