pdfco-mcp 0.0.1__py3-none-any.whl

pdfco/mcp/__init__.py

@@ -0,0 +1,8 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.tools.apis import conversion, job, file, modification, form, search, searchable, security, document, extraction, editing
+    
+def main():
+    mcp.run(transport="stdio")
+
+if __name__ == "__main__":
+    main()

pdfco/mcp/models.py

@@ -0,0 +1,68 @@
+from pydantic import BaseModel, Field
+from typing import Any
+
+class BaseResponse(BaseModel):
+    status: str
+    content: Any
+    credits_used: int | None = None
+    credits_remaining: int | None = None
+    tips: str | None = None
+
+class ConversionParams(BaseModel):
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.", default="")
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default="")
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default="")
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default="")
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False)
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default="")
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng")
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0")
+    password: str = Field(description="Password of the PDF file. (Optional)", default="")
+    name: str = Field(description="File name for the generated output. (Optional)", default="")
+    autosize: bool = Field(description="Controls automatic page sizing. If true, page dimensions adjust to content. If false, uses worksheet’s page setup. (Optional)", default=False)
+
+    html: str = Field(description="Input HTML code to be converted. To convert the link to a PDF use the /pdf/convert/from/url endpoint instead.", default="")
+    templateId: str = Field(description="Set to the ID of your HTML template. You can find and copy the ID from HTML to PDF Templates.", default="")
+    templateData: str = Field(description="Set it to a string with input JSON data (recommended) or CSV data.", default="")
+    margins: str = Field(description="Set to CSS style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left). (Optional)", default="")
+    paperSize: str = Field(description="A4 is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by space like this: 200 300, 200px 300px, 200mm 300mm, 20cm 30cm or 6in 8in. (Optional)", default="")
+    orientation: str = Field(description="Set to Portrait or Landscape. Portrait is set by default. (Optional)", default="")
+    printBackground: bool = Field(description="true by default. Set to false to disable printing of background. (Optional)", default=True)
+    mediaType: str = Field(description="Uses print by default. Set to screen to convert HTML as it appears in a browser or print to convert as it appears for printing or none to set none as mediaType for CSS styles. (Optional)", default="")
+    DoNotWaitFullLoad: bool = Field(description="false by default. Set to true to skip waiting for full load (like full video load etc. that may affect the total conversion time). (Optional)", default=False)
+    header: str = Field(description="User definable HTML for the header to be applied on every page header. (Optional)", default="")
+    footer: str = Field(description="User definable HTML for the footer to be applied on every page footer. (Optional)", default="")
+
+    worksheetIndex: str = Field(description="Index of the worksheet to convert. (Optional)", default="")
+
+    def parse_payload(self, async_mode: bool = True):
+        payload = {
+            "async": async_mode,
+        }
+        if self.url: payload["url"] = self.url
+        if self.httpusername: payload["httpusername"] = self.httpusername
+        if self.httppassword: payload["httppassword"] = self.httppassword
+        if self.pages: payload["pages"] = self.pages
+        if self.unwrap: payload["unwrap"] = self.unwrap
+        if self.rect: payload["rect"] = self.rect
+        if self.lang: payload["lang"] = self.lang
+        if self.line_grouping: payload["lineGrouping"] = self.line_grouping
+        if self.password: payload["password"] = self.password
+        if self.name: payload["name"] = self.name
+        if self.autosize: payload["autosize"] = self.autosize
+        
+        if self.html: payload["html"] = self.html
+        if self.templateId: payload["templateId"] = self.templateId
+        if self.templateData: payload["templateData"] = self.templateData
+        if self.margins: payload["margins"] = self.margins
+        if self.paperSize: payload["paperSize"] = self.paperSize
+        if self.orientation: payload["orientation"] = self.orientation
+        if self.printBackground: payload["printBackground"] = self.printBackground
+        if self.mediaType: payload["mediaType"] = self.mediaType
+        if self.DoNotWaitFullLoad: payload["DoNotWaitFullLoad"] = self.DoNotWaitFullLoad
+        if self.header: payload["header"] = self.header
+        if self.footer: payload["footer"] = self.footer
+        
+        if self.worksheetIndex: payload["worksheetIndex"] = self.worksheetIndex
+        
+        return payload

pdfco/mcp/server.py

@@ -0,0 +1,3 @@
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP("pdfco")

pdfco/mcp/services/client.py

@@ -0,0 +1,46 @@
+from contextlib import asynccontextmanager
+from httpx import AsyncClient
+import os, sys
+from typing import AsyncGenerator
+import importlib.metadata
+
+__BASE_URL = "https://api.pdf.co"
+X_API_KEY = os.getenv("X_API_KEY")  
+
+__version__ = importlib.metadata.version('pdfco-mcp')
+print(f"pdfco-mcp version: {__version__}", file=sys.stderr)
+
+@asynccontextmanager
+async def PDFCoClient() -> AsyncGenerator[AsyncClient, None]:
+    if not X_API_KEY:
+        raise ValueError("""X_API_KEY is not set. Please set X_API_KEY in the environment variables in your MCP server. 
+        To get the API key please sign up at https://pdf.co and you can get the API key from the dashboard.
+        ex) .cursor/mcp.json
+        ```json
+        {
+            "mcpServers": {
+                "pdfco": {
+                    "command": "uvx",
+                    "args": [
+                        "pdfco-mcp"
+                    ],
+                    "env": {
+                        "X_API_KEY": "YOUR_API_KEY"
+                    }
+                }
+            }
+        }
+        ```
+        """)
+    
+    client = AsyncClient(
+            base_url=__BASE_URL,
+            headers={
+                "x-api-key": X_API_KEY,
+                "User-Agent": f"pdfco-mcp/{__version__}",
+            },
+        )
+    try:
+        yield client
+    finally:
+        await client.aclose()

pdfco/mcp/services/pdf.py

@@ -0,0 +1,95 @@
+import sys
+from pdfco.mcp.models import BaseResponse, ConversionParams
+from pdfco.mcp.services.client import PDFCoClient
+
+async def convert_to(_from: str, _to: str, params: ConversionParams) -> BaseResponse:
+    return await request(f'{_from}/convert/to/{_to}', params)
+
+async def convert_from(_to: str, _from: str, params: ConversionParams) -> BaseResponse:
+    return await request(f'{_to}/convert/from/{_from}', params)
+
+async def merge_pdf(params: ConversionParams) -> BaseResponse:
+    return await request(f'pdf/merge2', params)
+
+async def split_pdf(params: ConversionParams) -> BaseResponse:
+    return await request(f'pdf/split', params)
+
+async def get_pdf_form_fields_info(params: ConversionParams) -> BaseResponse:
+    return await request('pdf/info/fields', params)
+
+async def fill_pdf_form_fields(params: ConversionParams, fields: list = None, annotations: list = None) -> BaseResponse:
+    custom_payload = {}
+    if fields:
+        custom_payload["fields"] = fields
+    if annotations:
+        custom_payload["annotations"] = annotations
+    return await request('pdf/edit/add', params, custom_payload=custom_payload)
+
+async def pdf_add(params: ConversionParams, **kwargs) -> BaseResponse:
+    """General PDF Add function that supports all PDF Add API parameters"""
+    custom_payload = {}
+    
+    # Add all supported parameters
+    for key, value in kwargs.items():
+        if value is not None and value != "":
+            custom_payload[key] = value
+    
+    return await request('pdf/edit/add', params, custom_payload=custom_payload)
+
+async def find_text_in_pdf(params: ConversionParams, search_string: str, regex_search: bool = False, word_matching_mode: str = None) -> BaseResponse:
+    custom_payload = {
+        "searchString": search_string,
+        "regexSearch": regex_search
+    }
+    if word_matching_mode:
+        custom_payload["wordMatchingMode"] = word_matching_mode
+    return await request('pdf/find', params, custom_payload=custom_payload)
+
+async def find_table_in_pdf(params: ConversionParams) -> BaseResponse:
+    return await request('pdf/find/table', params)
+
+async def make_pdf_searchable(params: ConversionParams) -> BaseResponse:
+    return await request('pdf/makesearchable', params)
+
+async def make_pdf_unsearchable(params: ConversionParams) -> BaseResponse:
+    return await request('pdf/makeunsearchable', params)
+
+async def get_pdf_info(params: ConversionParams) -> BaseResponse:
+    return await request('pdf/info', params)
+
+async def add_pdf_password(params: ConversionParams, **kwargs) -> BaseResponse:
+    return await request('pdf/security/add', params, custom_payload=kwargs)
+
+async def remove_pdf_password(params: ConversionParams) -> BaseResponse:
+    return await request('pdf/security/remove', params)
+
+async def parse_invoice(params: ConversionParams) -> BaseResponse:
+    return await request('ai-invoice-parser', params)
+
+async def extract_pdf_attachments(params: ConversionParams) -> BaseResponse:
+    return await request('pdf/attachments/extract', params)
+
+async def request(endpoint: str, params: ConversionParams, custom_payload: dict = None) -> BaseResponse:
+    payload = params.parse_payload(async_mode=True)
+    if custom_payload:
+        payload.update(custom_payload)
+        
+    try:
+        async with PDFCoClient() as client:
+            url = f"/v1/{endpoint}"
+            print(f"Requesting {url} with payload {payload}", file=sys.stderr)
+            response = await client.post(url, json=payload)
+            print(f"response: {response}", file=sys.stderr)
+            json_data = response.json()
+            return BaseResponse(
+                status="working",
+                content=json_data,
+                credits_used=json_data.get("credits"),
+                credits_remaining=json_data.get("remainingCredits"),
+                tips=f"You **should** use the 'wait_job_completion' tool to wait for the job [{json_data.get('jobId')}] to complete if a jobId is present.",
+            )
+    except Exception as e:
+        return BaseResponse(
+            status="error",
+            content=f'{type(e)}: {[arg for arg in e.args if arg]}',
+        )

pdfco/mcp/tools/apis/conversion.py

@@ -0,0 +1,371 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import convert_to, convert_from
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+from pydantic import Field
+    
+
+@mcp.tool()
+async def pdf_to_json(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images into JSON representation with text, fonts, images, vectors, and formatting preserved using the /pdf/convert/to/json2 endpoint.
+    Ref: https://developer.pdf.co/api-reference/pdf-to-json/basic.md
+    """
+    return await convert_to("pdf", "json2", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def pdf_to_csv(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables.
+    Ref: https://developer.pdf.co/api-reference/pdf-to-csv.md
+    """
+    return await convert_to("pdf", "csv", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def pdf_to_text(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images to text with layout preserved.
+    Ref: https://developer.pdf.co/api-reference/pdf-to-text/basic.md
+    """
+    return await convert_to("pdf", "text", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def pdf_to_xls(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images to XLS (Excel 97-2003) format.
+    Ref: https://developer.pdf.co/api-reference/pdf-to-excel/xls.md
+    """
+    return await convert_to("pdf", "xls", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def pdf_to_xlsx(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images to XLSX (Excel 2007+) format.        
+    Ref: https://developer.pdf.co/api-reference/pdf-to-excel/xlsx.md
+    """
+    return await convert_to("pdf", "xlsx", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def pdf_to_xml(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images to XML format.
+    Ref: https://developer.pdf.co/api-reference/pdf-to-xml.md
+    """
+    return await convert_to("pdf", "xml", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def pdf_to_html(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images to HTML format.
+    Ref: https://developer.pdf.co/api-reference/pdf-to-html.md
+    """
+    return await convert_to("pdf", "html", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def pdf_to_image(
+    url: str = Field(description="URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    unwrap: bool = Field(description="Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)", default=False),
+    rect: str = Field(description="Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)", default=""),
+    lang: str = Field(description="Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')", default="eng"),
+    line_grouping: str = Field(description="Enables line grouping within table cells when set to '1'. (Optional)", default="0"),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+    type: str = Field(description="Type of image to convert to. (jpg, png, webp, tiff) (Optional)", default="jpg", choices=["jpg", "png", "webp", "tiff"]),
+) -> BaseResponse:
+    """
+    Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF).
+    Ref:
+     - https://developer.pdf.co/api-reference/pdf-to-image/jpg.md
+     - https://developer.pdf.co/api-reference/pdf-to-image/png.md
+     - https://developer.pdf.co/api-reference/pdf-to-image/webp.md
+     - https://developer.pdf.co/api-reference/pdf-to-image/tiff.md
+    """
+    return await convert_to("pdf", type, ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, unwrap=unwrap, rect=rect, lang=lang, line_grouping=line_grouping, password=password, name=name))
+
+@mcp.tool()
+async def document_to_pdf(
+    url: str = Field(description="URL to the source file (DOC, DOCX, RTF, TXT, XPS). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    autosize: bool = Field(description="Controls automatic page sizing. If true, page dimensions adjust to content. If false, uses worksheet’s page setup. (Optional)", default=False),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert various document types (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) into PDF.
+    Ref: https://developer.pdf.co/api-reference/pdf-from-document/doc.md
+    """
+    return await convert_from("pdf", "doc", ConversionParams(url=url, autosize=autosize, httpusername=httpusername, httppassword=httppassword, pages=pages, name=name))
+
+@mcp.tool()
+async def csv_to_pdf(
+    url: str = Field(description="URL to the source file (CSV, XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    autosize: bool = Field(description="Controls automatic page sizing. If true, page dimensions adjust to content. If false, uses worksheet’s page setup. (Optional)", default=False),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert CSV or spreadsheet files (XLS, XLSX) to PDF.
+    Ref: https://developer.pdf.co/api-reference/pdf-from-document/csv.md
+    """
+    return await convert_from("pdf", "csv", ConversionParams(url=url, autosize=autosize, httpusername=httpusername, httppassword=httppassword, pages=pages, name=name))
+
+@mcp.tool()
+async def image_to_pdf(
+    url: str = Field(description="URL to the source file (JPG, PNG, TIFF). Multiple files are supported (by providing a comma-separated list of URLs). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    pages: str = Field(description="Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert various image formats (JPG, PNG, TIFF) to PDF.
+    Ref: https://developer.pdf.co/api-reference/pdf-from-image.md
+    ```
+    """
+    return await convert_from("pdf", "image", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, name=name))
+
+@mcp.tool()
+async def webpage_to_pdf(
+    url: str = Field(description="URL to the source file (external webpage URL)."),
+    margins: str = Field(description="Set to CSS style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left). (Optional)", default=""),
+    paperSize: str = Field(description="A4 is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by space like this: 200 300, 200px 300px, 200mm 300mm, 20cm 30cm or 6in 8in. (Optional)", default=""),
+    orientation: str = Field(description="Set to Portrait or Landscape. Portrait is set by default. (Optional)", default=""),
+    printBackground: bool = Field(description="true by default. Set to false to disable printing of background. (Optional)", default=True),
+    mediaType: str = Field(description="Uses print by default. Set to screen to convert HTML as it appears in a browser or print to convert as it appears for printing or none to set none as mediaType for CSS styles. (Optional)", default=""),
+    DoNotWaitFullLoad: bool = Field(description="false by default. Set to true to skip waiting for full load (like full video load etc. that may affect the total conversion time). (Optional)", default=False),
+    header: str = Field(description="User definable HTML for the header to be applied on every page header. (Optional)", default=""),
+    footer: str = Field(description="User definable HTML for the footer to be applied on every page footer. (Optional)", default=""),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert external webpage URL to PDF.
+    Ref: https://developer.pdf.co/api-reference/pdf-from-url.md
+    
+    The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them:
+    - date: formatted print date
+    - title: document title
+    - url: document location
+    - pageNumber: current page number
+    - totalPages: total pages in the document
+    - img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string.
+    For example, the following markup will generate Page N of NN page numbering:
+    ```html
+    <span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>
+    """
+    return await convert_from("pdf", "url", ConversionParams(url=url, margins=margins, paperSize=paperSize, orientation=orientation, printBackground=printBackground, mediaType=mediaType, DoNotWaitFullLoad=DoNotWaitFullLoad, header=header, footer=footer, httpusername=httpusername, httppassword=httppassword, name=name))
+
+@mcp.tool()
+async def html_to_pdf(
+    html: str = Field(description="Input HTML code to be converted. To convert the link to a PDF use the /pdf/convert/from/url endpoint instead. If it is a local file, just pass the file content as a string."),
+    margins: str = Field(description="Set to CSS style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left). (Optional)", default=""),
+    paperSize: str = Field(description="A4 is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by space like this: 200 300, 200px 300px, 200mm 300mm, 20cm 30cm or 6in 8in. (Optional)", default=""),
+    orientation: str = Field(description="Set to Portrait or Landscape. Portrait is set by default. (Optional)", default=""),
+    printBackground: bool = Field(description="true by default. Set to false to disable printing of background. (Optional)", default=True),
+    mediaType: str = Field(description="Uses print by default. Set to screen to convert HTML as it appears in a browser or print to convert as it appears for printing or none to set none as mediaType for CSS styles. (Optional)", default=""),
+    DoNotWaitFullLoad: bool = Field(description="false by default. Set to true to skip waiting for full load (like full video load etc. that may affect the total conversion time). (Optional)", default=False),
+    header: str = Field(description="User definable HTML for the header to be applied on every page header. (Optional)", default=""),
+    footer: str = Field(description="User definable HTML for the footer to be applied on every page footer. (Optional)", default=""),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert HTML to PDF.
+    Ref: https://developer.pdf.co/api-reference/pdf-from-html/convert.md
+    
+    The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them:
+    - date: formatted print date
+    - title: document title
+    - url: document location
+    - pageNumber: current page number
+    - totalPages: total pages in the document
+    - img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string.
+    For example, the following markup will generate Page N of NN page numbering:
+    ```html
+    <span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>
+    """
+    return await convert_from("pdf", "html", ConversionParams(html=html, margins=margins, paperSize=paperSize, orientation=orientation, printBackground=printBackground, mediaType=mediaType, DoNotWaitFullLoad=DoNotWaitFullLoad, header=header, footer=footer, httpusername=httpusername, httppassword=httppassword, name=name))
+
+@mcp.tool()
+async def email_to_pdf(
+    url: str = Field(description="URL to the source file (MSG, EML). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    embedAttachments: bool = Field(description="Set to true to automatically embeds all attachments from original input email MSG or EML files into the final output PDF. Set it to false if you don’t want to embed attachments so it will convert only the body of the input email. True by default.", default=True),
+    convertAttachments: bool = Field(description="Set to false if you don’t want to convert attachments from the original email and want to embed them as original files (as embedded PDF attachments). Converts attachments that are supported by the PDF.co API (DOC, DOCx, HTML, PNG, JPG etc.) into PDF format and then merges into output final PDF. Non-supported file types are added as PDF attachments (Adobe Reader or another viewer may be required to view PDF attachments).", default=True),
+    margins: str = Field(description="Set to CSS style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left). (Optional)", default=""),
+    paperSize: str = Field(description="A4 is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by space like this: 200 300, 200px 300px, 200mm 300mm, 20cm 30cm or 6in 8in. (Optional)", default=""),
+    orientation: str = Field(description="Set to Portrait or Landscape. Portrait is set by default. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert email to PDF.
+    Ref: https://developer.pdf.co/api-reference/pdf-from-email.md
+    """
+    return await convert_from("pdf", "email", ConversionParams(url=url, embedAttachments=embedAttachments, convertAttachments=convertAttachments, margins=margins, paperSize=paperSize, orientation=orientation))
+    
+@mcp.tool()
+async def excel_to_csv(
+    url: str = Field(description="URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+    worksheetIndex: str = Field(description="Index of the worksheet to convert. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert Excel(XLS, XLSX) to CSV.
+    Ref: https://developer.pdf.co/api-reference/convert-from-excel/csv.md
+    """
+    return await convert_to("xls", "csv", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex))
+
+@mcp.tool()
+async def excel_to_json(
+    url: str = Field(description="URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+    worksheetIndex: str = Field(description="Index of the worksheet to convert. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert Excel(XLS, XLSX) to JSON.
+    Ref: https://developer.pdf.co/api-reference/convert-from-excel/json.md
+    """
+    return await convert_to("xls", "json", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex))
+
+@mcp.tool()
+async def excel_to_html(
+    url: str = Field(description="URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+    worksheetIndex: str = Field(description="Index of the worksheet to convert. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert Excel(XLS, XLSX) to HTML.
+    Ref: https://developer.pdf.co/api-reference/convert-from-excel/html.md
+    """
+    return await convert_to("xls", "html", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex))
+
+@mcp.tool()
+async def excel_to_txt(
+    url: str = Field(description="URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+    worksheetIndex: str = Field(description="Index of the worksheet to convert. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert Excel(XLS, XLSX) to TXT.
+    Ref: https://developer.pdf.co/api-reference/convert-from-excel/text.md
+    """
+    return await convert_to("xls", "txt", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex))
+
+@mcp.tool()
+async def excel_to_xml(
+    url: str = Field(description="URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+    worksheetIndex: str = Field(description="Index of the worksheet to convert. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert Excel(XLS, XLSX) to XML.
+    Ref: https://developer.pdf.co/api-reference/convert-from-excel/xml.md
+    """
+    return await convert_to("xls", "xml", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex))
+
+@mcp.tool()
+async def excel_to_pdf(
+    url: str = Field(description="URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
+    httpusername: str = Field(description="HTTP auth user name if required to access source url. (Optional)", default=""),
+    httppassword: str = Field(description="HTTP auth password if required to access source url. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+    worksheetIndex: str = Field(description="Index of the worksheet to convert. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Convert Excel(XLS, XLSX) to PDF.
+    Ref: https://developer.pdf.co/api-reference/convert-from-excel/pdf.md
+    """
+    return await convert_to("xls", "pdf", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex))