# RenderForm MCP

> RenderForm lets you generate dynamic images and PDFs from pre-built templates using an API gateway. You feed it data—like product names or sale dates—and it renders high-quality, branded visuals for social media or reports at scale. It manages all your assets (logos, fonts) so everything looks consistent across every piece of content.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** image-generation, pdf-generation, dynamic-templates, visual-automation, opengraph-images, marketing-assets

## Description

**RenderForm** gives your agent everything it needs to generate professional images and multi-page PDFs using pre-built templates. This server handles visual automation, letting you build marketing materials, social graphics, or dynamic reports just by feeding it data fields. It manages all your brand assets—logos, fonts, colors—so every piece of content looks consistent across the board.

### System Status and Planning Your Job

You gotta start by making sure the system's actually running. You run `check_api_status` to confirm that the RenderForm API is up and spitting out answers. Before you do anything big, check your budget: `get_account_info` retrieves your current usage quota and spending details so you don't get shut down mid-render. To see what templates are floating around, use `list_templates`, which pulls a full list and the IDs for every visual template stored in your account. If you need to know what assets are ready, run `list_assets` to check all uploaded media files or general images.

You can also get organized by checking out your project folders; running `list_projects` shows all the organizational groupings within RenderForm so you know where everything lives. For a quick look at past work, use `list_render_requests`; it pulls up the history of your most recent rendering jobs for fast reference.

### Deep Dive into Templates and Assets

When you select a template ID, don't just assume what's in it. You run `get_template_details` to pull the full structure and data requirements for that specific template, verifying exactly which fields you need to fill out. To make sure your brand stays solid, you use specialized asset tools: `list_logos` shows every logo file uploaded to your account, while `list_available_fonts` retrieves a definitive list of all fonts the server can actually use for text rendering.

### The Rendering Process

When you're ready to generate visuals, it’s straightforward. To create dynamic social media graphics or marketing visuals, you call `render_image`, passing in your template ID and the real-time data fields; this returns a high-resolution PNG or JPG image. For full documents—say, an annual report or a multi-page brochure—you use `render_pdf`. This tool takes your chosen PDF layout template, fills in every variable (like names, figures, dates), and spits out the completed document. To manage all the pieces you're working with, you can also run `list_available_fonts` to make sure the right typefaces are loaded for any specific render.

### Monitoring Your Work

Once you kick off a job, you don't just walk away. You use `get_request_status`, feeding it a specific render job ID, to check if your rendering is finished or still processing. This gives you instant status updates on the job's completion. If you need to see everything that’s happened with renders before, `list_render_requests` shows the full history, so you can keep track of every output generated.

## Tools

### check_api_status
Checks if the RenderForm API is currently operational.

### get_account_info
Retrieves your current account usage, including quota limits and spending details.

### get_request_status
Checks the completion status of a specific render job ID.

### get_template_details
Gets the full structure and data requirements for one specific template by its ID.

### list_assets
Lists all custom assets, like uploaded images or general media files.

### list_available_fonts
Retrieves a list of fonts that the server can use for text rendering.

### list_logos
Shows all logo files uploaded to your account.

### list_projects
Lists all project folders and organizational groupings within RenderForm.

### list_render_requests
Shows a history of your most recent rendering jobs for quick reference.

### list_templates
Retrieves the full list and IDs of all available visual templates in your account.

### render_image
Generates a new image file by applying real-time data to an existing template structure.

### render_pdf
Creates a multi-page PDF document by filling variables into a chosen layout template.

## Prompt Examples

**Prompt:** 
```
List my image templates in RenderForm.
```

**Response:** 
```
I've found your templates. You have 5 active designs including 'IG Post v1' (ID: ig_123) and 'Email Header'. Which one would you like to render?
```

**Prompt:** 
```
Generate a social media banner for our Summer Sale campaign using the product showcase template.
```

**Response:** 
```
Banner generated successfully. Template: "Product Showcase v3" (ID: tpl_8834). Dimensions: 1200x628px (Facebook/LinkedIn optimized). Dynamic fields populated: headline "Summer Sale - Up to 60% Off", product image (uploaded), brand colors applied, CTA button "Shop Now". Output format: PNG (high quality). Download URL generated. The template also auto-generated versions for Instagram (1080x1080) and Twitter (1600x900). All 3 variants saved to your project folder.
```

**Prompt:** 
```
List all available templates in my account and show which ones have been used the most.
```

**Response:** 
```
You have 28 templates. Top 5 by usage: "Social Media Post" (1,234 renders), "Email Header" (890 renders), "Product Card" (678 renders), "Certificate" (456 renders), "Invoice" (234 renders). 8 templates were created this month. Average renders per template: 127. Most popular format: PNG (72%), followed by PDF (18%) and JPG (10%). 3 templates have not been used in 60+ days and may be candidates for archival.
```

## Capabilities

### Generate Dynamic Visuals
You tell it a template ID and data fields; the server returns a high-res PNG or JPG image.

### Automate Document Creation
It takes your chosen PDF template, fills in variables (like names or figures), and spits out the completed document.

### Discover Templates & Assets
You list all available templates (`list_templates`) and check what assets are ready to be used, like logos (`list_logos`).

### Check Status and Quotas
The system tells you if the API is up (`check_api_status`) and how many renders you've left on your account (`get_account_info`).

### Manage Projects & History
You list all projects or recent render requests to see what was done before, using tools like `list_projects`.

## Use Cases

### Rolling out a new product line (Marketing)
The marketer needs 12 different social media banners for a launch. Instead of making them manually, they ask their agent to use `list_templates` first. Then, the agent loops through the product list and calls `render_image` twelve times, ensuring every banner uses the correct logo and current campaign colors.

### Creating a quarterly financial review (Ops)
The ops team needs to compile a 20-page PDF report with variable figures. They use `render_pdf` by pointing it to the master finance template and feeding in the latest quarter's data points, instantly generating the final, compliant document.

### Building an app feature dashboard (Developer)
A developer needs a component that shows dynamic user cards. They use `list_templates` to find the 'User Card' template and then call `get_template_details` to confirm the required inputs before building the rendering logic in their code.

### Debugging asset issues (Team Lead)
A campaign fails because some images look off. The lead uses `list_assets` and checks `get_account_info` to verify which logo version is active, then runs `check_api_status` to ensure the whole system is healthy before retrying renders.

## Benefits

- You get consistent branding everywhere. By managing assets via `list_logos` and `list_available_fonts`, your agent ensures every generated image adheres to brand guidelines automatically.
- Speed up campaigns dramatically. Instead of manual creation, just call `render_image` with a template ID and data payload; the server handles the rest in seconds.
- Track everything you do. Use `list_render_requests` and `get_account_info` to monitor job history and keep tabs on your rendering quota without guessing.
- Handle complex documents easily. The `render_pdf` tool lets you automate compliance reports or invoices, filling dozens of fields across multiple pages reliably.
- Know exactly what you can build. Before trying to render, use `get_template_details` to check a template’s exact variables and structure, preventing failed renders.

## How It Works

The bottom line is: you talk to your agent like it's a file system; the server handles all the complex graphic processing in the background.

1. First, you connect your AI client and provide the necessary RenderForm API Key.
2. Next, you ask your agent to perform an action—for example, 'Render a banner for the summer sale using template ID XYZ.'
3. The server executes the rendering process, uses its assets (fonts, logos) to build the image/PDF, and returns a download URL or status update.

## Frequently Asked Questions

**How do I list my available templates in RenderForm?**
Call `list_templates`. This tool gives you the full IDs and names of every template currently set up on your account, which is the first step before rendering anything.

**What is the difference between render_image and render_pdf?**
The difference is the output format. `render_image` creates visual files like PNG or JPG from a graphical template. `render_pdf` creates structured documents, perfect for invoices or reports.

**I need to know if my API key works; which tool should I use?**
Use the `check_api_status` tool. It's the quickest way to confirm that the server is up and ready to accept rendering requests.

**How can I see what assets are available for my templates using RenderForm?**
You should call `list_assets`. This gives you a centralized view of all media files—fonts, logos, images—that your templates can pull from.

**If I run out of renders or need to check my usage limits, which tool should I use?**
You use `get_account_info` to see your account details and current quota status. This function reports how many renders you've used against your allocated limit, letting you manage expectations before running a big batch job.

**I just submitted a large render request; how can I track its progress using RenderForm?**
Use `get_request_status` to monitor the outcome of any rendering job. This tool provides real-time status updates—like 'pending', 'processing', or 'completed'—so you don't have to wait indefinitely for results.

**Before I render an image, how do I check what specific variables a template supports using RenderForm?**
Run `get_template_details` with the template ID. This provides the full component structure and lists exactly which dynamic fields (like 'headline' or 'product_sku') you can populate when calling `render_image`.

**How do I organize and see all the different campaigns or groups of assets I’ve created in RenderForm?**
The `list_projects` tool shows every project container you've set up. This lets you scope your work, separating assets for Campaign A from those used by Campaign B.

**Can my AI automatically find my RenderForm templates?**
Yes! Use the `list_templates` tool. Your agent will respond with complete metadata for all your templates, including their IDs and descriptions in seconds.

**How do I get an API key?**
Log in to your RenderForm dashboard and navigate to the **API Keys** tab in your account section to copy your unique secret key.

**Can I use dynamic data for my images?**
Yes, you can pass a data object to the `render_image` tool to replace text, images, and colors in your templates programmatically via natural language.