pdfco-mcp 0.0.3__py3-none-any.whl → 0.0.5__py3-none-any.whl

pdfco/mcp/tools/apis/document.py

@@ -4,13 +4,27 @@ from pdfco.mcp.models import BaseResponse, ConversionParams
 
 from pydantic import Field
 
+
 @mcp.tool()
 async def pdf_info_reader(
-    url: str = Field(description="URL to the source PDF 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=""),
-    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URL to the source PDF 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="",
+    ),
+    password: str = Field(
+        description="Password of the PDF file. (Optional)", default=""
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more.
@@ -22,5 +36,5 @@ async def pdf_info_reader(
         httppassword=httppassword,
         password=password,
     )
-    
-    return await get_pdf_info(params, api_key=api_key) 
+
+    return await get_pdf_info(params, api_key=api_key)

pdfco/mcp/tools/apis/editing.py

@@ -8,42 +8,72 @@ from typing import List, Any
 
 @mcp.tool()
 async def pdf_add_annotations_images_fields(
-    url: str = Field(description="URL to the source PDF 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=""),
-    password: str = Field(description="Password for the PDF file. (Optional)", default=""),
-    name: str = Field(description="File name for the generated output. (Optional)", default=""),
-    annotations: List[Any] = Field(description="Array of annotation objects to add text, links, shapes, etc. Each object can have: 'text' (string), 'x' (number), 'y' (number), 'size' (number), 'pages' (string), 'color' (string hex), 'link' (string URL), 'fontName' (string), 'fontItalic' (boolean), 'fontBold' (boolean), 'fontStrikeout' (boolean), 'fontUnderline' (boolean). (Optional)", default=[]),
-    images: List[Any] = Field(description="Array of image objects to add images to PDF. Each object can have: 'url' (string), 'x' (number), 'y' (number), 'width' (number), 'height' (number), 'pages' (string). (Optional)", default=[]),
-    fields: List[Any] = Field(description="Array of form field objects to fill PDF form fields. Each object can have: 'fieldName' (string), 'pages' (string), 'text' (string), 'fontName' (string), 'size' (number), 'fontBold' (boolean), 'fontItalic' (boolean), 'fontStrikeout' (boolean), 'fontUnderline' (boolean). (Optional)", default=[]),
-    expiration: int = Field(description="Set the expiration time for the output link in minutes. After this specified duration, any generated output file(s) will be automatically deleted. (Optional)", default=60),
+    url: str = Field(
+        description="URL to the source PDF 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="",
+    ),
+    password: str = Field(
+        description="Password for the PDF file. (Optional)", default=""
+    ),
+    name: str = Field(
+        description="File name for the generated output. (Optional)", default=""
+    ),
+    annotations: List[Any] = Field(
+        description="Array of annotation objects to add text, links, shapes, etc. Each object can have: 'text' (string), 'x' (number), 'y' (number), 'size' (number), 'pages' (string), 'color' (string hex), 'link' (string URL), 'fontName' (string), 'fontItalic' (boolean), 'fontBold' (boolean), 'fontStrikeout' (boolean), 'fontUnderline' (boolean). (Optional)",
+        default=[],
+    ),
+    images: List[Any] = Field(
+        description="Array of image objects to add images to PDF. Each object can have: 'url' (string), 'x' (number), 'y' (number), 'width' (number), 'height' (number), 'pages' (string). (Optional)",
+        default=[],
+    ),
+    fields: List[Any] = Field(
+        description="Array of form field objects to fill PDF form fields. Each object can have: 'fieldName' (string), 'pages' (string), 'text' (string), 'fontName' (string), 'size' (number), 'fontBold' (boolean), 'fontItalic' (boolean), 'fontStrikeout' (boolean), 'fontUnderline' (boolean). (Optional)",
+        default=[],
+    ),
+    expiration: int = Field(
+        description="Set the expiration time for the output link in minutes. After this specified duration, any generated output file(s) will be automatically deleted. (Optional)",
+        default=60,
+    ),
     encrypt: bool = Field(description="Encrypt output file. (Optional)", default=False),
-    flatten: bool = Field(description="Flatten filled form fields and annotations into PDF content. Set to true to disable editing of filled form fields in the output PDF. (Optional)", default=False),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    flatten: bool = Field(
+        description="Flatten filled form fields and annotations into PDF content. Set to true to disable editing of filled form fields in the output PDF. (Optional)",
+        default=False,
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Add text, images, forms, other PDFs, fill forms, links to external sites and external PDF files. You can update or modify PDF and scanned PDF files.
-    
+
     This tool supports three main ways to add content:
-    
+
     1. **annotations**: Add text, links, shapes, etc.
        Properties: text, x, y, size, pages, color, link, fontName, fontItalic, fontBold, fontStrikeout, fontUnderline
-       
-    2. **images**: Add images or other PDF content  
+
+    2. **images**: Add images or other PDF content
        Properties: url, x, y, width, height, pages
-       
+
     3. **fields**: Fill existing form fields
        Properties: fieldName, pages, text, fontName, size, fontBold, fontItalic, fontStrikeout, fontUnderline
-    
+
     Example annotations:
     [{"text": "Sample Text - Click here to test link", "x": 250, "y": 240, "size": 24, "pages": "0-", "color": "CCBBAA", "link": "https://pdf.co/", "fontName": "Comic Sans MS", "fontItalic": true, "fontBold": true, "fontStrikeout": false, "fontUnderline": true}]
-    
+
     Example images:
     [{"url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png", "x": 270, "y": 150, "width": 159, "height": 43, "pages": "0"}]
-    
+
     Example fields:
     [{"fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]", "pages": "1", "text": "Joan B.", "fontName": "Arial", "size": 6, "fontBold": true, "fontItalic": true, "fontStrikeout": true, "fontUnderline": true}]
-    
+
     Ref: https://developer.pdf.co/api-reference/pdf-add.md
     """
     params = ConversionParams(
@@ -54,10 +84,10 @@ async def pdf_add_annotations_images_fields(
         name=name,
         expiration=expiration,
     )
-    
+
     # Prepare additional parameters
     add_params = {}
-    
+
     if annotations:
         add_params["annotations"] = annotations
     if images:
@@ -68,5 +98,5 @@ async def pdf_add_annotations_images_fields(
         add_params["encrypt"] = encrypt
     if flatten:
         add_params["flatten"] = flatten
-    
-    return await pdf_add(params, **add_params, api_key=api_key) 
+
+    return await pdf_add(params, **add_params, api_key=api_key)

pdfco/mcp/tools/apis/extraction.py

@@ -7,29 +7,43 @@ from pydantic import Field
 
 @mcp.tool()
 async def ai_invoice_parser(
-    url: str = Field(description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     AI Invoice Parser: Extracts data from invoices using AI.
     Ref: https://developer.pdf.co/api-reference/ai-invoice-parser.md
     """
-    
+
     # Pass arguments directly; ConversionParams now handles str with default=None
     params = ConversionParams(
         url=url,
     )
-    
+
     return await parse_invoice(params, api_key=api_key)
 
 
 @mcp.tool()
 async def extract_attachments(
     url: str = Field(description="URL to the source PDF file."),
-    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=""),
+    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="",
+    ),
     password: str = Field(description="Password of PDF file. (Optional)", default=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Extracts attachments from a source PDF file.

pdfco/mcp/tools/apis/file.py

@@ -1,14 +1,17 @@
-from pathlib import Path
 from pdfco.mcp.server import mcp
 from pdfco.mcp.services.client import PDFCoClient
 from pdfco.mcp.models import BaseResponse
 
 from pydantic import Field
 
+
 @mcp.tool()
 async def upload_file(
     file_path: str = Field(description="The absolute path to the file to upload"),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None)
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Upload a file to the PDF.co API
@@ -16,13 +19,14 @@ async def upload_file(
     try:
         async with PDFCoClient(api_key=api_key) as client:
             response = await client.post(
-                "/v1/file/upload", 
+                "/v1/file/upload",
                 files={
-                "file": open(file_path, "rb"),
-            })
+                    "file": open(file_path, "rb"),
+                },
+            )
             res = response.json()
             return BaseResponse(
-                status='success' if res["status"] == 200 else 'error',
+                status="success" if res["status"] == 200 else "error",
                 content=res,
                 tips=f"You can use the url {res['url']} to access the file",
             )

pdfco/mcp/tools/apis/form.py

@@ -7,11 +7,22 @@ from pydantic import Field
 
 @mcp.tool()
 async def read_pdf_forms_info(
-    url: str = Field(description="URL to the source PDF 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=""),
+    url: str = Field(
+        description="URL to the source PDF 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="",
+    ),
     password: str = Field(description="Password of PDF file. (Optional)", default=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Extracts information about fillable PDF fields from an input PDF file.
@@ -23,17 +34,33 @@ async def read_pdf_forms_info(
         httppassword=httppassword,
         password=password,
     )
-    
+
     return await get_pdf_form_fields_info(params, api_key=api_key)
 
+
 @mcp.tool(name="fill_forms")
 async def fill_pdf_forms(
-    url: str = Field(description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
-    fields: list = Field(description="List of fields to fill. Each field is a dict with 'fieldName', 'pages', and 'text' properties."),
-    name: str = Field(description="File name for the generated output. (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=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."
+    ),
+    fields: list = Field(
+        description="List of fields to fill. Each field is a dict with 'fieldName', 'pages', and 'text' properties."
+    ),
+    name: str = Field(
+        description="File name for the generated output. (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="",
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Fill existing form fields in a PDF document.
@@ -48,7 +75,7 @@ async def fill_pdf_forms(
     ]
 
     Use 'read_pdf_forms_info' first to get the fieldName values of the form.
-    
+
     Ref: https://developer.pdf.co/api-reference/pdf-add#create-fillable-pdf-forms.md
     """
     params = ConversionParams(
@@ -57,17 +84,33 @@ async def fill_pdf_forms(
         httppassword=httppassword,
         name=name,
     )
-    
+
     return await fill_pdf_form_fields(params, fields=fields, api_key=api_key)
 
+
 @mcp.tool(name="create_fillable_forms")
 async def create_fillable_forms(
-    url: str = Field(description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
-    annotations: list = Field(description="List of form annotations to create. Each annotation can be a textfield or checkbox with properties like 'x', 'y', 'size', 'pages', 'type', and 'id'."),
-    name: str = Field(description="File name for the generated output. (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=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."
+    ),
+    annotations: list = Field(
+        description="List of form annotations to create. Each annotation can be a textfield or checkbox with properties like 'x', 'y', 'size', 'pages', 'type', and 'id'."
+    ),
+    name: str = Field(
+        description="File name for the generated output. (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="",
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Create new fillable form elements in a PDF document.
@@ -101,5 +144,5 @@ async def create_fillable_forms(
         httppassword=httppassword,
         name=name,
     )
-    
-    return await fill_pdf_form_fields(params, annotations=annotations, api_key=api_key) 
+
+    return await fill_pdf_form_fields(params, annotations=annotations, api_key=api_key)

pdfco/mcp/tools/apis/job.py

@@ -6,10 +6,14 @@ from pdfco.mcp.models import BaseResponse
 
 from pydantic import Field
 
+
 @mcp.tool()
 async def get_job_check(
     job_id: str = Field(description="The ID of the job to get the status of"),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None)
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Check the status and results of a job
@@ -22,9 +26,12 @@ async def get_job_check(
     """
     try:
         async with PDFCoClient(api_key=api_key) as client:
-            response = await client.post("/v1/job/check", json={
-                "jobId": job_id,
-            })
+            response = await client.post(
+                "/v1/job/check",
+                json={
+                    "jobId": job_id,
+                },
+            )
             json_data = response.json()
             return BaseResponse(
                 status=json_data["status"],
@@ -39,12 +46,20 @@ async def get_job_check(
             content=str(e),
         )
 
+
 @mcp.tool()
 async def wait_job_completion(
     job_id: str = Field(description="The ID of the job to get the status of"),
-    interval: int = Field(description="The interval to check the status of the job (seconds)", default=1),
-    timeout: int = Field(description="The timeout to wait for the job to complete (seconds)", default=300),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None)
+    interval: int = Field(
+        description="The interval to check the status of the job (seconds)", default=1
+    ),
+    timeout: int = Field(
+        description="The timeout to wait for the job to complete (seconds)", default=300
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Wait for a job to complete

pdfco/mcp/tools/apis/modification.py

@@ -7,27 +7,64 @@ from pydantic import Field
 
 @mcp.tool()
 async def pdf_merge(
-    url: str = Field(description="URLs to the source files as a comma-separated list. Supports PDF, DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, images, and more. 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=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URLs to the source files as a comma-separated list. Supports PDF, DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, images, and more. 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=""
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Merge PDF from two or more PDF, DOC, XLS, images, even ZIP with documents and images into a new PDF.
     Ref: https://developer.pdf.co/api-reference/merge/various-files.md
     """
-    return await merge_pdf(ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name), api_key=api_key)
+    return await merge_pdf(
+        ConversionParams(
+            url=url, httpusername=httpusername, httppassword=httppassword, name=name
+        ),
+        api_key=api_key,
+    )
+
 
 @mcp.tool()
 async def pdf_split(
-    url: str = Field(description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
-    pages: str = Field(description="Comma-separated indices of pages (or page ranges) that you want to use. The first-page index is 1. For example: '1,3,5-7' or '1-2,4-'. Use '*' to split every page into separate 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=""),
-    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
-    name: str = Field(description="Base file name for the generated output files. (Optional)", default=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."
+    ),
+    pages: str = Field(
+        description="Comma-separated indices of pages (or page ranges) that you want to use. The first-page index is 1. For example: '1,3,5-7' or '1-2,4-'. Use '*' to split every page into separate 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="",
+    ),
+    password: str = Field(
+        description="Password of the PDF file. (Optional)", default=""
+    ),
+    name: str = Field(
+        description="Base file name for the generated output files. (Optional)",
+        default="",
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Split a PDF into multiple PDF files using page indexes or page ranges.
@@ -41,5 +78,5 @@ async def pdf_split(
         password=password,
         name=name,
     )
-    
+
     return await split_pdf(params, api_key=api_key)

pdfco/mcp/tools/apis/search.py

@@ -7,15 +7,39 @@ from pydantic import Field
 
 @mcp.tool(name="find_text")
 async def find_text(
-    url: str = Field(description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."),
-    searchString: str = Field(description="Text to search. Can support regular expressions if regexSearch is set to True."),
-    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 list of page indices (or ranges) to process. Leave empty for all pages. Example: '0,2-5,7-'. The first-page index is 0. (Optional)", default=""),
-    wordMatchingMode: str = Field(description="Values can be either SmartMatch, ExactMatch, or None. (Optional)", default=None),
-    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
-    regexSearch: bool = Field(description="Set to True to enable regular expressions in the search string. (Optional)", default=False),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files."
+    ),
+    searchString: str = Field(
+        description="Text to search. Can support regular expressions if regexSearch is set to True."
+    ),
+    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 list of page indices (or ranges) to process. Leave empty for all pages. Example: '0,2-5,7-'. The first-page index is 0. (Optional)",
+        default="",
+    ),
+    wordMatchingMode: str = Field(
+        description="Values can be either SmartMatch, ExactMatch, or None. (Optional)",
+        default=None,
+    ),
+    password: str = Field(
+        description="Password of the PDF file. (Optional)", default=""
+    ),
+    regexSearch: bool = Field(
+        description="Set to True to enable regular expressions in the search string. (Optional)",
+        default=False,
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Find text in PDF and get coordinates. Supports regular expressions.
@@ -28,18 +52,36 @@ async def find_text(
         pages=pages,
         password=password,
     )
-    
-    return await find_text_in_pdf(params, searchString, regexSearch, wordMatchingMode, api_key=api_key)
+
+    return await find_text_in_pdf(
+        params, searchString, regexSearch, wordMatchingMode, api_key=api_key
+    )
 
 
 @mcp.tool(name="find_table")
 async def find_table(
-    url: str = Field(description="URL to the source PDF 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 list of page indices (or ranges) to process. Leave empty for all pages. Example: '0,2-5,7-'. The first-page index is 0. (Optional)", default=""),
-    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
-    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
+    url: str = Field(
+        description="URL to the source PDF 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 list of page indices (or ranges) to process. Leave empty for all pages. Example: '0,2-5,7-'. The first-page index is 0. (Optional)",
+        default="",
+    ),
+    password: str = Field(
+        description="Password of the PDF file. (Optional)", default=""
+    ),
+    api_key: str = Field(
+        description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
+        default=None,
+    ),
 ) -> BaseResponse:
     """
     Find tables in PDF and get their coordinates.
@@ -52,5 +94,5 @@ async def find_table(
         pages=pages,
         password=password,
     )
-    
-    return await find_table_in_pdf(params, api_key=api_key) 
+
+    return await find_table_in_pdf(params, api_key=api_key)