SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate TemplateFox MCP with Atomic Agent

Connect Atomic Agent to TemplateFox MCP. Generate invoice pdf from sales template, create image from marketing template with variables, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
TemplateFox logoTemplateFox
Api Key

TemplateFox is a template-driven service for generating PDFs and images from reusable templates. It helps teams automate templated documents, manage versions, and store outputs reliably.

24 Tools

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 TemplateFox.

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 TemplateFox account. See the Atomic Agent documentation for installation instructions.

Also integrate TemplateFox with

ChatGPTClaude CoworkHermes

How Atomic Agent connects to TemplateFox

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 TemplateFox to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. 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.
  3. Ask Atomic Agent to do something in TemplateFox. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your TemplateFox 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 TemplateFox MCP server, and what's possible with it?

The TemplateFox MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your TemplateFox account. It provides structured and secure access so your agent can perform TemplateFox operations on your behalf.

Use TemplateFox from Atomic Agent

With your account connected, ask Atomic Agent to work with TemplateFox in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

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 for the current limits that apply to your connection.

TOOLS

Supported Tools

Every TemplateFox action and event your agent gets out of the box.

Create Template With Agent

Queue TemplateFox's authoring agent to create an image template from natural-language instructions.

Create Image

Generate a PNG, JPEG, or WebP image from a TemplateFox image template and return a temporary URL or configured S3 location.

Create PDF

Generate a PDF synchronously from a TemplateFox template and return a temporary URL or configured S3 location.

Create PDF Asynchronously

Queue PDF generation and return a job ID for polling.

Create Template Version

Create an immutable snapshot of an existing TemplateFox template with a unique lowercase tag.

Delete S3 Configuration

Permanently remove the connected account's saved S3-compatible storage credentials.

Delete Template Version

Permanently delete one immutable template version.

Extract PDF Pages

Extract, reorder, or split selected pages from one PDF and return a temporary result URL.

Get Account

Get the connected TemplateFox account identity and remaining credit balance without consuming credits.

Get Agent Job

Get an authoring-agent job's status, resulting template ID, preview, charged credits, or failure details.

Get PDF Job

Get the status, result location, or failure details of an asynchronous PDF generation job.

Get S3 Configuration

Get the connected account's S3-compatible storage configuration.

List Account Transactions

List credit purchases, consumption, refunds, and bonuses one offset page at a time.

List PDF Jobs

List asynchronous PDF generation jobs, optionally filtered by status, one offset page at a time.

List Template Fields

List the dynamic variables a template accepts so an agent can construct valid generation data.

List Template Layers

List addressable image-template layers and their modifiable properties for CREATE_IMAGE.

List Templates

List PDF or image templates belonging to the connected TemplateFox team.

List Template Versions

List immutable snapshots of a template, including version numbers and optional tags.

Merge PDFs

Concatenate two or more PDFs in the supplied order and return a temporary result URL.

Revise Template With Agent

Queue TemplateFox's authoring agent to revise an existing image template from feedback.

Rotate PDF

Rotate all pages or selected pages in a PDF and return a temporary result URL.

Save and Test S3 Configuration

Create or update the connected account's S3-compatible storage credentials, then test access to the configured bucket.

Update Template Version

Change or clear the tag and/or description metadata of a template version; the immutable snapshot content is not changed.

Validate S3 Configuration

Validate that TemplateFox can access and write a small test object to the configured S3-compatible bucket without changing the saved credentials.

FRAMEWORKS

How to build TemplateFox MCP Agent with another framework

ChatGPT logo

ChatGPT

Use TemplateFox MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use TemplateFox MCP with Claude Cowork

Hermes logo

Hermes

Use TemplateFox MCP with Hermes

FAQ

Frequently asked questions

With a standalone TemplateFox MCP server, the agents and LLMs can only access a fixed set of TemplateFox tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from TemplateFox and many other apps based on the task at hand, all through a single MCP endpoint.

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 TemplateFox tools.

Yes, absolutely. You can configure which TemplateFox 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.

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 TemplateFox data and credentials are handled as safely as possible.

Start with TemplateFox.It takes 30 seconds.

Managed auth, hosted MCP servers, and every TemplateFox tool your agent needs.Free to start.

Start building