# ProcessOn MCP > ProcessOn connects your AI agent directly to your visual documentation library. Use it to list, create, delete, and manage flowcharts, mind maps, and org charts without opening the web interface. Your agent handles file creation, exports diagrams (PNG, PDF, SVG), and monitors team collaboration status via simple conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** flowchart, mind-mapping, diagramming, visual-documentation, project-planning, collaboration-tools ## Description This server hooks your AI agent straight into ProcessOn. You don't gotta open up a web interface to manage your flowcharts, mind maps, or org charts anymore. Just talk to your agent about what you need done with your documentation library. Your agent handles everything—from building brand-new diagrams based on simple conversation prompts to exporting the final output in multiple formats. It’s like having a real-time visual documentation assistant right here, no extra clicks needed. **Diagram Lifecycle Management** If you need to build something from scratch, use **`create_file`**. You just ask it to build a diagram, and your agent makes that brand new file in ProcessOn for you. When the diagram is finished or gets tossed, you can permanently wipe it clean using **`delete_file`**, which removes an existing diagram from your workspace. To check on any specific file's details—things like its size, who owns it, or when it last got modified—you use **`get_file`**. This gives you the metadata for any single ProcessOn file ID. **File System Navigation and Discovery** You need to know what’s sitting in your library? You've got a few ways to find it. To get an immediate rundown of every single diagram and folder across your whole account, use **`list_files`**. If you want to narrow things down by looking at the structure, you can run **`list_folders`** to see all the top-level directories available to you. Once you know which directory you're in, **`get_folder_content`** lets you list every file and subfolder within that specific path. For a quick look at what’s been busy lately, use **`get_recent_files`**. This shows you a clean list of diagrams your team or you have worked on most recently. To check the overall health of your entire ProcessOn setup, run **`get_org_info`**, and it pulls high-level details about your whole organization's configuration. **Collaboration and Contextual Data** The agent doesn't just manage files; it tracks who’s working on 'em. If you want to know exactly which users have access to a specific diagram, **`list_collaborators`** finds and lists every single user with permissions for that file. These tools give you full visibility into your team’s documentation process. **Standardized Export Control** When the diagram is ready, you don't gotta download it manually. You just send the diagram ID to **`export_file`**, and your agent spits out a standardized, downloadable asset for you—it returns the file as PNG, PDF, or SVG. It’s all done without you ever leaving this chat window. **How It Works For You** Your agent coordinates these functions. If you want to create a new process flow and then immediately export it to PDF, your AI client handles that sequence of calls seamlessly. You can list every file using **`list_files`**, check the collaborators on the most important one via **`list_collaborators`**, get its metadata with **`get_file`**, and finally generate a downloadable SVG copy using **`export_file`**. The process is simple, direct, and entirely within conversation. ## Tools ### create_file Makes a brand new diagram file in ProcessOn when you ask it to build something. ### delete_file Permanently removes an existing diagram from your workspace. ### export_file Takes a diagram ID and generates it in standard formats like PNG, PDF, or SVG. ### get_file Retrieves specific details about one ProcessOn file—like its size, owner, or last modified date. ### get_folder_content Lists all the files and subfolders inside a specified directory path. ### get_org_info Pulls high-level details about your entire ProcessOn organization setup. ### get_recent_files Shows a list of the diagrams you or your team have worked on most recently. ### list_collaborators Finds and lists all users who currently have access to a specific diagram file. ### list_files Gets an immediate list of every single diagram and folder in your entire ProcessOn account. ### list_folders Returns a directory listing, showing all the top-level folders available to you. ## Prompt Examples **Prompt:** ``` List all my flowcharts on ProcessOn. ``` **Response:** ``` I've retrieved your ProcessOn diagrams. You have 4 active flowcharts, including 'Customer Onboarding Flow' and 'System Architecture'. Which one would you like to view info for? ``` **Prompt:** ``` Create a new mind map titled 'Q4 Goals' in the 'Planning' folder. ``` **Response:** ``` Done! I've created the mind map 'Q4 Goals' inside the 'Planning' folder. You can now start brainstorming your objectives. File ID: PO-8821. ``` **Prompt:** ``` Export the diagram 'Architecture V2' to PNG format. ``` **Response:** ``` I've processed the export for you. Your diagram 'Architecture V2' is now ready in PNG format. You can download it here: [link]. ``` ## Capabilities ### Diagram Lifecycle Management Your agent can create, delete, or retrieve the metadata for any ProcessOn diagram using calls like `create_file`, `delete_file`, and `get_file`. ### File System Navigation You can list all files (`list_files`) or browse specific folder structures (`list_folders`, `get_folder_content`) to narrow down your search scope. ### Collaboration and Metadata Querying The agent pulls team data by listing collaborators on a file (`list_collaborators`) or checking organization details (`get_org_info`). ### Standardized Export Control You send the diagram ID to `export_file`, and your agent returns a standardized, downloadable asset (PNG, PDF, SVG) without you ever leaving the chat. ## Use Cases ### The Compliance Audit Compliance needs an inventory of all process diagrams. Instead of having a team member manually click 'view all' and copy names, they ask their agent to run `list_files` across the entire ProcessOn account. The resulting list gives them everything needed for the audit report immediately. ### The Hand-off Scenario A developer finishes a system diagram and needs to hand it off to the documentation team. They tell their agent, 'Export Diagram ID: XYZ to PDF.' The agent uses `export_file`, gets the document ready, and confirms that it's saved in the correct shared folder. ### The Stakeholder Meeting Prep Before a meeting, you need to know who has viewed your core process flow. You ask the agent to run `list_collaborators` on the main diagram file. The agent returns an accurate list of users and their access levels, saving you from having to check permissions manually. ### The Cleanup Crew A project ends, leaving dozens of outdated diagrams. You ask your agent to 'Find all files in the old Project Alpha folder that haven't been touched in six months.' The agent uses `get_folder_content` and then targets specific IDs for deletion using `delete_file`, cleaning up the whole workspace. ## Benefits - Stop hunting through web menus. You can use `list_files` to get a full rundown of every diagram in your workspace instantly, instead of clicking through ten different folders just to count them. - Need to share an architecture chart? Instead of manually downloading it and renaming it, run `export_file`. Your agent handles the process and returns a ready-to-use PNG or PDF link. - Audit trail management is simple. You can use `list_collaborators` on any diagram ID to see exactly who has access—and if they're still supposed to. - Creating new work is fast. Use `create_file` and just tell your agent, 'Make a mind map for Q3 goals in the Planning folder.' It handles the setup, instantly. - Folder structure management becomes trivial. If you need to know what lives under a specific directory, running `get_folder_content` gives you the full list without opening the actual folder. ## How It Works The bottom line is, your AI client handles the connection logic so you talk about diagrams like they’re just files in a folder. 1. Subscribe to this server on Vinkius. Enter your ProcessOn API Key and API Secret. 2. Tell your agent what needs doing: 'List all system architecture diagrams in the 'Engineering' folder.' 3. The agent uses `list_files` or `get_folder_content`, retrieves the list, and presents the results directly to you. ## Frequently Asked Questions **How do I list all the diagrams in ProcessOn using list_files?** You simply ask your agent to run `list_files`. It returns a comprehensive list of every diagram and folder ID across your entire account, letting you see everything at once. **What if I want to find all files in the 'Q4 Planning' directory? Do I use get_folder_content?** Yes. To check what’s inside a specific folder path, tell your agent to run `get_folder_content`. It provides an exact inventory of everything within that defined scope. **Can list_collaborators only work on existing diagrams?** Yep. You must provide the file ID when asking for collaborators. The agent then checks ProcessOn's records and returns a specific list of users with access to that single diagram. **How do I create a new mind map using create_file?** You just prompt the agent: 'Create a mind map titled X in Y folder.' The tool handles the creation process and returns confirmation, including the new file ID for you to reference. **Is there a way to check if a diagram still exists before I try to export it? What should I use?** Use `get_file` first. If the tool returns valid metadata, the file is live and safe to work with. If it fails, you know the ID is bad. **How do I use the `delete_file` tool to clean up old diagrams?** You use `delete_file` by providing the specific diagram ID. This command permanently removes the file from your ProcessOn workspace and all associated metadata. Always confirm you have the correct File ID before sending this request, as deletion is irreversible. **What does running `get_org_info` tell me about my account setup?** `get_org_info` fetches high-level organizational details. This includes general access metrics or overall team status without needing to specify a file ID. Use it when you need an overview of the ProcessOn environment itself. **Is there a difference between using `get_file` and `export_file`?** Yes, they do different things: `get_file` retrieves metadata about a diagram—like its size or owner. Conversely, `export_file` performs the actual conversion, creating a usable asset like a PNG or PDF from that diagram. **How do I find my ProcessOn API Key and Secret?** Log in to your ProcessOn account, navigate to the [API Developer Center](https://www.processon.com/api), and apply for developer credentials to receive your unique API Key and Secret. **Can I export my mind maps to PDF through the agent?** Yes. Use the `export_file` tool with the diagram file ID and specify 'pdf' as the format. Your agent will provide the download link for the exported file. **Does ProcessOn support real-time collaboration?** Yes, ProcessOn is natively built for visual collaboration. You can list existing collaborators for any diagram using the `list_collaborators` tool.