Connect Cloudlayer to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the list jobs tool in Cloudlayer
Use the get account status tool in Cloudlayer
Use the generate image from url tool in Cloudlayer
Use the generate image from template tool in Cloudlayer
Use the list assets tool in Cloudlayer
Use the generate image from html tool in Cloudlayer
Supported Tools
list_jobs
List Jobs
List your document generation jobs, ordered by creation date (newest first). Use startAfterId for cursor pagination. The provider overview and endpoint-specific pagination documentation differ; cursor behavior depends on the API deployment.
get_account_status
Get Account Status
Check your Cloudlayer account status including remaining API credits and rate limit information. This endpoint does not consume API credits.
generate_image_from_url
Generate Image from URL
Capture a publicly accessible web page and convert it into an image (PNG, JPG, or WebP). Useful for turning dashboards or web pages into image snapshots.
Optionally provide HTTP Basic Auth credentials or session cookies if the target URL requires authentication.
The API call is asynchronous by default and returns a job ID.
generate_image_from_template
Generate Image from Template
Generate an image (PNG, JPG, or WebP) using a predefined template from the Cloudlayer gallery or a custom Nunjucks HTML template. Pass in your dynamic data to populate template variables.
For predefined templates, provide the **templateId** and matching **templateData**. For custom templates, provide a base64-encoded HTML template string.
The API call is asynchronous by default and returns a job ID.
list_assets
List Assets
List generated assets (PDFs and images) stored in your Cloudlayer account. Returns asset metadata including download URLs. Use startAfterId for cursor pagination. Use get_asset to download a selected file.
generate_image_from_html
Generate Image from HTML
Convert HTML content into an image (PNG, JPG, or WebP). Provide your HTML as a **base64-encoded string** — it can include JavaScript, CSS, custom fonts, and image imports.
Configure viewport dimensions, device scale factor, output format, and enable transparent backgrounds for PNG/WebP.
The API call is asynchronous by default and returns a job ID.
get_job
Get Job
Retrieve the details and status of a specific document generation job by its ID. Use this to check whether an asynchronous PDF or image generation job has completed and inspect the provider response. Use retrieve_job_asset after success to download the result.
generate_pdf_from_url
Generate PDF from URL
Capture a publicly accessible web page and convert it into a PDF document. Supports batch processing — provide an array of URLs to combine into a single multi-page PDF.
Optionally provide HTTP Basic Auth credentials or session cookies if the target URL requires authentication.
The API call is asynchronous by default and returns a job ID.
generate_pdf_from_template
Generate PDF from Template
Generate a PDF document using a predefined template from the Cloudlayer gallery or a custom Nunjucks HTML template. Pass in your dynamic data to populate template variables.
For predefined templates, provide the **templateId** and matching **templateData**. For custom templates, provide a base64-encoded HTML template string.
The API call is asynchronous by default and returns a job ID.
generate_pdf_from_html
Generate PDF from HTML
Convert HTML content into a PDF document. Provide your HTML as a **base64-encoded string** — it can include JavaScript, CSS, imported fonts, embedded images, and external resources. Configure paper format, margins, headers/footers, orientation, and more.
The API call is asynchronous by default and returns a job ID. Use get_job to check completion, then retrieve_job_asset to download the result.
get_asset
Get Asset
Retrieve details for a specific generated asset (PDF or image) by its ID. Returns asset metadata and prepares the generated file for download.
get_account
Get Account
Identify the account connected to the API key and inspect its subscription, API usage, storage, and credit balance.
retrieve_job_asset
Retrieve Job Asset
Check a generation job and download its stored PDF or image after it succeeds. Correlates the provider asset jobId with the actual job ID. Searches a bounded number of asset pages; pass nextAssetCursor to continue if the result is older.
Enable Cloudlayer in Metorial. In your Metorial portal, enable the Cloudlayer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Cloudlayer tools.
Enable Cloudlayer in Metorial. In your Metorial portal, enable the Cloudlayer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Cloudlayer tools.
Enable Cloudlayer in Metorial. In your Metorial portal, enable the Cloudlayer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Cloudlayer tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Cloudlayer in Metorial. In your Metorial portal, enable the Cloudlayer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Cloudlayer tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Cloudlayer in Metorial. In your Metorial portal, enable the Cloudlayer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Cloudlayer tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Cloudlayer through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Cloudlayer and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Cloudlayer tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Generate PDF and image documents from HTML content, URLs, or templates. Convert web pages and HTML into PDFs with configurable paper formats, margins, headers/footers, and orientation. Generate images (PNG, JPG, WebP) from HTML or URLs with configurable viewports and transparency. Use predefined or custom Nunjucks templates with dynamic data for document generation. Batch-convert multiple URLs into a single combined PDF. Store generated assets in cloud storage with CDN access or custom S3-compatible storage. Generate image previews and thumbnails of documents. Manage jobs and check account status and credits.
Frequently asked questions
Common questions about connecting Cloudlayer to AI agents with Metorial.
How many tools does the Cloudlayer MCP server have?
The Cloudlayer MCP server exposes 13 tools, including List Jobs, Get Account Status, Generate Image from URL. Each one is governed and traced through Metorial.
Does the Cloudlayer MCP server support triggers?
Cloudlayer exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Cloudlayer MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Cloudlayer MCP server through the same Metorial URL.
How do I give only some teams access to Cloudlayer?
Use role-based access control to decide which teams, users, and agents can use Cloudlayer and which of its tools they can call.
Can I self-host the Cloudlayer MCP server?
Yes. Metorial is open source, so you can run the Cloudlayer MCP server yourself or use the hosted gateway.
Connect Cloudlayer to production AI agents
See how Metorial gives your team governed access to Cloudlayer, with tracing and security controls built in.