Cloudlayer MCP server

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.

What you can do with the Cloudlayer MCP server

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.

Connect Cloudlayer to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. 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.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Cloudlayer tools.

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.

More integrations teams use with Cloudlayer

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Netlify

Manage web application sites, deploys, builds, build hooks, deployed files, metadata, and hosting on Netlify. Create, update, configure, list, and delete sites. Manage environment variables with per-context values and scopes. Access and manage form submissions, including spam filtering. Configure DNS zones and records. Inject JavaScript or HTML snippets into site pages. Create and manage split tests (A/B testing) for traffic routing between branches. Set up notification hooks for deploy and form submission events. Purge CDN cached content by site or cache tag.

Typeform

Create, retrieve, update, and delete online forms and surveys. Manage form responses, including filtering by date and deleting submissions. Configure webhooks to receive real-time notifications on form submissions and partial responses. Upload and manage images, create and apply visual themes, and organize forms across workspaces with team collaboration. Translate forms into multiple languages, retrieve form insights and analytics, and download files uploaded by respondents.

WordPress

Create, read, update, and delete WordPress posts and pages. Manage media library items, comments, categories, tags, site users, site metadata, editable site settings, content search, and WordPress.com site statistics. Supports WordPress.com hosted sites via OAuth and self-hosted WordPress sites via application passwords.

Technical notes for Cloudlayer

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.

  1. 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.
  2. Cloudlayer exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Cloudlayer MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Cloudlayer and which of its tools they can call.
  5. 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.