# MCP Server for RenderForm

[RenderForm](https://renderform.io) is an API for automatically generating images, PDFs, screenshots and videos from templates.

This is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that provides tools for interacting with the [RenderForm API](https://api.renderform.io/openapi/docs).

## Features (Tools)

- Render an image/PDF from a template
- Create a screenshot of a web page
- Convert a web page to PDF
- List render results
- Get render result details
- Delete a render result
- List templates
- Get template details
- Delete a template
- Get organization usage (credits, uploads, plan)
- List available fonts

Feel free to add more tools by making a pull request or creating a feature request.

## Installation

To use the MCP server, you'll need an API key. You can create and manage API keys in **RenderForm > Settings > API Keys**.

To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:

```json
{
  "servers": {
    "renderform": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "renderform-mcp", "--api-key=RENDERFORM_API_KEY"]
    }
  }
}
```

Replace `RENDERFORM_API_KEY` with your API key.

For detailed setup guides, see:

- [Cursor AI](https://docs.cursor.com/context/model-context-protocol)
- [Visual Studio Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
- [GitHub Copilot](https://github.blog/changelog/2025-05-19-agent-mode-and-mcp-support-for-copilot-in-jetbrains-eclipse-and-xcode-now-in-public-preview/)
- [Claude Desktop](https://modelcontextprotocol.io/quickstart/user)
- [Windsurf](https://docs.codeium.com/windsurf/mcp)

## Development

1. Install dependencies:

   ```bash
   npm install
   ```

2. Build the server:

   ```bash
   npm run build
   ```

3. Update client to use the local build:
   ```json
   {
     "servers": {
       "renderform": {
         "command": "node",
         "args": ["path/to/renderform-mcp/build/index.js"],
         "env": {
           "RENDERFORM_API_KEY": "your_api_key"
         }
       }
     }
   }
   ```

## Debugging

To debug the MCP server, you can use the MCP Inspector tool:

1. Run the server with the inspector:

   ```bash
   npm run inspector
   ```

2. Open the provided URL in your browser to view and debug the MCP requests and responses.

3. Include the `--api-key` argument.

## Learn more

- [RenderForm developer docs](https://renderform.io/docs)
- [RenderForm API reference](https://api.renderform.io/openapi/docs)
- [Sign up for RenderForm](https://renderform.io)