{
  "$schema": "https://modelcontextprotocol.io/schemas/server-card.schema.json",
  "serverInfo": {
    "name": "Blink PDF MCP Server",
    "version": "1.0.0",
    "description": "Hosted Streamable HTTP MCP server for rendering Markdown to professional PDFs with Blink PDF.",
    "homepage": "https://docs.blinkpdf.io/mcp/overview"
  },
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://mcp.blinkpdf.io/mcp"
  },
  "authentication": {
    "schemes": [
      {
        "type": "http",
        "scheme": "bearer",
        "description": "Use Authorization: Bearer bp_YOUR_API_KEY."
      },
      {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "Fallback API key header using the same bp_* key."
      }
    ]
  },
  "capabilities": {
    "tools": [
      {
        "name": "render_pdf",
        "description": "Render Markdown into a professional PDF and return a signed, expiring download URL with usage and diagnostics metadata.",
        "inputSchema": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "markdown"
          ],
          "properties": {
            "markdown": {
              "type": "string",
              "description": "GitHub-flavored Markdown source to render as a PDF."
            },
            "title": {
              "type": "string",
              "description": "Optional PDF metadata title. Defaults to the first Markdown heading when omitted."
            },
            "pageSize": {
              "oneOf": [
                {
                  "type": "string",
                  "enum": [
                    "A3",
                    "A4",
                    "A5",
                    "B4",
                    "B5",
                    "Letter",
                    "Legal",
                    "Tabloid",
                    "HalfLetter"
                  ]
                },
                {
                  "type": "array",
                  "minItems": 2,
                  "maxItems": 2,
                  "items": {
                    "type": "number"
                  }
                }
              ],
              "description": "Named page preset or [width, height] tuple in PDF points."
            },
            "orientation": {
              "type": "string",
              "enum": [
                "portrait",
                "landscape"
              ],
              "description": "Page orientation. Defaults to portrait."
            },
            "margin": {
              "oneOf": [
                {
                  "type": "number"
                },
                {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "top",
                    "right",
                    "bottom",
                    "left"
                  ],
                  "properties": {
                    "top": {
                      "type": "number"
                    },
                    "right": {
                      "type": "number"
                    },
                    "bottom": {
                      "type": "number"
                    },
                    "left": {
                      "type": "number"
                    }
                  }
                }
              ],
              "description": "Page margin in points, either a single number or all four sides."
            },
            "styles": {
              "type": "object",
              "description": "Advanced style overrides forwarded to the Blink PDF renderer."
            }
          }
        }
      }
    ],
    "resources": [
      {
        "uri": "blinkpdf://reference/render-options",
        "description": "Curated render_pdf options with worked examples."
      },
      {
        "uri": "blinkpdf://reference/styles",
        "description": "Advanced styles override catalog."
      }
    ]
  },
  "links": {
    "documentation": "https://docs.blinkpdf.io/mcp/overview",
    "setup": "https://docs.blinkpdf.io/mcp/setup",
    "apiCatalog": "https://blinkpdf.io/.well-known/api-catalog"
  }
}