Render Automation

Render Automation via Rube MCP

Automate Render cloud platform operations through Composio's Render toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/render

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Render connection via RUBE_MANAGE_CONNECTIONS with toolkit render
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
2. Call RUBE_MANAGE_CONNECTIONS with toolkit render
3. If connection is not ACTIVE, follow the returned auth link to complete Render authentication
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. List and Browse Services

When to use: User wants to find or inspect Render services (web services, static sites, workers, cron jobs)

Tool sequence:

1. RENDER_LIST_SERVICES - List all services with optional filters [Required]

Key parameters:

• name: Filter services by name substring
• type: Filter by service type ('web_service', 'static_site', 'private_service', 'background_worker', 'cron_job')
• limit: Maximum results per page (default 20, max 100)
• cursor: Pagination cursor from previous response

Pitfalls:

• Service types must match exact enum values: 'web_service', 'static_site', 'private_service', 'background_worker', 'cron_job'
• Pagination uses cursor-based approach; follow cursor until absent
• Name filter is substring-based, not exact match
• Service IDs follow the format 'srv-xxxxxxxxxxxx'
• Default limit is 20; set higher for comprehensive listing

2. Trigger Deployments

When to use: User wants to manually deploy or redeploy a service

Tool sequence:

1. RENDER_LIST_SERVICES - Find the service to deploy [Prerequisite]
2. RENDER_TRIGGER_DEPLOY - Trigger a new deployment [Required]
3. RENDER_RETRIEVE_DEPLOY - Monitor deployment progress [Optional]

Key parameters:

• For TRIGGER_DEPLOY:
  • serviceId: Service ID to deploy (required, format: 'srv-xxxxxxxxxxxx')
  • clearCache: Set true to clear build cache before deploying
• For RETRIEVE_DEPLOY:
  • serviceId: Service ID
  • deployId: Deploy ID from trigger response (format: 'dep-xxxxxxxxxxxx')

Pitfalls:

• serviceId is required; resolve via LIST_SERVICES first
• Service IDs start with 'srv-' prefix
• Deploy IDs start with 'dep-' prefix
• clearCache: true forces a clean build; takes longer but resolves cache-related issues
• Deployment is asynchronous; use RETRIEVE_DEPLOY to poll status
• Triggering a deploy while another is in progress may queue the new one

3. Monitor Deployment Status

When to use: User wants to check the progress or result of a deployment

Tool sequence:

1. RENDER_RETRIEVE_DEPLOY - Get deployment details and status [Required]

Key parameters:

• serviceId: Service ID (required)
• deployId: Deployment ID (required)
• Response includes status, createdAt, updatedAt, finishedAt, commit

Pitfalls:

• Both serviceId and deployId are required
• Deploy statuses include: 'created', 'build_in_progress', 'update_in_progress', 'live', 'deactivated', 'build_failed', 'update_failed', 'canceled'
• 'live' indicates successful deployment
• 'build_failed' or 'update_failed' indicate deployment errors
• Poll at reasonable intervals (10-30 seconds) to avoid rate limits