Mac-letterhead

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.easytocloud/mac-letterhead",
  "description": "Letterhead PDF as digital stationery: prints Markdown without overprinting header, footer, or logo.",
  "title": "Mac-letterhead",
  "repository": {
    "url": "https://github.com/easytocloud/Mac-letterhead",
    "source": "github"
  },
  "version": "0.24.4",
  "websiteUrl": "https://github.com/easytocloud/Mac-letterhead",
  "packages": [
    {
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "identifier": "Mac-letterhead",
      "version": "0.24.4",
      "runtimeHint": "python3",
      "transport": {
        "type": "stdio"
      },
      "packageArguments": [
        {
          "value": "mcp",
          "type": "positional"
        }
      ]
    }
  ],
  "_meta": {
    "io.modelcontextprotocol.registry/publisher-provided": {
      "author": {
        "name": "Erik",
        "url": "https://github.com/easytocloud"
      },
      "capabilities": {
        "tools": [
          {
            "description": "Create a letterheaded PDF from Markdown content. Converts Markdown to professionally formatted PDF with smart margin detection and letterhead overlay. Supports GFM, tables, code blocks, and custom CSS styling.",
            "name": "create_letterhead_pdf"
          },
          {
            "description": "Merge an existing PDF with a letterhead template. Applies letterhead overlay to existing PDFs with multiple blend strategies (darken, multiply, overlay, transparency). Preserves original document formatting.",
            "name": "merge_letterhead_pdf"
          },
          {
            "description": "Analyze a letterhead template to determine margins and printable areas. Uses smart content detection to identify header, footer, and logo positions. Calculates optimal margins for document content.",
            "name": "analyze_letterhead"
          },
          {
            "description": "List all available letterhead templates in the ~/.letterhead directory. Shows template names, file paths, and associated CSS files.",
            "name": "list_letterhead_templates"
          }
        ]
      },
      "categories": [
        "document-generation",
        "pdf",
        "productivity"
      ],
      "configuration": {
        "examples": [
          {
            "config": {
              "args": [
                "Mac-letterhead[mcp]",
                "mcp"
              ],
              "command": "uvx"
            },
            "description": "Generic server where style is specified per tool call",
            "name": "Generic multi-style server"
          },
          {
            "config": {
              "args": [
                "Mac-letterhead[mcp]",
                "mcp",
                "--style",
                "easytocloud"
              ],
              "command": "uvx"
            },
            "description": "Dedicated server pre-configured with a specific letterhead style",
            "name": "Style-specific server"
          },
          {
            "config": {
              "args": [
                "Mac-letterhead[mcp]",
                "mcp",
                "--style",
                "company",
                "--output-dir",
                "~/Documents/generated-pdfs"
              ],
              "command": "uvx"
            },
            "description": "Server with custom output directory for generated PDFs",
            "name": "Custom output directory"
          }
        ],
        "setupInstructions": "Place letterhead PDF files in ~/.letterhead/ directory. Optional CSS files can be added with matching names (e.g., ~/.letterhead/company.pdf and ~/.letterhead/company.css)."
      },
      "documentation": {
        "contributing": "https://github.com/easytocloud/Mac-letterhead/blob/main/CONTRIBUTING.md",
        "llmInstallation": "https://github.com/easytocloud/Mac-letterhead/blob/main/llms-install.md",
        "mcpGuide": "https://github.com/easytocloud/Mac-letterhead/blob/main/README_MCP.md",
        "readme": "https://github.com/easytocloud/Mac-letterhead/blob/main/README.md"
      },
      "license": "MIT",
      "platform": {
        "os": [
          "macos"
        ],
        "pythonVersion": ">=3.10",
        "systemDependencies": [
          {
            "description": "Optional system libraries for WeasyPrint high-quality rendering",
            "install": "brew install pango cairo fontconfig freetype harfbuzz",
            "name": "pango, cairo, fontconfig, freetype, harfbuzz",
            "required": false
          }
        ]
      },
      "tags": [
        "pdf",
        "letterhead",
        "markdown",
        "document-generation",
        "macos",
        "branding",
        "professional-documents",
        "pdf-merge",
        "markdown-to-pdf",
        "github-flavored-markdown",
        "weasyprint",
        "reportlab"
      ]
    }
  }
}