SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Render MCP with Mastra AI

Connect Mastra AI to Render MCP. Deploy latest code to staging service, restart production web service now, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Render logoRender
Api Key

Render is a unified cloud platform for building and running apps and websites. It simplifies deployment, scaling, and management across your projects.

216 Tools

Introduction

This guide walks you through connecting Render to Mastra AI using the Composio tool router. By the end, you'll have a working Render agent that can deploy and roll back services, manage environment variables, provision Postgres and Key Value databases, read logs, and scale services through natural language commands.

This guide will help you understand how to give your Mastra AI agent real control over a Render account through Composio's Render MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Render with

Claude CodeCursorChatGPTClaude CoworkAntigravityOpenAI Agents SDKClaude Agent SDKCodexGrok BuildVS CodeOpenCodeOpenClawHermesAtomic AgentPiDeepSeek HarnessGoogle ADKLangChainVercel AI SDKLlamaIndexCrewAIPydantic AIAutoGen

TL;DR

Here's what you'll learn:
  • Set up your environment so Mastra, OpenAI, and Composio work together
  • Create a Tool Router session in Composio that exposes Render tools
  • Connect Mastra's MCP client to the Composio generated MCP URL
  • Fetch Render tool definitions and attach them as a toolset
  • Build a Mastra agent that can reason, call tools, and return structured results
  • Run an interactive CLI where you can chat with your Render agent

What is Mastra AI?

Mastra AI is a TypeScript framework for building AI agents with tool support. It provides a clean API for creating agents that can use external services through MCP.

Key features include:

  • MCP Client: Built-in support for Model Context Protocol servers
  • Toolsets: Organize tools into logical groups
  • Step Callbacks: Monitor and debug agent execution
  • OpenAI Integration: Works with OpenAI models via @ai-sdk/openai

What is the Render MCP server, and what's possible with it?

The Render MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Render account. It provides structured and secure access to your cloud infrastructure, so your agent can perform actions like deploying applications, managing services, monitoring site health, restarting instances, and scaling resources on your behalf.

  • Automated application deployment: Instantly deploy new web apps or services without manual steps, letting your agent handle setup and rollouts.
  • Service monitoring and status checks: Ask your agent to check the health and uptime of your apps or services, so you’re always up to speed on what’s running smoothly—and what’s not.
  • Instance management and restarts: Enable your agent to restart, stop, or scale up/down your running services to quickly respond to changes or issues.
  • Resource scaling and configuration: Let your agent adjust resource allocations, increasing or decreasing capacity based on current needs or traffic spikes.
  • Error diagnostics and log retrieval: Have your agent fetch logs or error reports to help troubleshoot issues before they become major problems.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Node.js 18 or higher
  • A Composio account with an active API key
  • An OpenAI API key
  • Basic familiarity with TypeScript
2

Getting API Keys for OpenAI and Composio

OpenAI API Key
  • Go to the OpenAI dashboard and create an API key.
  • You need credits or a connected billing setup to use the models.
  • Store the key somewhere safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Go to Settings and copy your API key.
  • This key lets your Mastra agent talk to Composio and reach Render through MCP.
3

Install dependencies

bash
npm install @composio/core @mastra/core @mastra/mcp @ai-sdk/openai dotenv

Install the required packages.

What's happening:

  • @composio/core is the Composio SDK for creating MCP sessions
  • @mastra/core provides the Agent class
  • @mastra/mcp is Mastra's MCP client
  • @ai-sdk/openai is the model wrapper for OpenAI
  • dotenv loads environment variables from .env
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_here

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates your requests to Composio
  • COMPOSIO_USER_ID tells Composio which user this session belongs to
  • OPENAI_API_KEY lets the Mastra agent call OpenAI models
5

Import libraries and validate environment

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey as string,
});
What's happening:
  • dotenv/config auto loads your .env so process.env.* is available
  • openai gives you a Mastra compatible model wrapper
  • Agent is the Mastra agent that will call tools and produce answers
  • MCPClient connects Mastra to your Composio MCP server
  • Composio is used to create a Tool Router session
6

Create a Tool Router session for Render

typescript
async function main() {
  const session = await composio.create(
    composioUserID as string,
    {
      toolkits: ["render"],
    },
  );

  const composioMCPUrl = session.mcp.url;
  console.log("Render MCP URL:", composioMCPUrl);
What's happening:
  • create spins up a short-lived MCP HTTP endpoint for this user
  • The toolkits array contains "render" for Render access
  • session.mcp.url is the MCP URL that Mastra's MCPClient will connect to
7

Configure Mastra MCP client and fetch tools

typescript
const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      nasdaq: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

console.log("Fetching MCP tools from Composio...");
const composioTools = await mcpClient.getTools();
console.log("Number of tools:", Object.keys(composioTools).length);
What's happening:
  • MCPClient takes an id for this client and a list of MCP servers
  • The headers property includes the x-api-key for authentication
  • getTools fetches the tool definitions exposed by the Render toolkit
8

Create the Mastra agent

typescript
const agent = new Agent({
    name: "render-mastra-agent",
    instructions: "You are an AI agent with Render tools via Composio.",
    model: "openai/gpt-5",
  });
What's happening:
  • Agent is the core Mastra agent
  • name is just an identifier for logging and debugging
  • instructions guide the agent to use tools instead of only answering in natural language
  • model uses openai("gpt-5") to configure the underlying LLM
9

Set up interactive chat interface

typescript
let messages: AiMessageType[] = [];

console.log("Chat started! Type 'exit' or 'quit' to end.\n");

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: "> ",
});

rl.prompt();

rl.on("line", async (userInput: string) => {
  const trimmedInput = userInput.trim();

  if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
    console.log("\nGoodbye!");
    rl.close();
    process.exit(0);
  }

  if (!trimmedInput) {
    rl.prompt();
    return;
  }

  messages.push({
    id: crypto.randomUUID(),
    role: "user",
    content: trimmedInput,
  });

  console.log("\nAgent is thinking...\n");

  try {
    const response = await agent.generate(messages, {
      toolsets: {
        render: composioTools,
      },
      maxSteps: 8,
    });

    const { text } = response;

    if (text && text.trim().length > 0) {
      console.log(`Agent: ${text}\n`);
        messages.push({
          id: crypto.randomUUID(),
          role: "assistant",
          content: text,
        });
      }
    } catch (error) {
      console.error("\nError:", error);
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    console.log("\nSession ended.");
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});
What's happening:
  • messages keeps the full conversation history in Mastra's expected format
  • agent.generate runs the agent with conversation history and Render toolsets
  • maxSteps limits how many tool calls the agent can take in a single run
  • onStepFinish is a hook that prints intermediate steps for debugging

Complete Code

Here's the complete code to get you started with Render and Mastra AI:

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({ apiKey: composioAPIKey as string });

async function main() {
  const session = await composio.create(composioUserID as string, {
    toolkits: ["render"],
  });

  const composioMCPUrl = session.mcp.url;

  const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      render: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

  const composioTools = await mcpClient.getTools();

  const agent = new Agent({
    name: "render-mastra-agent",
    instructions: "You are an AI agent with Render tools via Composio.",
    model: "openai/gpt-5",
  });

  let messages: AiMessageType[] = [];

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: "> ",
  });

  rl.prompt();

  rl.on("line", async (input: string) => {
    const trimmed = input.trim();
    if (["exit", "quit"].includes(trimmed.toLowerCase())) {
      rl.close();
      return;
    }

    messages.push({ id: crypto.randomUUID(), role: "user", content: trimmed });

    const { text } = await agent.generate(messages, {
      toolsets: { render: composioTools },
      maxSteps: 8,
    });

    if (text) {
      console.log(`Agent: ${text}\n`);
      messages.push({ id: crypto.randomUUID(), role: "assistant", content: text });
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main();

Conclusion

You've built a Mastra AI agent that can interact with Render through Composio's Tool Router. You can extend this further by:
  • Adding other toolkits like Gmail, Slack, or GitHub
  • Building a web-based chat interface around this agent
  • Using multiple MCP endpoints to enable cross-app workflows
TOOLS

Supported Tools

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

Add Disk

Attach a persistent disk to a web service, private service, or background worker.

Add Header Rule

Tool to add a custom HTTP header rule to a Render service.

Add or Update Secret File

Tool to add or update a secret file for a Render service.

Add Resources to Environment

Tool to add resources to a Render environment.

Add Route

Tool to add redirect or rewrite rules to a Render service.

Update Service Autoscaling

Replace a Render service's autoscaling configuration with explicit minimum and maximum instance counts and CPU and memory utilization targets.

Cancel Cron Job Run

Cancel the currently running execution of a Render cron job.

Cancel Deploy

Cancel an in-progress deploy for an existing Render service.

Cancel Job

Cancel a running one-off job for a service and return the provider's job details.

Cancel Task Run

Cancel a running Render workflow task run by its task run ID.

Create Build Source

Create a reusable Git-backed or image-backed Render build source and optionally link services.

Create Custom Domain

Tool to add a custom domain to a Render service.

Create Dedicated IP

Create a dedicated IP set for a workspace in a selected Render region.

Create Environment Group

Tool to create a new environment group.

Create Environment

Tool to create a new environment within a Render project.

Create Job

Create a one-off job from an existing Render service using a start command and optional instance plan.

Create Key Value Instance

Provision a Render Key Value instance for a workspace with a required name and plan.

Create Postgres Instance

Tool to create a new Postgres instance on Render.

Create Postgres Export

Start a logical backup export of a Render Postgres instance by ID.

Create Postgres User

Create a PostgreSQL user on a Render Postgres instance by ID.

Create Project

Create a Render project and its initial environments in an owner's workspace.

Create Registry Credential

Tool to create a registry credential.

Create Service

Create a static site, web/private service, background worker, or cron job.

Create Webhook

Create a Render webhook for a team or personal owner and return its signing secret.

Create Workflow

Create a Render workflow service in a workspace from a repository, runtime, build command, and run command.

Create Workflow Version

Create and deploy a new version of an existing Render workflow, optionally selecting a Git commit.

Delete Autoscaling Config

Delete the autoscaling configuration for an existing Render service.

Delete Build Source

Delete a shared Render build source by ID.

Delete Build Source Environment Variable

Delete one environment variable set directly on a Render build source by key.

Delete Build Source Secret File

Delete one secret file set directly on a Render build source by file name.

Delete Custom Domain

Delete a custom domain from a Render service using its domain ID or name.

Delete Dedicated IP Set

Delete a Render dedicated IP set by its ID.

Delete Disk

Permanently delete a persistent disk attached to a service.

Delete Environment Group

Delete an environment group by ID, including all environment variables and secret files it contains.

Delete Environment Group Variable

Tool to remove an environment variable from an environment group.

Delete Environment Group Secret File

Tool to remove a secret file from an environment group.

Delete Environment

Tool to delete a specified environment.

Delete Environment Variable

Delete one environment variable set directly on a Render service.

Delete Header Rule

Delete a particular response header rule from a Render service.

Delete Key Value

Tool to delete a Key Value instance.

Delete Owner Log Stream

Tool to delete a log stream for an owner.

Delete Owner Metrics Stream

Tool to delete a metrics stream for a workspace.

Delete Postgres Instance

Permanently delete a Postgres instance by ID.

Delete PostgreSQL User

Delete a PostgreSQL user from the specified Render Postgres instance.

Delete Project

Delete a Render project by ID.

Delete Registry Credential

Tool to delete a registry credential.

Delete Resource Log Stream Override

Remove the log stream override for a Render resource by its ID.

Delete Route

Delete a particular redirect or rewrite rule from a Render service.

Delete Secret File

Tool to delete a secret file from a Render service.

Delete Service

Tool to delete a service.

Delete Webhook

Permanently delete a Render webhook by ID, stopping its event deliveries.

Delete Workflow

Delete a Render workflow service by its workflow ID.

Disconnect Blueprint

Tool to disconnect a blueprint from your Render account.

Failover Postgres Instance

Trigger failover for a highly available Render Postgres instance by ID.

Get Active Connections

Tool to get active connection count metrics for Render resources.

Get Bandwidth Usage

Get bandwidth usage time series for Render services over a time range.

Get Bandwidth Sources

Tool to get bandwidth usage breakdown by traffic source.

Get CPU Usage

Tool to retrieve CPU usage metrics for Render resources.

Get CPU Limit

Tool to retrieve CPU limit metrics for Render resources.

Get CPU Target

Get CPU target metrics for one or more Render resources over a time range.

Get Disk Capacity

Tool to get disk capacity metrics for Render resources.

Get Disk Usage

Tool to retrieve disk usage metrics for Render resources.

Get Environment Variables for Build Source

List one page of environment variables for a Render build source.

Get HTTP Latency

Retrieve HTTP latency time series for Render services over a time range.

Get HTTP Request Counts

Get HTTP request counts for Render services over a time range.

Get Instance Count

Tool to get instance count metrics for Render resources.

Get Memory Usage

Tool to get memory usage metrics for one or more resources.

Get Memory Limit

Tool to get memory limit metrics for Render resources over a specified time range.

Get Memory Target

Get memory target metrics for Render resources, including services, Postgres databases, or Redis instances, over a specified time range.

Get Owner Log Stream

Retrieve log stream settings for a Render workspace by workspace ID.

Get Owner Metrics Stream

Retrieve the metrics stream integration configured for a Render workspace.

Get Replication Lag

Get seconds of replica lag for Render Postgres replicas over a time range.

Get Resource Log Stream

Retrieve a Render resource's log stream override by resource ID.

Get Task Runs Completed Count

Get completed task run counts over time for one or more Render tasks.

Get Task Runs Queued Count

Get the total number of task runs queued for one or more Render tasks.

Get User

Tool to get the authenticated user.

Link Environment Group to Build Source

Link an existing environment group to a Render build source, granting build-time access to its variables and files.

Link Service to Environment Group

Tool to link a service to an environment group.

List Application Filter Values

Tool to list queryable instance values for application metrics.

List Blueprints

List a page of Render blueprints, optionally filtered by workspace, with cursors for retrieving additional pages.

List Blueprint Syncs

List one page of sync history for a Render Blueprint.

List Builds in Build Source

List one page of builds in a Render build source, newest first.

List Build Sources

List one page of Render build sources, optionally filtered by name, workspace, project, preview inclusion, or creation/update times.

List Custom Domains

List one page of a Render service's custom domains, optionally filtering by name, domain type, verification status, or creation time.

List Dedicated IPs

List dedicated IP sets for a Render workspace, including assigned addresses and provisioning status.

List Deploys

List recent deploys for a Render service with pagination.

List Disks

List a page of Render disks, with optional filters and pagination for retrieving additional pages.

List Environment Groups

Tool to list environment groups.

List Environments

Tool to list environments for a project.

List Environment Variables for Service

Tool to list all environment variables configured directly on a Render service (with pagination).

List Header Rules

List response-header rules configured for a Render static site.

List HTTP Filter Values

Discover queryable HTTP status codes and hosts for Render service metrics.

List Instances

Tool to list instances of a service.

List Jobs

List one page of a Render service's one-off jobs, optionally filtering by status and creation, start, or finish time.

List Key Value Instances

List a page of Key Value instances associated with your account, optionally filtering by name, region, owner, environment, or timestamps.

List Logs

Tool to list logs for a specific workspace and resource.

List Log Label Values

Tool to list log label values for a workspace.

List Maintenance Runs

Tool to list maintenance runs.

List Notification Overrides

Tool to list notification overrides for services.

List Organization Audit Logs

Retrieve one page of audit logs for a Render organization, optionally filtered by start and end time and ordered forward or backward.

List Workspace Audit Logs

List one page of audit logs for a Render workspace, optionally filtered by time range and ordered newest or oldest first.

List Workspace Members

Tool to list workspace members.

List Owners

Tool to list owners (users and teams).

List Path Filter Values

List queryable HTTP request paths for Render service metrics.

List Postgres Instances

List a page of Render Postgres instances, optionally filtering by name, region, or other criteria.

List Postgres Exports

Tool to list all exports for a Postgres instance.

List Postgres Processes

List currently running queries from pg_stat_activity on a Render Postgres instance.

List Postgres Sizes

List database, table, and index sizes on a Render Postgres instance by ID.

List Postgres Table Scans

List sequential scan counts for each table on a Render Postgres instance by ID.

List Postgres Top Queries

List the top 50 queries by total execution time from pg_stat_statements on a Render Postgres instance.

List PostgreSQL Users

Tool to list PostgreSQL user credentials for a Render PostgreSQL database instance.

List Projects

List Projects

List Registry Credentials

Tool to list registry credentials.

List Resource Log Streams

Tool to list resource log stream overrides.

List Routes

Tool to list redirect/rewrite rules for a service.

List Secret Files

List a page of secret files for a Render service, including their contents.

List Secret Files for Build Source

List one page of secret files for a Render build source.

List Service Events

List recent lifecycle events for a Render service with optional filters.

List Services

List a page of services accessible to the authenticated account, optionally filtering by name or type.

List Snapshots

List point-in-time snapshots for a Render persistent disk by disk ID.

List Task Runs

Tool to list task runs.

List Tasks

Tool to list tasks.

List Webhook Events

List one page of events sent to a Render webhook, optionally filtered by sent time.

List Webhooks

List configured webhooks for your account, optionally filtering by workspace.

List Workflows

Tool to list workflows.

List Workflow Versions

Tool to list workflow versions.

Patch Service Notification Overrides

Update notification overrides for a Render service by service ID.

Create Service Preview

Create a preview instance of an image-backed service and start its deploy.

Purge Web Service Cache

Trigger a cache purge for a Render web service with caching enabled.

Recover Postgres

Initiate point-in-time recovery into a new Render Postgres database.

Remove Resources from Environment

Remove specified resources from a Render environment by ID.

Remove Workspace Member

Remove an existing user from a Render workspace.

Restart Postgres

Restart a Render Postgres instance by ID.

Restart Service

Tool to restart a service.

Restore Snapshot

Restore a persistent disk to an available snapshot and return the disk.

Resume Key Value

Resume a suspended Render Key Value instance by ID.

Resume Postgres Instance

Resume a suspended Postgres instance by ID without recreating it.

Resume Service

Tool to resume a suspended service.

Retrieve Blueprint

Retrieve a Blueprint by ID, including its Git configuration, sync status, and managed resources.

Retrieve Build Source

Retrieve a shared Render build source by ID, including its Git or external-image configuration and currently linked services.

Retrieve Build Source Build

Retrieve a specific build of a Render build source, including build run status and commit details or the container image details.

Retrieve Build Source Environment Variable

Check that an environment variable exists directly on a Render build source by key.

Retrieve Build Source Secret File

Check that a named secret file exists directly on a Render build source.

Retrieve Custom Domain

Tool to retrieve a specific custom domain for a service.

Retrieve Dedicated IP Set

Retrieve a Render dedicated IP set by ID, including its assigned IPv4 addresses, workspace, region, environment scope, and provisioning status.

Retrieve deploy

Retrieve deploy

Retrieve Disk

Retrieve one persistent disk by ID, including size, mount path, and associated service.

Retrieve Environment Group

Tool to retrieve a specific environment group by ID.

Retrieve Environment Variable

Tool to retrieve a specific environment variable from a Render environment group.

Retrieve Environment Group Secret File

Tool to retrieve secret file from an environment group.

Retrieve Environment

Retrieve a Render environment by its ID, including resources and network settings.

Retrieve Environment Variable

Tool to retrieve a specific environment variable from a Render service.

Retrieve Event

Retrieve one Render event by its event ID, including its timestamp, resource ID, type, and event-specific details.

Retrieve Job

Retrieve a service's one-off job by ID, including its command, plan, status, and timestamps.

Retrieve Key Value Instance

Retrieve one Key Value instance by its Render ID.

Retrieve Maintenance Run

Retrieve a maintenance run by ID to inspect its schedule, state, resource, and scheduling deadline.

Retrieve Owner

Tool to retrieve a specific owner (workspace) by ID.

Retrieve Owner Notification Settings

Tool to retrieve notification settings for a specific owner (workspace).

Retrieve Postgres Instance

Tool to retrieve a specific Postgres instance.

Retrieve Postgres Recovery Info

Retrieve point-in-time recovery availability for a Render Postgres instance by ID.

Retrieve Project

Tool to retrieve a specific project by ID.

Retrieve Registry Credential

Tool to retrieve a registry credential by ID.

Retrieve Secret File

Tool to retrieve a secret file from a Render service.

Retrieve Service

Tool to retrieve a specific service by ID.

Retrieve Service Notification Overrides

Retrieve notification overrides for a Render service by service ID.

Retrieve Service Outbound IPs

Retrieve a service's outbound IP addresses and whether they belong to a dedicated IP set or Render's shared regional IPs.

Retrieve Task

Retrieve a Render workflow task by its task ID, returning its name, creation timestamp, and associated workflow and version IDs when present.

Retrieve Task Run

Retrieve a Render workflow task run by ID, including its status, input, output results, errors, retry count, and execution attempts.

Retrieve Webhook

Retrieve a Render webhook by its webhook ID, including its destination URL, signing secret, enabled status, and subscribed event types.

Retrieve Workflow

Retrieve an existing Render workflow service by ID, including its repository, build configuration, run command, region, and automatic deployment settings.

Retrieve Workflow Version

Retrieve a specific Render workflow service version by its version ID, including its parent workflow, creation time, and build/registration status.

Roll Back Deploy

Trigger a rollback to a previous deploy of an existing Render service.

Run Cron Job

Trigger a run of an existing Render cron job and cancel any active runs of that cron job.

Run Task

Start a run of an existing Render workflow task with positional or named input arguments.

Scale Service

Scale a service to a fixed number of instances.

Stream Task Runs Events

Request task run events via Server-Sent Events for specified task run IDs and return the initial event-stream chunk, if available.

Subscribe to Logs

Request a WebSocket upgrade for a filtered real-time log subscription.

Suspend Key Value

Suspend a Render Key Value instance by ID without deleting it.

Suspend Postgres

Suspend a Render Postgres instance by ID without deleting it.

Suspend Service

Tool to suspend a service.

Trigger Build Source Build

Start an asynchronous build of a Git build source at its branch's current HEAD, even if an up-to-date build exists.

Trigger Deploy

Tool to trigger a new deploy for a specified service.

Trigger Maintenance Run

Trigger a scheduled Render maintenance run by its maintenance run ID.

Unlink Environment Group From Build Source

Unlink an environment group from a build source.

Unlink Service From Environment Group

Unlink a service from an environment group.

Update Blueprint

Update a Render Blueprint's name, auto-sync setting, file path, or branch.

Update Build Source

Update a shared Render build source's name, Git configuration, or external image reference.

Update Build Source Environment Variable

Create or rotate one build-source environment variable using a server-generated value.

Update Dedicated IP Set

Update an existing dedicated IP set's name, description, or environment scope.

Update Disk

Update a persistent disk's name, size, or mount path.

Update Environment Group

Tool to update an environment group's name.

Update Environment Group Variable

Tool to add or update an environment variable in an environment group.

Update Environment Group Secret File

Tool to add or update a secret file in an environment group.

Update Environment

Update a Render environment's name, network isolation, protection, or IP allow list.

Update Environment Variable

Tool to add or update an environment variable for a Render service.

Update Environment Variables for Build Source

Replace all build-source environment variables using only keys and server-generated values.

Update Environment Variables for Service

Tool to update environment variables for a Render service.

Update Header Rules

Tool to replace all header rules for a Render service.

Update Key Value Instance

Update a Render Key Value instance by ID.

Update Maintenance Run

Reschedule a Render maintenance run by its ID.

Update Owner Log Stream

Tool to update log stream configuration for an owner.

Update Owner Notification Settings

Tool to update notification settings for a specific owner (workspace).

Update Postgres Instance

Tool to update a Postgres instance configuration.

Update Project

Tool to update a project's name.

Update Registry Credential

Update an existing Render registry credential's name, registry type, username, and authentication token.

Update Resource Log Stream

Tool to update log stream override for a resource.

Update Route Priority

Move an existing Render redirect/rewrite rule to a new priority.

Update Routes

Tool to update redirect/rewrite rules for a service.

Update Secret Files for Service

Replace the directly configured secret files for a Render service with the supplied nonempty list.

Update Service

Tool to update a service configuration.

Update Webhook

Update an existing Render webhook's name, destination URL, enabled state, or event filter.

Update Workflow

Update an existing Render workflow service's name, build configuration, run command, or automatic deployment trigger.

Update Workspace Member

Change the role of an existing Render workspace member.

Create or Update Owner Metrics Stream

Create or update a workspace's metrics stream integration.

Validate Blueprint

Validate render.

Verify Custom Domain

Tool to verify DNS configuration for a custom domain.

FRAMEWORKS

How to build Render MCP Agent with another framework

Claude Code logo

Claude Code

Use Render MCP with Claude Code

Cursor logo

Cursor

Use Render MCP with Cursor

ChatGPT logo

ChatGPT

Use Render MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Render MCP with Claude Cowork

Antigravity logo

Antigravity

Use Render MCP with Antigravity

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Render MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Render MCP with Claude Agent SDK

Codex logo

Codex

Use Render MCP with Codex

Grok Build logo

Grok Build

Use Render MCP with Grok Build

VS Code logo

VS Code

Use Render MCP with VS Code

OpenCode logo

OpenCode

Use Render MCP with OpenCode

OpenClaw logo

OpenClaw

Use Render MCP with OpenClaw

Hermes logo

Hermes

Use Render MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Render MCP with Atomic Agent

Pi logo

Pi

Use Render MCP with Pi

DeepSeek Harness logo

DeepSeek Harness

Use Render MCP with DeepSeek Harness

Google ADK logo

Google ADK

Use Render MCP with Google ADK

LangChain logo

LangChain

Use Render MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Render MCP with Vercel AI SDK

LlamaIndex logo

LlamaIndex

Use Render MCP with LlamaIndex

CrewAI logo

CrewAI

Use Render MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Render MCP with Pydantic AI

AutoGen logo

AutoGen

Use Render MCP with AutoGen

FAQ

Frequently asked questions

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

Yes, you can. Mastra AI 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 Render tools.

Yes, absolutely. You can configure which Render 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 Render data and credentials are handled as safely as possible.

Start with Render.It takes 30 seconds.

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

Start building