# How to integrate Pdf co MCP with Atomic Agent ```json { "title": "How to integrate Pdf co MCP with Atomic Agent", "toolkit": "Pdf co", "toolkit_slug": "pdf_co", "framework": "Atomic Agent", "framework_slug": "atomic-agent", "url": "https://composio.dev/toolkits/pdf_co/framework/atomic-agent", "markdown_url": "https://composio.dev/toolkits/pdf_co/framework/atomic-agent.md", "updated_at": "2026-08-11T13:13:09.423Z" } ``` ## Introduction Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Pdf co. This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Pdf co account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions. ## Also integrate Pdf co with - [ChatGPT](https://composio.dev/toolkits/pdf_co/framework/chatgpt) - [Antigravity](https://composio.dev/toolkits/pdf_co/framework/antigravity) - [OpenAI Agents SDK](https://composio.dev/toolkits/pdf_co/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/pdf_co/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/pdf_co/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/pdf_co/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/pdf_co/framework/codex) - [Kimi Code](https://composio.dev/toolkits/pdf_co/framework/kimi) - [Grok Build](https://composio.dev/toolkits/pdf_co/framework/grok-build) - [Cursor](https://composio.dev/toolkits/pdf_co/framework/cursor) - [VS Code](https://composio.dev/toolkits/pdf_co/framework/vscode) - [OpenCode](https://composio.dev/toolkits/pdf_co/framework/opencode) - [OpenClaw](https://composio.dev/toolkits/pdf_co/framework/openclaw) - [Hermes](https://composio.dev/toolkits/pdf_co/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/pdf_co/framework/cli) - [Google ADK](https://composio.dev/toolkits/pdf_co/framework/google-adk) - [LangChain](https://composio.dev/toolkits/pdf_co/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/pdf_co/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/pdf_co/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/pdf_co/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/pdf_co/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/pdf_co/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/pdf_co/framework/autogen) ## TL;DR ### How Atomic Agent connects to Pdf co Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication. Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account. ## Connect Pdf co to Atomic Agent ### Connect Pdf co to Atomic Agent - Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key. - In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart. - Ask Atomic Agent to do something in Pdf co. It searches Composio for the right tool. - On first use, open the sign-in link returned in the chat. Connect your Pdf co account, then return to Atomic Agent to continue. ### Headless setup Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file. ```bash COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY ``` ## What is the Pdf co MCP server, and what's possible with it? The Pdf co MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Pdf co account. It provides structured and secure access to your PDF.co capabilities, so your agent can extract data, generate documents, convert files, process barcodes, and manage asynchronous jobs on your behalf. - Automated PDF data extraction and parsing: Let your agent extract structured data from PDFs using templates or parse documents for key information—perfect for receipts, invoices, and more. - PDF creation, splitting, and merging: Generate new PDF files, combine multiple PDFs, or split documents into separate files without manual intervention. - File format conversion: Seamlessly convert Excel files to CSV, HTML, JSON, text, or XML, enabling efficient data analysis and workflow automation. - Barcode generation and processing: Instantly create various barcode formats (QR codes, Code128, PDF417, etc.) or encode data into barcodes for labeling and tracking. - Job management and file uploads: Upload documents to PDF.co, track the status of asynchronous jobs, and retrieve results—all through your agent, hands-free. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `PDF_CO_ACCOUNT_BALANCE_INFO` | Get Account Balance Info | Tool to get account balance info. Use after authenticating to check remaining credits. | | `PDF_CO_CONVERT_EXCEL_TO_CSV` | Convert Excel to CSV | Tool to convert an Excel file (XLS/XLSX) to CSV. Use when you have a public Excel file URL and need CSV output. Inline option returns data inline; otherwise provides download URL. | | `PDF_CO_CONVERT_EXCEL_TO_HTML` | Convert Excel to HTML | Tool to convert an Excel file to HTML. Use when you have an Excel URL and need HTML output. | | `PDF_CO_CONVERT_EXCEL_TO_JSON` | Convert Excel to JSON | Tool to convert an online Excel or CSV file to JSON format. Use when you have a public file URL and need structured data extraction. | | `PDF_CO_CONVERT_EXCEL_TO_TEXT` | Convert Excel to Text | Tool to convert Excel files to plain text. Use after providing an Excel file URL to extract spreadsheet content. | | `PDF_CO_CONVERT_EXCEL_TO_XML` | Convert Excel to XML | Tool to convert an Excel file to XML. Use when needing XML output from xls/xlsx/csv synchronously or asynchronously. | | `PDF_CO_DOCUMENT_PARSER` | Document Parser | Tool to parse documents based on predefined templates to extract structured data. Use when you need to extract structured fields from a PDF by supplying a custom template. | | `PDF_CO_FILE_UPLOAD` | Upload File | Tool to upload a local file or remote URL to PDF.co, returning a hosted URL for downstream processing. Use when a PDF.co tool (e.g., PDF_CO_PDF_FROM_HTML) requires a remote URL but you have a local file. | | `PDF_CO_JOB_CHECK` | Check Job Status | Tool to check status and result of an asynchronous job. Use after submitting a job to poll for completion. | | `PDF_CO_PDF_ADD` | Add Content to PDF | Tool to add content to an existing PDF. Use when you need to overlay text, images, barcodes, or links before distributing the file. | | `PDF_CO_PDF_CHANGE_TEXT_SEARCHABLE` | Change PDF Text Searchable | Tool to make PDF text searchable using OCR. Use when you need to add a searchable text layer to scanned or image-only PDF documents. | | `PDF_CO_BARCODE_GENERATE` | Generate Barcode | Tool to generate high quality barcode images in 45+ formats including QR Code, Code 128, Code 39, and more. Use when you need to create barcodes with customization options like rotation, decoration images for QR codes, or async processing. | | `PDF_CO_PDFCO_POST_FILE_UPLOAD_BASE64` | Upload File from Base64 | Tool to create a temporary file using base64-encoded source data. Use when you need to upload file content as base64 to PDF.co for downstream processing. Temporary files are automatically deleted after 1 hour (or custom expiration time). | | `PDF_CO_PDF_DELETE_PAGES` | Delete PDF Pages | Tool to delete specific pages from a PDF file. Use when you need to remove unwanted pages before further processing. | | `PDF_CO_PDF_EXTRACT_ATTACHMENTS` | Extract PDF Attachments | Tool to extract embedded attachments from a PDF. Use when you need to retrieve embedded files from a PDF after uploading. | | `PDF_CO_PDF_FIND` | Find Text in PDF | Tool to find text in a PDF document. Use when you need to locate keywords or regex patterns and get their page positions. | | `PDF_CO_PDF_FORMS_INFO_READER` | PDF Forms Info Reader | Tool to extract form field information from a PDF. Use when you need to retrieve names, types, and values of form fields. Returns field names, types (CheckBox, EditBox, RadioButton, ComboBox), values, and position coordinates. | | `PDF_CO_PDF_FROM_DOCUMENT_TXT` | Convert Text to PDF | Tool to convert a plain text (.txt) file to PDF. Use when you have a public URL to a text file; raw inline text is not accepted by the endpoint. | | `PDF_CO_PDF_FROM_EMAIL` | Convert Email to PDF | Tool to convert email files (.eml/.msg) to PDF. Use when you need to transform standalone email messages into PDF documents. | | `PDF_CO_PDF_FROM_HTML` | Convert HTML to PDF | Tool to convert HTML code or webpage URL into a PDF document. Use when you need to capture a webpage or HTML snippet as a PDF file. | | `PDF_CO_PDF_INFO_READER` | PDF Info Reader | Tool to retrieve detailed information and metadata of a PDF. Use when you need page count, author, encryption details, and other document properties. | | `PDF_CO_PDF_MERGE` | Merge PDFs | Tool to merge multiple PDF files into one document. Use when you need to combine several PDF URLs into a single PDF file. | | `PDF_CO_PDF_ROTATE` | Rotate PDF Pages | Tool to rotate selected pages in a PDF. Use when you need to adjust the orientation of specific pages in an online PDF file before further processing. | | `PDF_CO_PDF_SEARCH_AND_DELETE_TEXT` | Search and Delete Text in PDF | Tool to search for and delete text in a PDF by keyword or regex. Use when you need to remove sensitive or unwanted text from a PDF document. | | `PDF_CO_PDF_SEARCH_AND_REPLACE_TEXT` | Search and Replace Text in PDF | Tool to search for and replace text in a PDF document. Use when you need to update specific text instances within an existing PDF file (e.g., changing invoice numbers). | | `PDF_CO_PDF_SPLIT` | Split PDF | Tool to split a PDF into multiple files by page ranges. Use when you need to extract specific pages or page ranges from a PDF. | | `PDF_CO_PDF_TO_CSV` | Convert PDF to CSV | Tool to convert PDF or scanned images to CSV format. Use when you need to extract tabular data from a PDF into CSV format. | | `PDF_CO_PDF_TO_HTML` | Convert PDF to HTML | Tool to convert PDF documents to HTML. Use when you need an HTML rendition of a PDF or scanned image. | | `PDF_CO_PDF_TO_IMAGE` | Convert PDF to Image | Tool to convert PDF pages to images (PNG, JPG, TIFF). Use when you need image previews of PDF content. | | `PDF_CO_PDF_TO_JSON` | Convert PDF to JSON | Tool to convert PDF or scanned images to JSON format. Use when you need a structured JSON representation of PDF content. | | `PDF_CO_PDF_TO_TEXT` | Convert PDF to Text | Tool to convert PDF or scanned images to plain text. Use when you need raw text output preserving layout. | | `PDF_CO_PDF_TO_XLS` | Convert PDF to XLS | Tool to convert PDF or scanned images to XLS format. Use when you need to extract tabular data into an Excel spreadsheet. | | `PDF_CO_PDF_TO_XLSX` | Convert PDF to XLSX | Tool to convert PDF or scanned images to XLSX (Excel) format. Use when you need structured spreadsheet output from a PDF. | | `PDF_CO_PDF_TO_XML` | Convert PDF to XML | Tool to convert PDF or scanned images to XML format. Use when you need to extract structured data from PDF into XML. | ## Supported Triggers None listed. ## Troubleshooting ### Why is my API key rejected? Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying. ### Why are Composio tools unavailable after saving a key? Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk. ### Does Composio have a free plan? The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection. ## Complete Code None listed. ## Conclusion ### Use Pdf co from Atomic Agent With your account connected, ask Atomic Agent to work with Pdf co in natural language. You can connect more apps through the same Composio integration as you need them. Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo). ## How to build Pdf co MCP Agent with another framework - [ChatGPT](https://composio.dev/toolkits/pdf_co/framework/chatgpt) - [Antigravity](https://composio.dev/toolkits/pdf_co/framework/antigravity) - [OpenAI Agents SDK](https://composio.dev/toolkits/pdf_co/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/pdf_co/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/pdf_co/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/pdf_co/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/pdf_co/framework/codex) - [Kimi Code](https://composio.dev/toolkits/pdf_co/framework/kimi) - [Grok Build](https://composio.dev/toolkits/pdf_co/framework/grok-build) - [Cursor](https://composio.dev/toolkits/pdf_co/framework/cursor) - [VS Code](https://composio.dev/toolkits/pdf_co/framework/vscode) - [OpenCode](https://composio.dev/toolkits/pdf_co/framework/opencode) - [OpenClaw](https://composio.dev/toolkits/pdf_co/framework/openclaw) - [Hermes](https://composio.dev/toolkits/pdf_co/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/pdf_co/framework/cli) - [Google ADK](https://composio.dev/toolkits/pdf_co/framework/google-adk) - [LangChain](https://composio.dev/toolkits/pdf_co/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/pdf_co/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/pdf_co/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/pdf_co/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/pdf_co/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/pdf_co/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/pdf_co/framework/autogen) ## Related Toolkits - [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices. - [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze. - [Google Super](https://composio.dev/toolkits/googlesuper) - Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization. - [ActiveMerge](https://composio.dev/toolkits/active_merge) - ActiveMerge is a document automation platform for generating documents, images, merged files, and e-signature workflows. It helps teams turn templates and stored files into finished, shareable documents faster. - [Affinda](https://composio.dev/toolkits/affinda) - Affinda is an AI-powered document processing platform that automates data extraction from resumes, invoices, and more. It streamlines document-heavy workflows by turning files into structured, actionable data. - [Agility cms](https://composio.dev/toolkits/agility_cms) - Agility CMS is a headless content management system for building and managing digital experiences across platforms. It lets teams update content quickly and deliver omnichannel experiences with ease. - [Airparser](https://composio.dev/toolkits/airparser) - Airparser is an AI-powered parser for extracting structured data from emails, documents, PDFs, and files. It turns messy inbound content into clean fields your apps and workflows can use. - [Algodocs](https://composio.dev/toolkits/algodocs) - Algodocs is an AI-powered platform that automates data extraction from business documents. It delivers fast, secure, and accurate processing without templates or manual training. - [Api2pdf](https://composio.dev/toolkits/api2pdf) - Api2Pdf is a REST API for generating PDFs from HTML, URLs, and documents using powerful engines like wkhtmltopdf and Headless Chrome. It streamlines document conversion and automation for developers and businesses. - [Archive.org](https://composio.dev/toolkits/archive_org) - Archive.org is the Internet Archive's digital library of websites, books, audio, video, and images. Use it to preserve, explore, and access historical web captures and public-domain media. - [Aryn](https://composio.dev/toolkits/aryn) - Aryn is an AI-powered platform for parsing, extracting, and analyzing data from unstructured documents. Use it to automate document processing and unlock actionable insights from your files. - [Boldsign](https://composio.dev/toolkits/boldsign) - Boldsign is a digital eSignature platform for sending, signing, and tracking documents online. Organizations use it to automate agreements and manage legally binding workflows efficiently. - [Boloforms](https://composio.dev/toolkits/boloforms) - BoloForms is an eSignature platform built for small businesses, offering unlimited signatures, templates, and forms. It simplifies digital document signing and team collaboration at a predictable, fixed price. - [Box](https://composio.dev/toolkits/box) - Box is a cloud content management and file sharing platform for businesses. It helps teams securely store, organize, and collaborate on files from anywhere. - [Box MCP](https://composio.dev/toolkits/box_mcp) - Box MCP is Box's hosted MCP server that exposes enterprise files, folders, and metadata. It provides secure, centralized access to corporate content for search and management. - [Carbone](https://composio.dev/toolkits/carbone) - Carbone is a blazing-fast report generator that turns JSON data into PDFs, Word docs, spreadsheets, and more using flexible templates. It lets you automate document creation at scale with minimal code. - [Castingwords](https://composio.dev/toolkits/castingwords) - CastingWords is a transcription service specializing in human-powered, accurate transcripts via a simple API. Get seamless audio-to-text conversion for interviews, meetings, podcasts, and more. - [CertSeal](https://composio.dev/toolkits/cert_seal) - CertSeal is an API platform for issuing and managing verifiable digital certificates. Use it to automate trusted certificate workflows for recipients, batches, designs, and webhooks. - [Cloudconvert](https://composio.dev/toolkits/cloudconvert) - CloudConvert is a powerful file conversion service supporting over 200 file formats. It streamlines converting, compressing, and managing documents, media, and more, all in one place. - [Cloudlayer](https://composio.dev/toolkits/cloudlayer) - Cloudlayer is a document and asset generation service for creating PDFs and images via API or SDKs. It lets you automate high-quality doc creation, saving dev time and reducing manual work. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Pdf co MCP? With a standalone Pdf co MCP server, the agents and LLMs can only access a fixed set of Pdf co tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Pdf co and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Atomic Agent? Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Pdf co tools. ### Can I manage the permissions and scopes for Pdf co while using Tool Router? Yes, absolutely. You can configure which Pdf co scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Pdf co data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)