pdfco-mcp 0.1.0__py3-none-any.whl

pdfco/mcp/tools/apis/document.py

@@ -0,0 +1,25 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import get_pdf_info
+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=""),
+) -> BaseResponse:
+    """
+    Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more.
+    Ref: https://developer.pdf.co/api-reference/pdf-info-reader.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        password=password,
+    )
+    
+    return await get_pdf_info(params) 

pdfco/mcp/tools/apis/editing.py

@@ -0,0 +1,71 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import pdf_add
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+from pydantic import Field
+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),
+    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),
+) -> 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  
+       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(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        password=password,
+        name=name,
+        expiration=expiration,
+    )
+    
+    # Prepare additional parameters
+    add_params = {}
+    
+    if annotations:
+        add_params["annotations"] = annotations
+    if images:
+        add_params["images"] = images
+    if fields:
+        add_params["fields"] = fields
+    if encrypt:
+        add_params["encrypt"] = encrypt
+    if flatten:
+        add_params["flatten"] = flatten
+    
+    return await pdf_add(params, **add_params) 

pdfco/mcp/tools/apis/extraction.py

@@ -0,0 +1,42 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import parse_invoice, extract_pdf_attachments
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+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."),
+) -> 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 Optional[str] with default=None
+    params = ConversionParams(
+        url=url,
+    )
+    
+    return await parse_invoice(params)
+
+
+@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=""),
+    password: str = Field(description="Password of PDF file. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Extracts attachments from a source PDF file.
+    Ref: https://developer.pdf.co/api-reference/pdf-extract-attachments.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername if httpusername else None,
+        httppassword=httppassword if httppassword else None,
+        password=password if password else None,
+    )
+    return await extract_pdf_attachments(params)

pdfco/mcp/tools/apis/file.py

@@ -0,0 +1,32 @@
+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"), 
+) -> BaseResponse:
+    """
+    Upload a file to the PDF.co API
+    """
+    try:
+        async with PDFCoClient() as client:
+            response = await client.post(
+                "/v1/file/upload", 
+                files={
+                "file": open(file_path, "rb"),
+            })
+            res = response.json()
+            return BaseResponse(
+                status='success' if res["status"] == 200 else 'error',
+                content=res,
+                tips=f"You can use the url {res['url']} to access the file",
+            )
+    except Exception as e:
+        return BaseResponse(
+            status="error",
+            content=str(e),
+        )

pdfco/mcp/tools/apis/form.py

@@ -0,0 +1,102 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import get_pdf_form_fields_info, fill_pdf_form_fields
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+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=""),
+    password: str = Field(description="Password of PDF file. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Extracts information about fillable PDF fields from an input PDF file.
+    Ref: https://developer.pdf.co/api-reference/forms/info-reader.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        password=password,
+    )
+    
+    return await get_pdf_form_fields_info(params)
+
+@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=""),
+) -> BaseResponse:
+    """
+    Fill existing form fields in a PDF document.
+
+    Example fields format:
+    [
+        {
+            "fieldName": "field_name_from_form_info",
+            "pages": "1",
+            "text": "Value to fill"
+        }
+    ]
+
+    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(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        name=name,
+    )
+    
+    return await fill_pdf_form_fields(params, fields=fields)
+
+@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=""),
+) -> BaseResponse:
+    """
+    Create new fillable form elements in a PDF document.
+
+    Example annotations format:
+    [
+        {
+            "text": "prefilled text",
+            "x": 10,
+            "y": 30,
+            "size": 12,
+            "pages": "0-",
+            "type": "TextField",
+            "id": "textfield1"
+        },
+        {
+            "x": 100,
+            "y": 150,
+            "size": 12,
+            "pages": "0-",
+            "type": "Checkbox",
+            "id": "checkbox1"
+        }
+    ]
+
+    Ref: https://developer.pdf.co/api-reference/pdf-add#create-fillable-pdf-forms.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        name=name,
+    )
+    
+    return await fill_pdf_form_fields(params, annotations=annotations) 

pdfco/mcp/tools/apis/job.py

@@ -0,0 +1,82 @@
+import asyncio
+import time
+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 get_job_check(
+    job_id: str = Field(description="The ID of the job to get the status of")
+) -> BaseResponse:
+    """
+    Check the status and results of a job
+    Status can be:
+    - working: background job is currently in work or does not exist.
+    - success: background job was successfully finished.
+    - failed: background job failed for some reason (see message for more details).
+    - aborted: background job was aborted.
+    - unknown: unknown background job id. Available only when force is set to true for input request.
+    """
+    try:
+        async with PDFCoClient() as client:
+            response = await client.post("/v1/job/check", json={
+                "jobId": job_id,
+            })
+            json_data = response.json()
+            return BaseResponse(
+                status=json_data["status"],
+                content=json_data,
+                credits_used=json_data.get("credits"),
+                credits_remaining=json_data.get("remainingCredits"),
+                tips="You can download the result if status is success",
+            )
+    except Exception as e:
+        return BaseResponse(
+            status="error",
+            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)
+) -> BaseResponse:
+    """
+    Wait for a job to complete
+    """
+    start_time = time.time()
+    job_check_count = 0
+    credits_used = 0
+    credits_remaining = 0
+    while True:
+        response = await get_job_check(job_id)
+        job_check_count += 1
+        credits_used += response.credits_used
+        credits_remaining = response.credits_remaining
+        if response.status == "success":
+            return BaseResponse(
+                status="success",
+                content=response.content,
+                credits_used=credits_used,
+                credits_remaining=credits_remaining,
+                tips=f"Job check count: {job_check_count}",
+            )
+        elif response.status == "failed":
+            return BaseResponse(
+                status="error",
+                content=response.message,
+                credits_used=credits_used,
+                credits_remaining=credits_remaining,
+            )
+        await asyncio.sleep(interval)
+        if time.time() - start_time > timeout:
+            return BaseResponse(
+                status="error",
+                content="Job timed out",
+                credits_used=credits_used,
+                credits_remaining=credits_remaining,
+                tips=f"Job check count: {job_check_count}",
+            )

pdfco/mcp/tools/apis/modification.py

@@ -0,0 +1,43 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import merge_pdf, split_pdf
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+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=""),
+) -> 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))
+
+@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=""),
+) -> BaseResponse:
+    """
+    Split a PDF into multiple PDF files using page indexes or page ranges.
+    Ref: https://developer.pdf.co/api-reference/pdf-split/by-pages.md
+    """
+    params = ConversionParams(
+        url=url,
+        pages=pages,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        password=password,
+        name=name,
+    )
+    
+    return await split_pdf(params)

pdfco/mcp/tools/apis/search.py

@@ -0,0 +1,54 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import find_text_in_pdf, find_table_in_pdf
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+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),
+) -> BaseResponse:
+    """
+    Find text in PDF and get coordinates. Supports regular expressions.
+    Ref: https://developer.pdf.co/api-reference/pdf-find/basic.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        pages=pages,
+        password=password,
+    )
+    
+    return await find_text_in_pdf(params, searchString, regexSearch, wordMatchingMode)
+
+
+@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=""),
+) -> BaseResponse:
+    """
+    Find tables in PDF and get their coordinates.
+    Ref: https://developer.pdf.co/api-reference/pdf-find/table.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        pages=pages,
+        password=password,
+    )
+    
+    return await find_table_in_pdf(params) 

pdfco/mcp/tools/apis/searchable.py

@@ -0,0 +1,58 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import make_pdf_searchable, make_pdf_unsearchable
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+from pydantic import Field
+
+
+@mcp.tool()
+async def pdf_make_searchable(
+    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=""),
+    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"),
+    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=""),
+    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 scanned PDF documents or image files into a text-searchable PDF.
+    Runs OCR and adds an invisible text layer that can be used for text search.
+    Ref: https://developer.pdf.co/api-reference/pdf-change-text-searchable/searchable.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        lang=lang,
+        pages=pages,
+        password=password,
+        name=name,
+    )
+    
+    return await make_pdf_searchable(params)
+
+
+@mcp.tool()
+async def pdf_make_unsearchable(
+    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=""),
+    password: str = Field(description="Password of the PDF file. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Make existing PDF document non-searchable by removing the text layer from it.
+    Ref: https://developer.pdf.co/api-reference/pdf-change-text-searchable/unsearchable.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        pages=pages,
+        password=password,
+        name=name,
+    )
+    
+    return await make_pdf_unsearchable(params) 

pdfco/mcp/tools/apis/security.py

@@ -0,0 +1,96 @@
+from pdfco.mcp.server import mcp
+from pdfco.mcp.services.pdf import add_pdf_password, remove_pdf_password
+from pdfco.mcp.models import BaseResponse, ConversionParams
+
+from pydantic import Field
+
+
+@mcp.tool()
+async def pdf_add_password(
+    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."),
+    owner_password: str = Field(description="The main owner password that is used for document encryption and for setting/removing restrictions."),
+    user_password: str = Field(description="The optional user password will be asked for viewing and printing document.", default=""),
+    encryption_algorithm: str = Field(description="Encryption algorithm. Valid values: RC4_40bit, RC4_128bit, AES_128bit, AES_256bit. AES_128bit or higher is recommended.", default="AES_256bit"),
+    allow_accessibility_support: bool = Field(description="Allow or prohibit content extraction for accessibility needs.", default=False),
+    allow_assembly_document: bool = Field(description="Allow or prohibit assembling the document.", default=False),
+    allow_print_document: bool = Field(description="Allow or prohibit printing PDF document.", default=False),
+    allow_fill_forms: bool = Field(description="Allow or prohibit the filling of interactive form fields (including signature fields) in the PDF documents.", default=False),
+    allow_modify_document: bool = Field(description="Allow or prohibit modification of PDF document.", default=False),
+    allow_content_extraction: bool = Field(description="Allow or prohibit copying content from PDF document.", default=False),
+    allow_modify_annotations: bool = Field(description="Allow or prohibit interacting with text annotations and forms in PDF document.", default=False),
+    print_quality: str = Field(description="Allowed printing quality. Valid values: HighResolution, LowResolution.", 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 the PDF file if it's already password-protected. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Add password protection to a PDF file.
+    Ref: https://developer.pdf.co/api-reference/pdf-password/add.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        password=password,
+        name=name,
+    )
+    
+    additional_params = {
+        "ownerPassword": owner_password,
+    }
+    
+    if user_password is not None:
+        additional_params["userPassword"] = user_password
+    
+    if encryption_algorithm is not None:
+        additional_params["EncryptionAlgorithm"] = encryption_algorithm
+    
+    if allow_accessibility_support is not None:
+        additional_params["AllowAccessibilitySupport"] = allow_accessibility_support
+    
+    if allow_assembly_document is not None:
+        additional_params["AllowAssemblyDocument"] = allow_assembly_document
+    
+    if allow_print_document is not None:
+        additional_params["AllowPrintDocument"] = allow_print_document
+    
+    if allow_fill_forms is not None:
+        additional_params["AllowFillForms"] = allow_fill_forms
+    
+    if allow_modify_document is not None:
+        additional_params["AllowModifyDocument"] = allow_modify_document
+    
+    if allow_content_extraction is not None:
+        additional_params["AllowContentExtraction"] = allow_content_extraction
+    
+    if allow_modify_annotations is not None:
+        additional_params["AllowModifyAnnotations"] = allow_modify_annotations
+    
+    if print_quality is not None:
+        additional_params["PrintQuality"] = print_quality
+    
+    return await add_pdf_password(params, **additional_params)
+
+
+@mcp.tool()
+async def pdf_remove_password(
+    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 to be removed. (Optional)", default=""),
+    name: str = Field(description="File name for the generated output. (Optional)", default=""),
+) -> BaseResponse:
+    """
+    Remove password protection from a PDF file.
+    Ref: https://developer.pdf.co/api-reference/pdf-password/remove.md
+    """
+    params = ConversionParams(
+        url=url,
+        httpusername=httpusername,
+        httppassword=httppassword,
+        password=password,
+        name=name,
+    )
+    
+    return await remove_pdf_password(params) 

pdfco_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: pdfco-mcp
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: langchain-community>=0.3.21
+Requires-Dist: langchain[google-genai]>=0.3.23
+Requires-Dist: langgraph>=0.3.30
+Requires-Dist: mcp[cli]>=1.6.0
+Description-Content-Type: text/markdown
+
+# PDF.co MCP
+
+#### Sample `.cursor/mcp.json` for test in cursor
+```json
+{
+  "mcpServers": {
+    "pdfco": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/path/to/pdfco-mcp",
+        "run",
+        "main.py"
+      ],
+      "env": {
+        "X_API_KEY": "YOUR_TEST_KEY"
+      }
+    }
+  }
+}
+```