How to Use the cloudlayer.io MCP in Mastra AI

Q: How do I register the cloudlayer.io MCP Server in Mastra AI?

Use the @mastra/mcp package to initialize the client with your Vinkius URL. Spread the tools from mcpClient.listTools() into your Mastra agent's tool array.

Q: Can Mastra AI handle human approval before cloudlayer.io runs?

Yes, you can set requireToolApproval on tools like converthtmltopdf. This pauses the Mastra workflow until a human reviews the HTML before the server generates the PDF.

Q: How do I check my cloudlayer.io API usage within Mastra AI?

Your Mastra agent can run getcloudlayerusagestats as a pre-flight check in your automated workflow. This ensures your workflow pauses or alerts you before hitting hard limits.

Q: Can I dynamically select templates for PDF generation?

Yes, your agent can query listpdftemplates to find the right Nunjucks layout. Mastra then passes that template ID directly to the generation tools.

Build resilient, auto-retrying document workflows in Mastra AI using the cloudlayer.io MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect cloudlayer.io MCP to Mastra AI

Create your Vinkius account to connect cloudlayer.io to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup cloudlayer.io with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate PDF generation with Mastra AI workflows

Mastra AI excels at handling complex multi-step processes. By connecting this MCP Server, your agent can call `convert_url_to_pdf` as part of a structured billing workflow that automatically retries if a network blip occurs. If a conversion fails, Mastra's workflow engine catches the error, backs off, and tries the generation again. Your agent doesn't get stuck, and your system gets its PDF without manual intervention.

Track document history with Mastra agents

Keep tabs on your automated pipelines by letting your agent run `list_generation_history`. Mastra AI monitors these logs to verify that all invoices and screenshots were created successfully. The agent uses this historical data to decide if a document needs a rebuild or if it can pull from the cache. This keeps your API usage low and your workflows running fast.

Manage cloudlayer.io webhooks inside Mastra

When handling large batches of documents, you don't want your agent waiting around. Use `list_cloudlayer_webhooks` inside a Mastra workflow to register async listeners for completed files. Once the webhook fires, Mastra triggers the next step in the pipeline, like emailing the PDF to a client or updating a database record.

Setup guide

Set up cloudlayer.io MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All cloudlayer.io tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "cloudlayerio-mcp-client",
  servers: {
    "cloudlayerio-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "cloudlayer.io Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to cloudlayer.io tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent cloudlayer.io transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by cloudlayer.io. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect cloudlayer.io now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about cloudlayer.io MCP in Mastra AI

Use the `@mastra/mcp` package to initialize the client with your Vinkius URL. Spread the tools from `mcpClient.listTools()` into your Mastra agent's tool array.

Yes, you can set `requireToolApproval` on tools like `convert_html_to_pdf`. This pauses the Mastra workflow until a human reviews the HTML before the server generates the PDF.

Your Mastra agent can run `get_cloudlayer_usage_stats` as a pre-flight check in your automated workflow. This ensures your workflow pauses or alerts you before hitting hard limits.

Yes, your agent can query `list_pdf_templates` to find the right Nunjucks layout. Mastra then passes that template ID directly to the generation tools.

All HTML strings and URLs sent to the server are processed over TLS. Vinkius runs the MCP Server in a zero-trust environment, ensuring your document source data is never stored permanently or used for training.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript