# Stirling PDF MCP for AI Agents AI Agent Connect > Stirling PDF MCP lets you manage, sign, and monitor PDF documents through your AI client. You can add watermarks, convert images to PDF, and handle digital signatures with certificates. It also gives you a direct line to your instance metrics and status, making it a powerhouse for document automation and self-hosted infrastructure management. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ex3cIfED6ID0iEuNTGmKIKMGxP4UB2LSaslRsUJV/ai-agent-connect - **Tags:** pdf-tools, watermarking, pdf-conversion, digital-signatures, server-monitoring ## Description Imagine you're juggling dozens of PDFs that need watermarks, signatures, or format changes. Usually, this means opening a browser, uploading files, clicking through a UI, and downloading the results again. This Connector changes that. By connecting your Stirling PDF instance to your agent, you turn those repetitive clicks into simple chat commands. You can ask your agent to apply a 'Confidential' watermark to a batch of files or convert a folder of images into a single PDF document while you focus on other tasks. It handles the heavy lifting of document manipulation and digital security, giving you a way to manage your files without the friction of a traditional interface. If you're running a self-hosted setup, you can even keep an eye on your instance's health and request metrics in real-time. It's a practical way to bridge the gap between your document processing needs and your AI workflow. Finding this in the Vinkius catalog makes it easy to plug into your existing setup and get your documents moving faster. Whether you're a developer automating a pipeline or an admin keeping things running, it takes the manual labor out of PDF management and lets you focus on the actual work instead of the file format headaches. ## Tools ### get_all_requests Check the total count of POST requests across all your endpoints. This helps you see how many actions are being performed. ### cert_sign Sign a PDF document using a specific certificate for legal or security purposes. This helps you maintain compliance without manual signing. ### get_all_unique_requests See how many unique users have hit your endpoints recently. This is useful for tracking reach. ### get_load Get the total count of GET requests to monitor your instance traffic. This keeps you informed on current usage. ### get_prometheus_metrics Pull detailed Prometheus metrics for deep observability into your pipeline. This is for advanced monitoring needs. ### get_requests Retrieve the total count of POST requests for your instance. This gives you a quick pulse on activity. ### get_status Check the current application status and version information. This ensures your setup is running correctly. ### get_unique_requests Get the count of unique users specifically for POST requests. This helps refine your user analytics. ### img_to_pdf Convert an image file into a high-quality PDF document. This saves you from having to use external conversion software. ### run_generic_tool Execute any Stirling PDF tool by ID, such as merging or splitting files. This gives you access to the full suite of features. ### add_watermark Apply a text watermark with custom opacity and font size to a PDF. This is perfect for branding and security. ## Prompt Examples **Prompt:** ``` Check the current status and version of my Stirling PDF instance. ``` **Response:** ``` I've checked your instance. It is currently online running version 0.25.1. All systems are operational. ``` **Prompt:** ``` Add a 'CONFIDENTIAL' watermark to this PDF with 0.5 opacity. ``` **Response:** ``` Processing the document... I've applied the 'CONFIDENTIAL' text watermark with the requested settings. You can now download the processed PDF. ``` **Prompt:** ``` Convert this image to a PDF document named 'report.pdf'. ``` **Response:** ``` Converting image... I have successfully generated 'report.pdf' from your image file using the maintainAspectRatio fit option. ``` ## Capabilities ### Add text watermarks to PDFs Apply custom branding or security labels to your documents through chat. ### Convert images into PDF files Turn your image assets into high-quality PDF documents automatically. ### Sign documents with certificates Apply digital signatures to files using your existing certificates. ### Monitor instance request metrics Keep tabs on your instance traffic and request counts in real-time. ### Check application status and version Verify that your instance is online and running the correct version. ### Run advanced PDF tools like merging Execute specialized commands like merging or splitting files via a generic runner. ## Use Cases ### Legal document batching A lawyer asks the agent to sign 50 contracts with a specific location certificate using `cert_sign`. ### Marketing asset conversion A designer converts a folder of product photos into a PDF catalog using `img_to_pdf`. ### Admin health checks A sysadmin asks for the current request load and version using `get_load` and `get_status`. ### Automated watermarking A firm asks the agent to add a 'Draft' watermark to all incoming PDFs using `add_watermark`. ## Benefits - Stop manual uploads: Use `add_watermark` to apply branding to files without opening a browser. - Faster conversions: Turn images into PDFs instantly with `img_to_pdf` via chat. - Secure signing: Apply digital certificates to documents using `cert_sign` for legal compliance. - Real-time monitoring: Check `get_status` and `get_load` to see if your instance is healthy. - Deep observability: Use `get_prometheus_metrics` to track your document processing pipeline. - Flexible operations: Access hidden features like splitting or merging via `run_generic_tool`. ## How It Works The bottom line is it turns your self-hosted PDF suite into a voice-activated command center. 1. Subscribe to the Stirling PDF MCP and grab your API key and Base URL. 2. Input your credentials into your AI client's configuration. 3. Start asking your agent to sign, watermark, or monitor your PDFs. ## Frequently Asked Questions **Can the Stirling PDF MCP help me sign documents?** Yes, it allows your agent to apply digital signatures to PDF files using your existing certificates. **How do I use the Stirling PDF MCP for watermarking?** You can simply tell your agent to add a watermark with specific text, opacity, and font settings. **Can I use the Stirling PDF MCP to monitor my instance?** Yes, it provides tools to check your application status, version, and request loads in real-time. **Does the Stirling PDF MCP support image conversion?** It can convert images into PDF documents directly through your agent's chat interface. **Is the Stirling PDF MCP good for enterprise monitoring?** It includes tools for Prometheus metrics, which are perfect for deep observability into your processing pipeline. **Can I use the Stirling PDF MCP to merge files?** Yes, you can use the generic tool runner to access specialized features like merging or splitting PDFs. **Can I add a text watermark to a PDF document using this server?** Yes! Use the `add_watermark` tool. You can specify the text, font size, and opacity to apply a professional watermark to any PDF file provided in base64 format. **How do I monitor the traffic and load on my Stirling PDF instance?** You can use `get_requests` to see POST counts, `get_load` for GET requests, or `get_prometheus_metrics` if you are on the Enterprise tier for detailed observability. **Is it possible to perform other operations like merging or splitting PDFs?** Yes, the `run_generic_tool` action allows you to execute any Stirling PDF tool by its ID (e.g., 'merge-pdfs' or 'split-pages') by passing the required parameters.