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

pdfco/mcp/__init__.py

@@ -1,8 +1,27 @@
+import sys
 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 len(sys.argv) > 1:
+        transport = sys.argv[1]
+        if transport == "stdio":
+            mcp.run(transport=transport)
+        elif transport == "sse":
+            if len(sys.argv) < 2:
+                raise ValueError("SSE transport requires a port number")
+            port = int(sys.argv[2])
+            mcp.run(transport=transport, host="0.0.0.0", port=port)
+        elif transport == "streamable-http":
+            if len(sys.argv) < 3:
+                raise ValueError("Streamable HTTP transport requires a port number and path")
+            port = int(sys.argv[2])
+            path = sys.argv[3]
+            mcp.run(transport=transport, host="0.0.0.0", port=port, path=path)
+        else:
+            raise ValueError(f"Invalid transport: {transport}")
+    else:
+        mcp.run(transport="stdio")
 
 if __name__ == "__main__":
     main()

pdfco/mcp/server.py

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

pdfco/mcp/services/client.py

@@ -1,7 +1,7 @@
 from contextlib import asynccontextmanager
 from httpx import AsyncClient
 import os, sys
-from typing import AsyncGenerator
+from typing import AsyncGenerator, Optional
 import importlib.metadata
 
 __BASE_URL = "https://api.pdf.co"
@@ -11,11 +11,19 @@ __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
+async def PDFCoClient(api_key: str = None) -> AsyncGenerator[AsyncClient, None]:
+    # Use provided API key, fall back to environment variable
+    x_api_key = api_key or X_API_KEY
+    
+    if not x_api_key:
+        raise ValueError("""API key is required. Please provide an API key as a parameter or set X_API_KEY in the environment variables.
+        
+        To get the API key:
+        1. Sign up at https://pdf.co
+        2. Get the API key from the dashboard
+        3. Either set it as an environment variable or provide it as a parameter
+        
+        Environment variable setup example (.cursor/mcp.json):
         ```json
         {
             "mcpServers": {
@@ -31,12 +39,14 @@ async def PDFCoClient() -> AsyncGenerator[AsyncClient, None]:
             }
         }
         ```
+        
+        Or provide the API key as a parameter when calling the tool.
         """)
     
     client = AsyncClient(
             base_url=__BASE_URL,
             headers={
-                "x-api-key": X_API_KEY,
+                "x-api-key": x_api_key,
                 "User-Agent": f"pdfco-mcp/{__version__}",
             },
         )

pdfco/mcp/services/pdf.py

@@ -2,30 +2,30 @@ 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_to(_from: str, _to: str, params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request(f'{_from}/convert/to/{_to}', params, api_key=api_key)
 
-async def convert_from(_to: str, _from: str, params: ConversionParams) -> BaseResponse:
-    return await request(f'{_to}/convert/from/{_from}', params)
+async def convert_from(_to: str, _from: str, params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request(f'{_to}/convert/from/{_from}', params, api_key=api_key)
 
-async def merge_pdf(params: ConversionParams) -> BaseResponse:
-    return await request(f'pdf/merge2', params)
+async def merge_pdf(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request(f'pdf/merge2', params, api_key=api_key)
 
-async def split_pdf(params: ConversionParams) -> BaseResponse:
-    return await request(f'pdf/split', params)
+async def split_pdf(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request(f'pdf/split', params, api_key=api_key)
 
-async def get_pdf_form_fields_info(params: ConversionParams) -> BaseResponse:
-    return await request('pdf/info/fields', params)
+async def get_pdf_form_fields_info(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('pdf/info/fields', params, api_key=api_key)
 
-async def fill_pdf_form_fields(params: ConversionParams, fields: list = None, annotations: list = None) -> BaseResponse:
+async def fill_pdf_form_fields(params: ConversionParams, fields: list = None, annotations: list = None, api_key: str = 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)
+    return await request('pdf/edit/add', params, custom_payload=custom_payload, api_key=api_key)
 
-async def pdf_add(params: ConversionParams, **kwargs) -> BaseResponse:
+async def pdf_add(params: ConversionParams, api_key: str = None, **kwargs) -> BaseResponse:
     """General PDF Add function that supports all PDF Add API parameters"""
     custom_payload = {}
     
@@ -34,48 +34,48 @@ async def pdf_add(params: ConversionParams, **kwargs) -> BaseResponse:
         if value is not None and value != "":
             custom_payload[key] = value
     
-    return await request('pdf/edit/add', params, custom_payload=custom_payload)
+    return await request('pdf/edit/add', params, custom_payload=custom_payload, api_key=api_key)
 
-async def find_text_in_pdf(params: ConversionParams, search_string: str, regex_search: bool = False, word_matching_mode: str = None) -> BaseResponse:
+async def find_text_in_pdf(params: ConversionParams, search_string: str, regex_search: bool = False, word_matching_mode: str = None, api_key: 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)
+    return await request('pdf/find', params, custom_payload=custom_payload, api_key=api_key)
 
-async def find_table_in_pdf(params: ConversionParams) -> BaseResponse:
-    return await request('pdf/find/table', params)
+async def find_table_in_pdf(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('pdf/find/table', params, api_key=api_key)
 
-async def make_pdf_searchable(params: ConversionParams) -> BaseResponse:
-    return await request('pdf/makesearchable', params)
+async def make_pdf_searchable(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('pdf/makesearchable', params, api_key=api_key)
 
-async def make_pdf_unsearchable(params: ConversionParams) -> BaseResponse:
-    return await request('pdf/makeunsearchable', params)
+async def make_pdf_unsearchable(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('pdf/makeunsearchable', params, api_key=api_key)
 
-async def get_pdf_info(params: ConversionParams) -> BaseResponse:
-    return await request('pdf/info', params)
+async def get_pdf_info(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('pdf/info', params, api_key=api_key)
 
-async def add_pdf_password(params: ConversionParams, **kwargs) -> BaseResponse:
-    return await request('pdf/security/add', params, custom_payload=kwargs)
+async def add_pdf_password(params: ConversionParams, api_key: str = None, **kwargs) -> BaseResponse:
+    return await request('pdf/security/add', params, custom_payload=kwargs, api_key=api_key)
 
-async def remove_pdf_password(params: ConversionParams) -> BaseResponse:
-    return await request('pdf/security/remove', params)
+async def remove_pdf_password(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('pdf/security/remove', params, api_key=api_key)
 
-async def parse_invoice(params: ConversionParams) -> BaseResponse:
-    return await request('ai-invoice-parser', params)
+async def parse_invoice(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('ai-invoice-parser', params, api_key=api_key)
 
-async def extract_pdf_attachments(params: ConversionParams) -> BaseResponse:
-    return await request('pdf/attachments/extract', params)
+async def extract_pdf_attachments(params: ConversionParams, api_key: str = None) -> BaseResponse:
+    return await request('pdf/attachments/extract', params, api_key=api_key)
 
-async def request(endpoint: str, params: ConversionParams, custom_payload: dict = None) -> BaseResponse:
+async def request(endpoint: str, params: ConversionParams, custom_payload: dict = None, api_key: str = None) -> BaseResponse:
     payload = params.parse_payload(async_mode=True)
     if custom_payload:
         payload.update(custom_payload)
         
     try:
-        async with PDFCoClient() as client:
+        async with PDFCoClient(api_key=api_key) as client:
             url = f"/v1/{endpoint}"
             print(f"Requesting {url} with payload {payload}", file=sys.stderr)
             response = await client.post(url, json=payload)

pdfco/mcp/tools/apis/conversion.py

@@ -4,7 +4,6 @@ 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."),
@@ -17,12 +16,13 @@ async def pdf_to_json(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    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), api_key=api_key)
 
 @mcp.tool()
 async def pdf_to_csv(
@@ -36,12 +36,13 @@ async def pdf_to_csv(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def pdf_to_text(
@@ -55,12 +56,13 @@ async def pdf_to_text(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def pdf_to_xls(
@@ -74,12 +76,13 @@ async def pdf_to_xls(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def pdf_to_xlsx(
@@ -93,12 +96,13 @@ async def pdf_to_xlsx(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def pdf_to_xml(
@@ -112,12 +116,13 @@ async def pdf_to_xml(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def pdf_to_html(
@@ -131,12 +136,13 @@ async def pdf_to_html(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def pdf_to_image(
@@ -151,6 +157,7 @@ async def pdf_to_image(
     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"]),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> BaseResponse:
     """
     Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF).
@@ -160,7 +167,7 @@ async def pdf_to_image(
      - 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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def document_to_pdf(
@@ -170,12 +177,13 @@ async def document_to_pdf(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_from("pdf", "doc", ConversionParams(url=url, autosize=autosize, httpusername=httpusername, httppassword=httppassword, pages=pages, name=name, api_key=api_key))
 
 @mcp.tool()
 async def csv_to_pdf(
@@ -185,12 +193,13 @@ async def csv_to_pdf(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_from("pdf", "csv", ConversionParams(url=url, autosize=autosize, httpusername=httpusername, httppassword=httppassword, pages=pages, name=name, api_key=api_key))
 
 @mcp.tool()
 async def image_to_pdf(
@@ -199,13 +208,14 @@ async def image_to_pdf(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_from("pdf", "image", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, pages=pages, name=name, api_key=api_key))
 
 @mcp.tool()
 async def webpage_to_pdf(
@@ -221,6 +231,7 @@ async def webpage_to_pdf(
     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:
     """
     Convert external webpage URL to PDF.
@@ -237,7 +248,7 @@ async def webpage_to_pdf(
     ```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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def html_to_pdf(
@@ -253,6 +264,7 @@ async def html_to_pdf(
     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:
     """
     Convert HTML to PDF.
@@ -269,7 +281,7 @@ async def html_to_pdf(
     ```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))
+    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, api_key=api_key))
 
 @mcp.tool()
 async def email_to_pdf(
@@ -279,12 +291,13 @@ async def email_to_pdf(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_from("pdf", "email", ConversionParams(url=url, embedAttachments=embedAttachments, convertAttachments=convertAttachments, margins=margins, paperSize=paperSize, orientation=orientation, api_key=api_key))
     
 @mcp.tool()
 async def excel_to_csv(
@@ -293,12 +306,13 @@ async def excel_to_csv(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_to("xls", "csv", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex, api_key=api_key))
 
 @mcp.tool()
 async def excel_to_json(
@@ -307,12 +321,13 @@ async def excel_to_json(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_to("xls", "json", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex, api_key=api_key))
 
 @mcp.tool()
 async def excel_to_html(
@@ -321,12 +336,13 @@ async def excel_to_html(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_to("xls", "html", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex, api_key=api_key))
 
 @mcp.tool()
 async def excel_to_txt(
@@ -335,12 +351,13 @@ async def excel_to_txt(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_to("xls", "txt", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex, api_key=api_key))
 
 @mcp.tool()
 async def excel_to_xml(
@@ -349,12 +366,13 @@ async def excel_to_xml(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_to("xls", "xml", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex, api_key=api_key))
 
 @mcp.tool()
 async def excel_to_pdf(
@@ -363,9 +381,10 @@ async def excel_to_pdf(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> 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))
+    return await convert_to("xls", "pdf", ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name, worksheetIndex=worksheetIndex, api_key=api_key))

pdfco/mcp/tools/apis/document.py

@@ -10,6 +10,7 @@ async def pdf_info_reader(
     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,4 +23,4 @@ async def pdf_info_reader(
         password=password,
     )
     
-    return await get_pdf_info(params) 
+    return await get_pdf_info(params, api_key=api_key) 

pdfco/mcp/tools/apis/editing.py

@@ -19,6 +19,7 @@ async def pdf_add_annotations_images_fields(
     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),
 ) -> 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.
@@ -68,4 +69,4 @@ async def pdf_add_annotations_images_fields(
     if flatten:
         add_params["flatten"] = flatten
     
-    return await pdf_add(params, **add_params) 
+    return await pdf_add(params, **add_params, api_key=api_key) 

pdfco/mcp/tools/apis/extraction.py

@@ -8,18 +8,19 @@ 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),
 ) -> 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
+    # Pass arguments directly; ConversionParams now handles str with default=None
     params = ConversionParams(
         url=url,
     )
     
-    return await parse_invoice(params)
+    return await parse_invoice(params, api_key=api_key)
 
 
 @mcp.tool()
@@ -28,6 +29,7 @@ async def extract_attachments(
     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),
 ) -> BaseResponse:
     """
     Extracts attachments from a source PDF file.
@@ -39,4 +41,4 @@ async def extract_attachments(
         httppassword=httppassword if httppassword else None,
         password=password if password else None,
     )
-    return await extract_pdf_attachments(params)
+    return await extract_pdf_attachments(params, api_key=api_key)

pdfco/mcp/tools/apis/file.py

@@ -7,13 +7,14 @@ from pydantic import Field
 
 @mcp.tool()
 async def upload_file(
-    file_path: str = Field(description="The absolute path to the file to upload"), 
+    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)
 ) -> BaseResponse:
     """
     Upload a file to the PDF.co API
     """
     try:
-        async with PDFCoClient() as client:
+        async with PDFCoClient(api_key=api_key) as client:
             response = await client.post(
                 "/v1/file/upload", 
                 files={

pdfco/mcp/tools/apis/form.py

@@ -11,6 +11,7 @@ async def read_pdf_forms_info(
     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),
 ) -> BaseResponse:
     """
     Extracts information about fillable PDF fields from an input PDF file.
@@ -23,7 +24,7 @@ async def read_pdf_forms_info(
         password=password,
     )
     
-    return await get_pdf_form_fields_info(params)
+    return await get_pdf_form_fields_info(params, api_key=api_key)
 
 @mcp.tool(name="fill_forms")
 async def fill_pdf_forms(
@@ -32,6 +33,7 @@ async def fill_pdf_forms(
     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.
@@ -56,7 +58,7 @@ async def fill_pdf_forms(
         name=name,
     )
     
-    return await fill_pdf_form_fields(params, fields=fields)
+    return await fill_pdf_form_fields(params, fields=fields, api_key=api_key)
 
 @mcp.tool(name="create_fillable_forms")
 async def create_fillable_forms(
@@ -65,6 +67,7 @@ async def create_fillable_forms(
     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.
@@ -99,4 +102,4 @@ async def create_fillable_forms(
         name=name,
     )
     
-    return await fill_pdf_form_fields(params, annotations=annotations) 
+    return await fill_pdf_form_fields(params, annotations=annotations, api_key=api_key) 

pdfco/mcp/tools/apis/job.py

@@ -8,7 +8,8 @@ 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")
+    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)
 ) -> BaseResponse:
     """
     Check the status and results of a job
@@ -20,7 +21,7 @@ async def get_job_check(
     - unknown: unknown background job id. Available only when force is set to true for input request.
     """
     try:
-        async with PDFCoClient() as client:
+        async with PDFCoClient(api_key=api_key) as client:
             response = await client.post("/v1/job/check", json={
                 "jobId": job_id,
             })
@@ -42,7 +43,8 @@ async def get_job_check(
 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)
+    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
@@ -52,7 +54,7 @@ async def wait_job_completion(
     credits_used = 0
     credits_remaining = 0
     while True:
-        response = await get_job_check(job_id)
+        response = await get_job_check(job_id, api_key=api_key)
         job_check_count += 1
         credits_used += response.credits_used
         credits_remaining = response.credits_remaining

pdfco/mcp/tools/apis/modification.py

@@ -11,12 +11,13 @@ async def pdf_merge(
     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))
+    return await merge_pdf(ConversionParams(url=url, httpusername=httpusername, httppassword=httppassword, name=name), api_key=api_key)
 
 @mcp.tool()
 async def pdf_split(
@@ -26,6 +27,7 @@ async def pdf_split(
     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.
@@ -40,4 +42,4 @@ async def pdf_split(
         name=name,
     )
     
-    return await split_pdf(params)
+    return await split_pdf(params, api_key=api_key)

pdfco/mcp/tools/apis/search.py

@@ -15,6 +15,7 @@ async def find_text(
     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,7 +29,7 @@ async def find_text(
         password=password,
     )
     
-    return await find_text_in_pdf(params, searchString, regexSearch, wordMatchingMode)
+    return await find_text_in_pdf(params, searchString, regexSearch, wordMatchingMode, api_key=api_key)
 
 
 @mcp.tool(name="find_table")
@@ -38,6 +39,7 @@ async def find_table(
     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.
@@ -51,4 +53,4 @@ async def find_table(
         password=password,
     )
     
-    return await find_table_in_pdf(params) 
+    return await find_table_in_pdf(params, api_key=api_key) 

pdfco/mcp/tools/apis/searchable.py

@@ -14,6 +14,7 @@ async def pdf_make_searchable(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> BaseResponse:
     """
     Convert scanned PDF documents or image files into a text-searchable PDF.
@@ -30,7 +31,7 @@ async def pdf_make_searchable(
         name=name,
     )
     
-    return await make_pdf_searchable(params)
+    return await make_pdf_searchable(params, api_key=api_key)
 
 
 @mcp.tool()
@@ -41,6 +42,7 @@ async def pdf_make_unsearchable(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> BaseResponse:
     """
     Make existing PDF document non-searchable by removing the text layer from it.
@@ -55,4 +57,4 @@ async def pdf_make_unsearchable(
         name=name,
     )
     
-    return await make_pdf_unsearchable(params) 
+    return await make_pdf_unsearchable(params, api_key=api_key) 

pdfco/mcp/tools/apis/security.py

@@ -23,6 +23,7 @@ async def pdf_add_password(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> BaseResponse:
     """
     Add password protection to a PDF file.
@@ -70,7 +71,7 @@ async def pdf_add_password(
     if print_quality is not None:
         additional_params["PrintQuality"] = print_quality
     
-    return await add_pdf_password(params, **additional_params)
+    return await add_pdf_password(params, **additional_params, api_key=api_key)
 
 
 @mcp.tool()
@@ -80,6 +81,7 @@ async def pdf_remove_password(
     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=""),
+    api_key: str = Field(description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)", default=None),
 ) -> BaseResponse:
     """
     Remove password protection from a PDF file.
@@ -93,4 +95,4 @@ async def pdf_remove_password(
         name=name,
     )
     
-    return await remove_pdf_password(params) 
+    return await remove_pdf_password(params, api_key=api_key) 

pdfco_mcp-0.0.3.dist-info/METADATA

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: pdfco-mcp
+Version: 0.0.3
+Summary: Add your description here
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: fastmcp>=2.6.1
+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 Server
+
+PDF.co MCP Server provides [PDF.co API](https://pdf.co) functionality through the Model Context Protocol (MCP), enabling AI assistants to easily perform various PDF processing tasks.
+
+## 🚀 Key Features
+
+### 📄 PDF Conversion Tools
+- **PDF → Various Formats**: Convert PDFs to JSON, CSV, Text, Excel (XLS/XLSX), XML, HTML, Images (JPG/PNG/WebP/TIFF)
+- **Various Formats → PDF**: Convert documents (DOC/DOCX/RTF/TXT), spreadsheets (CSV/XLS/XLSX), images, web pages, HTML, emails (MSG/EML) to PDF
+- **Excel Conversions**: Convert Excel files to CSV, JSON, HTML, TXT, XML, PDF
+
+### 🛠️ PDF Editing & Modification
+- **PDF Merging**: Combine multiple PDF files into one
+- **PDF Splitting**: Split PDFs by specific pages or page ranges
+- **Add Annotations & Images**: Add text, links, images, shapes to PDFs
+- **Form Operations**: Read PDF form field information, fill forms, create new form elements
+
+### 🔍 PDF Search & Analysis
+- **Text Search**: Search text in PDFs (supports regular expressions)
+- **Table Detection**: Find table locations and coordinates in PDFs
+- **AI Invoice Parser**: Extract invoice data using AI
+- **PDF Information**: Get detailed information including metadata, page count, security info
+
+### 🔒 Security & Accessibility
+- **Password Protection**: Add/remove password protection to PDFs
+- **Searchability**: Make PDFs searchable via OCR or remove text layers
+- **Attachment Extraction**: Extract attachments from PDFs
+
+### 💼 File Management
+- **File Upload**: Upload local files to PDF.co servers
+- **Job Status Tracking**: Monitor progress and results of asynchronous operations
+
+## ⚙️ Configuration
+
+### 🔑 Get API Key
+1. Sign up at [PDF.co website](https://pdf.co)
+2. Get your API key from the dashboard
+
+### MCP Server Setup
+
+#### Cursor IDE Configuration
+Add the following to your `.cursor/mcp.json` file:
+
+```json
+{
+  "mcpServers": {
+    "pdfco": {
+      "command": "uvx",
+      "args": ["pdfco-mcp"],
+      "env": {
+        "X_API_KEY": "YOUR_API_KEY_HERE"
+      }
+    }
+  }
+}
+```
+
+#### Claude Desktop Configuration
+Add the following to your `claude_desktop_config.json` file:
+
+```json
+{
+  "mcpServers": {
+    "pdfco": {
+      "command": "uvx",
+      "args": ["pdfco-mcp"],
+      "env": {
+        "X_API_KEY": "YOUR_API_KEY_HERE"
+      }
+    }
+  }
+}
+```
+
+## 🔧 Available Tools
+
+### PDF Conversion Tools
+- `pdf_to_json`: Convert PDF and scanned images into JSON representation with text, fonts, images, vectors, and formatting preserved
+- `pdf_to_csv`: Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables
+- `pdf_to_text`: Convert PDF and scanned images to text with layout preserved
+- `pdf_to_xls`: Convert PDF and scanned images to XLS (Excel 97-2003) format
+- `pdf_to_xlsx`: Convert PDF and scanned images to XLSX (Excel 2007+) format
+- `pdf_to_xml`: Convert PDF and scanned images to XML format
+- `pdf_to_html`: Convert PDF and scanned images to HTML format
+- `pdf_to_image`: Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF)
+
+### Document to PDF Conversion Tools
+- `document_to_pdf`: Convert various document types (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) into PDF
+- `csv_to_pdf`: Convert CSV or spreadsheet files (XLS, XLSX) to PDF
+- `image_to_pdf`: Convert various image formats (JPG, PNG, TIFF) to PDF
+- `webpage_to_pdf`: Convert external webpage URL to PDF
+- `html_to_pdf`: Convert HTML to PDF
+- `email_to_pdf`: Convert email to PDF
+
+### Excel Conversion Tools
+- `excel_to_csv`: Convert Excel(XLS, XLSX) to CSV
+- `excel_to_json`: Convert Excel(XLS, XLSX) to JSON
+- `excel_to_html`: Convert Excel(XLS, XLSX) to HTML
+- `excel_to_txt`: Convert Excel(XLS, XLSX) to TXT
+- `excel_to_xml`: Convert Excel(XLS, XLSX) to XML
+- `excel_to_pdf`: Convert Excel(XLS, XLSX) to PDF
+
+### PDF Editing Tools
+- `pdf_add_annotations_images_fields`: 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
+- `pdf_merge`: Merge PDF from two or more PDF, DOC, XLS, images, even ZIP with documents and images into a new PDF
+- `pdf_split`: Split a PDF into multiple PDF files using page indexes or page ranges
+
+### PDF Form Tools
+- `read_pdf_forms_info`: Extracts information about fillable PDF fields from an input PDF file
+- `fill_pdf_forms`: Fill existing form fields in a PDF document
+- `create_fillable_forms`: Create new fillable form elements in a PDF document
+
+### PDF Search Tools
+- `find_text`: Find text in PDF and get coordinates. Supports regular expressions
+- `find_table`: Find tables in PDF and get their coordinates
+
+### PDF Analysis Tools
+- `ai_invoice_parser`: AI Invoice Parser: Extracts data from invoices using AI
+- `extract_attachments`: Extracts attachments from a source PDF file
+- `pdf_info_reader`: Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more
+
+### PDF Security Tools
+- `pdf_add_password`: Add password protection to a PDF file
+- `pdf_remove_password`: Remove password protection from a PDF file
+
+### PDF Searchability Tools
+- `pdf_make_searchable`: 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
+- `pdf_make_unsearchable`: Make existing PDF document non-searchable by removing the text layer from it
+
+### File Management Tools
+- `upload_file`: Upload a file to the PDF.co API
+- `get_job_check`: Check the status and results of a job. Status can be: working, success, failed, aborted, or unknown
+- `wait_job_completion`: Wait for a job to complete
+
+## 📖 Usage Examples
+
+### Convert PDF to Text
+```
+Convert this PDF file to text: https://example.com/document.pdf
+```
+
+### Merge Multiple Images into PDF
+```
+Create a PDF from these images: image1.jpg, image2.png, image3.jpg
+```
+
+### Search for Specific Text in PDF
+```
+Find the word "contract" in this PDF document
+```
+
+### Fill PDF Form Fields
+```
+Fill the name field in this PDF form with "John Doe"
+```
+
+### Convert Web Page to PDF
+```
+Convert https://example.com webpage to PDF
+```
+
+### Extract Invoice Data
+```
+Extract invoice information from this PDF using AI
+```
+
+### Add Password Protection
+```
+Add password protection to this PDF file
+```
+
+
+## 📞 Support & Contact
+
+- **PDF.co**: https://pdf.co
+- **PDF.co API Documentation**: https://developer.pdf.co
+- **Issue Reports**: Please report issues through GitHub Issues
+
+## 📄 License
+
+This project is distributed under the MIT License.
+
+---
+
+**Note**: A valid PDF.co API key is required to use this tool. Create a free account at [PDF.co](https://pdf.co) to get your API key.

pdfco_mcp-0.0.3.dist-info/RECORD

@@ -0,0 +1,23 @@
+pdfco/mcp/__init__.py,sha256=xfKRNYaFEREhWjiM_r4GAiXyld1DkLzE96OOaj28AMs,1054
+pdfco/mcp/models.py,sha256=pnU9e18fQHrab27sYG1qr7ORhAkVFk70WpAkXSisu9Q,5602
+pdfco/mcp/server.py,sha256=C82IrVqxNhICyxNn4oeJ_IFl0_NOuO1EqDIeAT03Dc0,52
+pdfco/mcp/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pdfco/mcp/services/client.py,sha256=OKmVSbjEoXCwvWKXcPh2PmEogWlyBuJhmQZBbRL_0RY,1722
+pdfco/mcp/services/pdf.py,sha256=oV1P46epAI0pAURMxu9-gqtvGlYFKQy1mxzWCVku760,4779
+pdfco/mcp/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pdfco/mcp/tools/apis/conversion.py,sha256=EsvSljSRr37JIxTV892UJWbOQSkRtsz3hNR-engITBE,37424
+pdfco/mcp/tools/apis/document.py,sha256=6-yfxzhRZHXtJJI6pePzxrw5e0EjrKNwXub2wHO1-w4,1320
+pdfco/mcp/tools/apis/editing.py,sha256=Q8gSn9WyZzBS9lCJEo3z7OnoaiyweJ34DiP8yFao-yI,4632
+pdfco/mcp/tools/apis/extraction.py,sha256=EGU1pfgFN0H44FKmq31kDc8GP99qkR9s-GQkM33dmb0,1987
+pdfco/mcp/tools/apis/file.py,sha256=_LC-kKMIeuyrhlfR221WcqgqR9u-CjeQ9ido5t4Oglc,1119
+pdfco/mcp/tools/apis/form.py,sha256=9uLm9rNsxCzVYUJ2uBwU2scGTRBmPM4gM3-6ma74KNM,4684
+pdfco/mcp/tools/apis/job.py,sha256=rU-wm2CygYRxqaIe1NZQ5oYWBtLpbL6cdjeuIC8QSvU,3347
+pdfco/mcp/tools/apis/modification.py,sha256=yPKwXjKpDOCo67YCHuWUOjGLqTqIZWKq0IOIJAxf5Js,2823
+pdfco/mcp/tools/apis/search.py,sha256=-phrQbI5waPBvnI7ReWtLTMXzt1s6dSmHs-D7HMbdig,3296
+pdfco/mcp/tools/apis/searchable.py,sha256=ZkD4LbRbbE16GILjNAbxmVBwugburCL9bNIsAh61jco,3482
+pdfco/mcp/tools/apis/security.py,sha256=qeOqZUO11UuoPTwHb-DEfoLdkJp_Jvh7nzPm54ATYXw,5490
+pdfco_mcp-0.0.3.dist-info/METADATA,sha256=mUQx55y16o7kO909iGNmX1mWurqjfHPPjj9eexByVu0,7113
+pdfco_mcp-0.0.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pdfco_mcp-0.0.3.dist-info/entry_points.txt,sha256=Ja_Ud8LbrhKYUmQMo6hxd11SQX_vx7cwrqvco6ClwB4,45
+pdfco_mcp-0.0.3.dist-info/licenses/LICENSE,sha256=DjYg-0Ei_vaAyXg45y8_otZRHJe-L1cU7cKhyf5gtFo,1063
+pdfco_mcp-0.0.3.dist-info/RECORD,,

pdfco_mcp-0.0.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PDF.co
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pdfco_mcp-0.0.1.dist-info/METADATA

@@ -1,30 +0,0 @@
-Metadata-Version: 2.4
-Name: pdfco-mcp
-Version: 0.0.1
-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": "uvx",
-      "args": [
-        "pdfco-mcp"
-      ],
-      "env": {
-        "X_API_KEY": "YOUR_API_KEY" // To get the API key please sign up at https://pdf.co and you can get the API key from the dashboard
-      }
-    }
-  }
-}
-```

pdfco_mcp-0.0.1.dist-info/RECORD

@@ -1,22 +0,0 @@
-pdfco/mcp/__init__.py,sha256=S-GhB7vAGoUDpg47kP74gKck2XFJ_2UNjgpxqGS774U,256
-pdfco/mcp/models.py,sha256=pnU9e18fQHrab27sYG1qr7ORhAkVFk70WpAkXSisu9Q,5602
-pdfco/mcp/server.py,sha256=5pBIKZJJ3Um5LsdrT9HvlGy4oB4n6t5Opu8razv2A5A,63
-pdfco/mcp/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pdfco/mcp/services/client.py,sha256=vZq9EhkDyAstuGtfIFkN9Mf1HgMElkIstbuF_LXl2M0,1359
-pdfco/mcp/services/pdf.py,sha256=CL1kiZew9GOgbmeaFf0ecjCSFAc-U1G9ySvV2ueSGSY,4135
-pdfco/mcp/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pdfco/mcp/tools/apis/conversion.py,sha256=6snda-ZmZz81Mgf0o7FF9DUkRWzRfMHTWF-0-cxSvt8,34285
-pdfco/mcp/tools/apis/document.py,sha256=-_gJC0MrziZWfqn-akZZdSNpN75NryJEPLQEwE5Yh5Q,1163
-pdfco/mcp/tools/apis/editing.py,sha256=aQbRNakUhlj9mYew8BjTweA5wEXVq2z1-WH0DiWptes,4475
-pdfco/mcp/tools/apis/extraction.py,sha256=cnXQjCZ2PBwBUWNEiAUGMZJbN_6I3ZLdGqdDWEfUrRc,1683
-pdfco/mcp/tools/apis/file.py,sha256=nWaSlG4Okcc30f2kfi8w28QeJBgeR2khcXoAxM6cpEU,966
-pdfco/mcp/tools/apis/form.py,sha256=irPlTPiJjrBWJIplpt0YC7BaRduFdP2SXQ-Y444Pa94,4213
-pdfco/mcp/tools/apis/job.py,sha256=1Fv28EFy6oOeB_WFM4gMCN7XPX2HIxWV3uV8sl6SZEU,3035
-pdfco/mcp/tools/apis/modification.py,sha256=GcZTI0z3PVSyuSOOHHPsqX590mWM4yRBhewMfdUKiHs,2509
-pdfco/mcp/tools/apis/search.py,sha256=4_FBBcIB4PpZ_E_ExDwlTXUEHaoiCEgyfXkFcYM117E,2982
-pdfco/mcp/tools/apis/searchable.py,sha256=7HEs-Siz8rUZbyxV0jS81uLQZJejJpb5SWNDZOBVHCU,3168
-pdfco/mcp/tools/apis/security.py,sha256=CGVXnCvHyPbSeKWAlExlsVELgn_Vtd4U_nt1IuY3NUs,5176
-pdfco_mcp-0.0.1.dist-info/METADATA,sha256=PRTBvaTTiuhoGlHUx-wevn9XkwI-XwfRHKCRYxb7P6Q,688
-pdfco_mcp-0.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-pdfco_mcp-0.0.1.dist-info/entry_points.txt,sha256=Ja_Ud8LbrhKYUmQMo6hxd11SQX_vx7cwrqvco6ClwB4,45
-pdfco_mcp-0.0.1.dist-info/RECORD,,