# DocsGenFlow MCP

> DocsGenFlow automates the entire document creation lifecycle, letting you build polished files from simple templates. It connects to your existing data systems via merge fields and handles complex generation jobs programmatically. You can manage template portfolios, monitor job status in real-time, and download final documents all through natural conversation with your AI client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** document-generation, template-management, automated-workflows, file-creation, merge-fields, business-automation

## Description

DocsGenFlow gives you full control over generating structured files without manual effort. You define a document once using a master template, then feed it dynamic data from whatever system holds that information. Your AI agent acts as the coordinator, taking instructions like 'Generate the Q3 sales report for Acme Corp' and handling every step: pulling the right template, filling in all the required fields, running the generation job, and giving you the final file link. This means no more copy-pasting data into spreadsheets or manually managing dozens of versions. Through Vinkius, your agent doesn't just read templates; it actually performs complex document orchestration, letting you treat file creation like a conversation.

## Tools

### check_docsgenflow_status
Confirms that the connection to DocsGenFlow is active and ready for use.

### create_template
Allows you to define a new document template structure within the system.

### download_document
Retrieves the final, completed file from its hosted URL for immediate use.

### generate_document
Creates a new document by passing specific data fields (JSON) that fill in the template gaps.

### get_account
Fetches basic account information and usage metrics for operational review.

### get_document
Retrieves specific details about a previously generated document file.

### get_template
Gets the full structure and metadata for an existing template.

### list_documents
Lists all documents that have been generated in your account's history.

### list_history
Provides a record of past document generation attempts and their results.

### list_templates
Shows every template you currently have access to in your portfolio.

## Prompt Examples

**Prompt:** 
```
List all document templates in my DocsGenFlow account.
```

**Response:** 
```
I've retrieved your templates. You currently have 10 active profiles, including 'Invoicing Template' and 'Sales Contract'. Would you like the detailed merge field metadata for any of them?
```

**Prompt:** 
```
Check the status of the last 5 document generation jobs.
```

**Response:** 
```
Job intelligence orchestrated! For your recent requests, I've identified 5 document generation jobs. 4 are 'COMPLETED' and 1 is 'PROCESSING'. I've retrieved the generation metadata for your review. Need help retrieving the final file URLs?
```

**Prompt:** 
```
Show my DocsGenFlow document generation metrics for this month.
```

**Response:** 
```
Operational monitoring orchestrated! This month, your account has processed 1,000 document generation requests, with a 99% success rate. Your API connection is healthy. Shall I retrieve the detailed template usage breakdown?
```

## Capabilities

### List and Manage Templates
View all available template files (PDF or DOCX) and retrieve details about the merge fields they require.

### Trigger Document Generation
Start a document creation job by providing structured data inputs, triggering the full generation process automatically.

### Check Job Status and History
Track whether a requested document is still processing or if it has successfully finished generating.

### Download Final Assets
Retrieve the final, polished version of the generated file using its unique ID or URL.

### Verify System Connectivity
Confirm that your API connection is active and functioning correctly for immediate document requests.

## Use Cases

### Client Onboarding Packet Creation
A new client signs up and needs 15 different documents (SOW, NDA, Welcome Letter) created. Instead of running 15 separate processes, the agent uses `list_templates` to find all necessary forms, then cycles through them using structured data inputs with `generate_document`, providing one folder of finished files.

### Audit and Compliance Check
The compliance officer needs proof that a specific document was created last month. They use `list_documents` to find the file ID, then use `get_document` to retrieve all associated metadata for internal auditing.

### Operational Performance Review
The manager wants to know how many documents were generated this quarter and if the API is healthy. They run `get_account` and check the generation volume metrics, confirming service scaling capacity.

## Benefits

- Generate complex documents instantly. Instead of manually assembling proposals, just tell your agent what to create; the `generate_document` tool handles the data merging and formatting.
- Manage templates without logging into a separate system. Use `list_templates` or `get_template` to see exactly what fields are available in every document you own.
- Never lose track of a file again. The `list_history` tool gives you a full audit trail, so you know the status and metadata for every job run.
- Get immediate confirmation that your service is working. Running `check_docsgenflow_status` confirms API connectivity before you start any major workflow.
- Save time by avoiding file retrieval headaches. After generation, use `download_document` to get a usable file link right away.

## How It Works

The bottom line is that your AI acts as a dedicated process manager, turning natural language requests into structured, finished documents without you lifting a finger.

1. Subscribe to the DocsGenFlow MCP and grab your API key from the dashboard.
2. Use your AI client to tell your agent what kind of document you need (e.g., 'Create a contract for John Smith').
3. The agent coordinates by calling the necessary tools, generating the file, and presenting the final download link.

## Frequently Asked Questions

**How do I list all available templates using the DocsGenFlow MCP?**
Run `list_templates` to see a complete inventory of every document template you have access to. The response details the name, type (PDF/DOCX), and general availability status.

**What is the difference between `get_template` and generating one?**
`get_template` shows you the raw blueprint—the structure of the document. To get an actual, filled-out file, you must use `generate_document`, which requires passing live data fields.

**Can I check if my DocsGenFlow account is working before generating files?**
Yes, call `check_docsgenflow_status`. This confirms your API connection and ensures that the service is up for immediate use. It's a good first step in any workflow.

**I need to see all documents I’ve ever generated; which tool should I use?**
Use `list_documents` or `list_history`. Both tools provide records of your past work, but `list_history` is better for tracking the status and metadata of job attempts.

**When I use the `generate_document` tool, what format must my input data take?**
You must provide a JSON object containing key-value pairs. The keys in this JSON must match the merge field names defined within your template to ensure correct data mapping.

**If a document generation job fails, how do I find the reason using `list_history`?**
The history records contain status updates and an error log. Reviewing these logs shows specific failure codes or messages that explain why the job could not complete.

**After generating a document, how do I securely retrieve the file using `download_document`?**
The tool requires a unique generation ID and template name. Providing these identifiers confirms ownership and ensures you download the exact version of the file you intended to generate.

**What is the process flow when I use the `create_template` tool?**
First, you define the document structure and all necessary merge fields. Then, the tool creates the template record and makes those defined placeholders available for future document generation.

**How do I find my DocsGenFlow API Key?**
Log in to your account, navigate to **Settings** > **API**, and copy your unique access token from the credentials section.

**Can I retrieve generation status via AI?**
Yes! The `list_history` tool allows your agent to retrieve status metadata for all your document generation requests.

**How do I list my document templates?**
Use the `list_templates` tool to retrieve your complete directory along with the unique identifiers for all managed assets.