KosmoKrator

data

Render MCP, CLI, and Lua Integration for AI Agents

Render integration docs for AI agents: MCP gateway setup, Render CLI commands, Lua API reference, credentials, and function schemas.

Render for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Machine-Readable Metadata

Function Catalog

FunctionTypeParametersDescription
render.render_list_blueprints Read read 0 List Blueprints for the specified workspaces. If no workspaces are provided, returns all Blueprints the API key has access to.
render.render_validate_blueprint Write write 0 Validate a `render.yaml` Blueprint file without creating or modifying any resources. This endpoint checks the syntax and structure of the Blueprint, validates that all required fields are present, and returns a plan indicating the resources that would be created. Requests to this endpoint use `Content-Type: multipart/form-data`. The provided Blueprint file cannot exceed 10MB in size.
render.render_update_workspace_member Write write 0 Update the role of an existing workspace member.
render.render_remove_workspace_member Write write 0 Remove a user from the specified workspace.
render.render_retrieve_blueprint Read read 0 Retrieve the Blueprint with the provided ID.
render.render_update_blueprint Write write 0 Update the Blueprint with the provided ID.
render.render_disconnect_blueprint Write write 0 Disconnect the Blueprint with the provided ID. Disconnecting a Blueprint stops automatic resource syncing via the associated `render.yaml` file. It does not _delete_ any services or other resources that were managed by the blueprint.
render.render_list_blueprint_syncs Read read 0 List syncs for the Blueprint with the provided ID.
render.render_list_disks Read read 0 List persistent disks matching the provided filters. If no filters are provided, returns all disks you have permissions to view.
render.render_add_disk Write write 0 Attach a persistent disk to a web service, private service, or background worker. The service must be redeployed for the disk to be attached.
render.render_retrieve_disk Read read 0 Retrieve the persistent disk with the provided ID.
render.render_update_disk Write write 0 Update the persistent disk with the provided ID. The disk's associated service must be deployed and active for updates to take effect. When resizing a disk, the new size must be greater than the current size.
render.render_delete_disk Write write 0 Delete a persistent disk attached to a service. **All data on the disk will be lost.** The disk's associated service will immediately lose access to it.
render.render_list_snapshots Read read 0 List snapshots for the persistent disk with the provided ID. Each snapshot is a point-in-time copy of the disk's data.
render.render_restore_snapshot Write write 0 Restore a persistent disk to an available snapshot. **This operation is irreversible.** It will overwrite the current disk data. It might also trigger a service deploy. Snapshot keys returned from the [List snapshots](https://api-docs.render.com/reference/list-snapshots) endpoint expire after 24 hours. If a snapshot key has expired, query the endpoint again for a new key.
render.render_get_current_user Read read 0 Retrieve the user associated with the provided API key.
render.render_list_owners Read read 0 List the workspaces that your API key has access to, optionally filtered by name or owner email address.
render.render_retrieve_owner Read read 0 Retrieve the workspace with the provided ID. Workspace IDs start with `tea-`. If you provide a user ID (starts with `own-`), this endpoint returns the user's default workspace.
render.render_retrieve_owner_members Read read 0 Retrieves the list of users belonging to the workspace with the provided ID.
render.render_list_owner_audit_logs Read read 0 Retrieve audit logs for a specific workspace with optional filtering and pagination.
render.render_list_organization_audit_logs Read read 0 Retrieve audit logs for a specific organization with optional filtering and pagination.
render.render_retrieve_owner_notification_settings Read read 0 Retrieve notification settings for the owner with the provided ID. Note that you provide an owner ID to this endpoint, not the ID for a particular resource.
render.render_patch_owner_notification_settings Write write 0 Update notification settings for the owner with the provided ID.
render.render_list_notification_overrides Read read 0 List notification overrides matching the provided filters. If no filters are provided, returns all notification overrides for all workspaces the user belongs to.
render.render_retrieve_service_notification_overrides Read read 0 Retrieve the notification override for the service with the provided ID. Note that you provide a service ID to this endpoint, not the ID for a particular override.
render.render_patch_service_notification_overrides Write write 0 Update the notification override for the service with the provided ID.
render.render_list_registry_credentials Read read 0 List registry credentials matching the provided filters. If no filters are provided, returns all registry credentials you have permissions to view.
render.render_create_registry_credential Write write 0 Create a new registry credential.
render.render_retrieve_registry_credential Read read 0 Retrieve the registry credential with the provided ID.
render.render_update_registry_credential Write write 0 Update the registry credential with the provided ID. Services that use this credential must be redeployed to use updated values.
render.render_delete_registry_credential Write write 0 Delete the registry credential with the provided ID.
render.render_list_services Read read 0 List services matching the provided filters. If no filters are provided, returns all services you have permissions to view.
render.render_create_service Write write 0 Creates a new Render service in the specified workspace with the specified configuration.
render.render_get_service Read read 0 Retrieve the service with the provided ID.
render.render_update_service Write write 0 Update the service with the provided ID.
render.render_delete_service Write write 0 Delete the service with the provided ID.
render.render_purge_cache Write write 0 Trigger cache purge for the web service if caching is enabled.
render.render_list_deploys Read read 0 List deploys matching the provided filters. If no filters are provided, all deploys for the service are returned.
render.render_create_deploy Write write 0 Trigger a deploy for the service with the provided ID.
render.render_get_deploy Read read 0 Retrieve the details of a particular deploy for a particular service.
render.render_cancel_deploy Write write 0 Cancel an in-progress deploy for a service. Not supported for cron jobs.
render.render_rollback_deploy Write write 0 Trigger a rollback to a previous deploy of the specified service. Triggering a rollback with this endpoint does not disable autodeploys for the service. This means an autodeploy might restore changes you had intentionally rolled back. You can toggle autodeploys for your service with the [Update service](https://api-docs.render.com/reference/update-service) endpoint or in the Render Dashboard.
render.render_get_env_vars_for_service Read read 0 List all environment variables for the service with the provided ID.
render.render_update_env_vars_for_service Write write 0 Replace all environment variables for a service with the provided list of environment variables.
render.render_retrieve_env_var Read read 0 Retrieve a particular environment variable for a particular service. This only applies to environment variables set directly on the service, not to environment variables in a linked environment group.
render.render_update_env_var Write write 0 Add or update a particular environment variable for a particular service. This only applies to environment variables set directly on the service, not to environment variables in a linked environment group.
render.render_delete_env_var Write write 0 Delete a particular environment variable from a particular service. This only applies to environment variables set directly on the service, not to environment variables in a linked environment group.
render.render_list_secret_files_for_service Read read 0 List all secret files for the service with the provided ID.
render.render_update_secret_files_for_service Write write 0 Replace all secret files for a service with the provided list of secret files. **Any of the service's existing secret files not included in this request will be deleted.** This only applies to secret files set directly on the service, not to secret files in a linked environment group.
render.render_retrieve_secret_file Read read 0 Retrieve a particular secret file for a particular service. This only applies to secret files set directly on the service, not to secret files in a linked environment group.
render.render_add_or_update_secret_file Write write 0 Add or update a particular secret file for a particular service. This only applies to secret files set directly on the service, not to secret files in a linked environment group.
render.render_delete_secret_file Write write 0 Delete a particular secret file from a particular service. This only applies to secret files set directly on the service, not to secret files in a linked environment group.
render.render_list_events Read read 0 List recent events that occurred for the service with the provided ID.
render.render_list_headers Read read 0 List a particular service's response header rules that match the provided filters. If no filters are provided, all rules for the service are returned.
render.render_add_headers Write write 0 Add a response header rule to the service with the provided ID.
render.render_update_headers Write write 0 Replace all header rules for a particular service with the provided list. **This deletes all existing header rules for the service that aren't included in the request.**
render.render_delete_header Write write 0 Delete a particular response header rule for a particular service.
render.render_list_routes Read read 0 List a particular service's redirect/rewrite rules that match the provided filters. If no filters are provided, all rules for the service are returned.
render.render_add_route Write write 0 Add redirect/rewrite rules to the service with the provided ID.
render.render_patch_route Write write 0 Update the priority for a particular redirect/rewrite rule. To apply redirect/rewrite rules to an incoming request, Render starts from the rule with priority `0` and applies the first encountered rule that matches the request's path (if any). Render increments the priority of other rules by `1` as necessary to make space for the updated rule.
render.render_put_routes Write write 0 Replace all redirect/rewrite rules for a particular service with the provided list. **This deletes all existing redirect/rewrite rules for the service that aren't included in the request.** Rule priority is assigned according to list order (the first rule in the list has the highest priority).
render.render_delete_route Write write 0 Delete a particular redirect/rewrite rule for a particular service.
render.render_list_custom_domains Read read 0 List a particular service's custom domains that match the provided filters. If no filters are provided, all custom domains for the service are returned.
render.render_create_custom_domain Write write 0 Add a custom domain to the service with the provided ID.
render.render_retrieve_custom_domain Read read 0 Retrieve a particular custom domain for a particular service.
render.render_delete_custom_domain Write write 0 Delete a custom domain for a service given the service id and custom domain id or name.
render.render_refresh_custom_domain Write write 0 Verify the DNS configuration for a custom domain.
render.render_suspend_service Write write 0 Suspend the service with the provided ID.
render.render_resume_service Write write 0 Resume the service with the provided ID (if it's currently suspended).
render.render_restart_service Write write 0 Restart the service with the provided ID. Not supported for cron jobs.
render.render_scale_service Write write 0 [Scale](https://render.com/docs/scaling#manual-scaling) the service with the provided ID to a fixed number of instances. Render ignores this value as long as autoscaling is enabled for the service.
render.render_autoscale_service Write write 0 Update the [autoscaling](https://render.com/docs/scaling#autoscaling) config for the service with the provided ID.
render.render_delete_autoscaling_config Write write 0 Delete the autoscaling config for a service given the service id.
render.render_preview_service Write write 0 Create a preview instance for an image-backed service. The preview uses the settings of the base service (referenced by `serviceId`), except settings overridden via provided parameters. View all active previews from your service's Previews tab in the Render Dashboard. Note that you can't create previews for Git-backed services using the Render API.
render.render_list_jobs Read read 0 List jobs for the provided service that match the provided filters. If no filters are provided, all jobs for the service are returned.
render.render_post_job Write write 0 Create a one-off job using the provided service. For details, see [One-Off Jobs](https://render.com/docs/one-off-jobs).
render.render_retrieve_job Read read 0 Retrieve the details of a particular one-off job for a particular service.
render.render_cancel_job Write write 0 Cancel a particular one-off job for a particular service.
render.render_list_instances Read read 0 List instances for the provided service.
render.render_run_cron_job Write write 0 Trigger a run for a cron job and cancel any active runs.
render.render_cancel_cron_job_run Write write 0 Cancel a currently running cron job.
render.render_retrieve_event Read read 0 Retrieve the details of a particular event
render.render_list_logs Read read 0 List logs matching the provided filters. Logs are paginated by start and end timestamps. There are more logs to fetch if `hasMore` is true in the response. Provide the `nextStartTime` and `nextEndTime` timestamps as the `startTime` and `endTime` query parameters to fetch the next page of logs. You can query for logs across multiple resources, but all resources must be in the same region and bel...
render.render_subscribe_logs Read read 0 Open a websocket connection to subscribe to logs matching the provided filters. Logs are streamed in real-time as they are generated. You can query for logs across multiple resources, but all resources must be in the same region and belong to the same owner.
render.render_list_logs_values Read read 0 List all values for a given log label in the logs matching the provided filters.
render.render_get_owner_log_stream Read read 0 Returns log stream information for the specified workspace.
render.render_update_owner_log_stream Write write 0 Updates log stream information for the specified workspace. All logs for resources owned by this workspace will be sent to this log stream unless overridden by individual resources.
render.render_delete_owner_log_stream Write write 0 Removes the log stream for the specified workspace.
render.render_list_resource_log_streams Read read 0 Lists log stream overrides for the provided workspace that match the provided filters. These overrides take precedence over the workspace's default log stream.
render.render_get_resource_log_stream Read read 0 Returns log stream override information for the specified resource. A log stream override takes precedence over a workspace's default log stream.
render.render_update_resource_log_stream Write write 0 Updates log stream override information for the specified resource. A log stream override takes precedence over a workspace's default log stream.
render.render_delete_resource_log_stream Write write 0 Removes the log stream override for the specified resource. After deletion, the resource will use the workspace's default log stream setting.
render.render_get_owner_metrics_stream Read read 0 Returns metrics stream information for the specified workspace.
render.render_upsert_owner_metrics_stream Write write 0 Creates or updates the metrics stream for the specified workspace.
render.render_delete_owner_metrics_stream Write write 0 Deletes the metrics stream for the specified workspace.
render.render_get_cpu Read read 0 Get CPU usage for one or more resources.
render.render_get_cpu_limit Read read 0 Get the CPU limit for one or more resources.
render.render_get_cpu_target Read read 0 Get CPU target for one or more resources.
render.render_get_memory Read read 0 Get memory usage for one or more resources.
render.render_get_memory_limit Read read 0 Get the memory limit for one or more resources.
render.render_get_memory_target Read read 0 Get memory target for one or more resources.
render.render_get_http_requests Read read 0 Get the HTTP request count for one or more resources.
render.render_get_http_latency Read read 0 Get HTTP latency metrics for one or more resources.
render.render_get_bandwidth Read read 0 Get bandwidth usage for one or more resources.
render.render_get_bandwidth_sources Read read 0 Get bandwidth usage for one or more resources broken down by traffic source (HTTP, WebSocket, NAT, PrivateLink). Returns hourly data points with traffic source breakdown. Traffic source data is available from March 9, 2025 onwards. Queries for earlier dates will return a 400 Bad Request error.
render.render_get_disk_usage Read read 0 Get persistent disk usage for one or more resources.
render.render_get_disk_capacity Read read 0 Get persistent disk capacity for one or more resources.
render.render_get_instance_count Read read 0 Get the instance count for one or more resources.
render.render_get_active_connections Read read 0 Get the number of active connections for one or more Postgres databases or Redis instances.
render.render_get_replication_lag Read read 0 Get seconds of replica lag of a Postgres replica.
render.render_list_application_filter_values Read read 0 List instance values to filter by for one or more resources.
render.render_list_http_filter_values Read read 0 List status codes and host values to filter by for one or more resources.
render.render_list_path_filter_values Read read 0 The path suggestions are based on the most recent 5000 log lines as filtered by the provided filters
render.render_get_task_runs_queued Read read 0 Get the total number of task runs queued for one or more tasks.
render.render_get_task_runs_completed Read read 0 Get the total number of task runs completed for one or more tasks. Optionally filter by state (succeeded/failed) or aggregate by state.
render.render_list_key_value Read read 0 List Key Value instances matching the provided filters. If no filters are provided, all Key Value instances are returned.
render.render_create_key_value Write write 0 Create a new Key Value instance.
render.render_retrieve_key_value Read read 0 Retrieve a Key Value instance by ID.
render.render_update_key_value Write write 0 Update a Key Value instance by ID.
render.render_delete_key_value Write write 0 Delete a Key Value instance by ID.
render.render_retrieve_key_value_connection_info Read read 0 Retrieve connection info for a Key Value instance by ID. Connection info includes sensitive information.
render.render_suspend_key_value Write write 0 Suspend a Key Value instance by ID.
render.render_resume_key_value Write write 0 Resume a Key Value instance by ID.
render.render_list_redis Read read 0 List Redis instances matching the provided filters. If no filters are provided, all Redis instances are returned. This API is deprecated in favor of the Key Value API.
render.render_create_redis Write write 0 Create a new Redis instance. This API is deprecated in favor of the Key Value API.
render.render_retrieve_redis Read read 0 Retrieve a Redis instance by ID. This API is deprecated in favor of the Key Value API.
render.render_update_redis Write write 0 Update a Redis instance by ID. This API is deprecated in favor of the Key Value API.
render.render_delete_redis Write write 0 Delete a Redis instance by ID. This API is deprecated in favor of the Key Value API.
render.render_retrieve_redis_connection_info Read read 0 Retrieve connection info for a Redis instance by ID. Connection info includes sensitive information. This API is deprecated in favor of the Key Value API.
render.render_list_postgres Read read 0 List Postgres instances matching the provided filters. If no filters are provided, all Postgres instances are returned.
render.render_create_postgres Write write 0 Create a new Postgres instance.
render.render_retrieve_postgres Read read 0 Retrieve a Postgres instance by ID.
render.render_update_postgres Write write 0 Update a Postgres instance by ID.
render.render_delete_postgres Write write 0 Delete a Postgres instance by ID. This operation is irreversible, and all data will be lost.
render.render_retrieve_postgres_connection_info Read read 0 Retrieve connection info for a Postgres instance by ID. Connection info includes sensitive information.
render.render_retrieve_postgres_recovery_info Read read 0 Retrieve information on the availability of Postgres point-in-time recovery for a Postgres instance by ID.
render.render_recover_postgres Write write 0 Trigger [point-in-time recovery](https://render.com/docs/postgresql-backups) on the Postgres instance with the provided ID.
render.render_suspend_postgres Write write 0 Suspend a Postgres instance by ID.
render.render_resume_postgres Write write 0 Resume a Postgres instance by ID.
render.render_restart_postgres Write write 0 Restart a Postgres instance by ID.
render.render_failover_postgres Write write 0 Failover a [highly available Postgres](https://render.com/docs/postgresql-high-availability) instance.
render.render_list_postgres_export Read read 0 List [exports](https://render.com/docs/postgresql-backups#logical-backups) for a Postgres instance by ID. Returns a URL to download the export.
render.render_create_postgres_export Write write 0 Create an [export](https://render.com/docs/postgresql-backups#logical-backups) of a Postgres instance by ID.
render.render_list_postgres_users Read read 0 List PostgreSQL users for the Render Postgres instance with the provided ID.
render.render_create_postgres_user Write write 0 Create a new PostgreSQL user for the Render Postgres instance with the provided ID. This becomes the database's new "default" user.
render.render_delete_postgres_user Write write 0 Delete a PostgreSQL user from the Render Postgres instance with the provided ID.
render.render_list_projects Read read 0 List projects matching the provided filters. If no filters are provided, all projects are returned.
render.render_create_project Write write 0 Create a new project.
render.render_retrieve_project Read read 0 Retrieve the project with the provided ID.
render.render_update_project Write write 0 Update the details of a project. To update the details of a particular _environment_ in the project, instead use the [Update environment](https://api-docs.render.com/reference/update-environment) endpoint.
render.render_delete_project Write write 0 Delete the project with the provided ID. Requires _all_ of the project's environments to be empty (i.e., they must contain no services or other resources). Otherwise, deletion fails with a `409` response. To delete a non-empty project, do one of the following: - First move or delete all contained services and other resources. - Delete the project in the [Render Dashboard](https://dashboard.rend...
render.render_create_environment Write write 0 Create a new environment belonging to the project with the provided ID.
render.render_list_environments Read read 0 List a particular project's environments matching the provided filters. If no filters are provided, all environments are returned.
render.render_retrieve_environment Read read 0 Retrieve the environment with the provided ID.
render.render_update_environment Write write 0 Update the details of the environment with the provided ID.
render.render_delete_environment Write write 0 Delete the environment with the provided ID. Requires the environment to be empty (i.e., it must contain no services or other resources). Otherwise, deletion fails with a `409` response. To delete a non-empty environment, do one of the following: - First move or delete all contained services and other resources. - Delete the environment in the [Render Dashboard](https://dashboard.render.com).
render.render_add_resources_to_environment Write write 0 Add resources to the environment with the provided ID.
render.render_remove_resources_from_environment Write write 0 Remove resources from the environment with the provided ID.
render.render_list_env_groups Read read 0 List environment groups matching the provided filters. If no filters are provided, all environment groups are returned.
render.render_create_env_group Write write 0 Create a new environment group.
render.render_retrieve_env_group Read read 0 Retrieve an environment group by ID.
render.render_update_env_group Write write 0 Update the attributes of an environment group.
render.render_delete_env_group Write write 0 Delete the environment group with the provided ID, including all environment variables and secret files it contains.
render.render_link_service_to_env_group Write write 0 Link a particular service to a particular environment group. The linked service will have access to the environment variables and secret files in the group.
render.render_unlink_service_from_env_group Write write 0 Unlink a particular service from a particular environment group. The service will lose access to the environment variables and secret files in the group.
render.render_retrieve_env_group_env_var Read read 0 Retrieve a particular environment variable in a particular environment group.
render.render_update_env_group_env_var Write write 0 Add or update a particular environment variable in a particular environment group.
render.render_delete_env_group_env_var Write write 0 Remove a particular environment variable from a particular environment group.
render.render_retrieve_env_group_secret_file Read read 0 Retrieve a particular secret file in a particular environment group.
render.render_update_env_group_secret_file Write write 0 Add or update a particular secret file in an particular environment group.
render.render_delete_env_group_secret_file Write write 0 Remove a particular secret file from a particular environment group.
render.render_list_maintenance Read read 0 List scheduled and/or recent maintenance runs for specified resources.
render.render_retrieve_maintenance Read read 0 Retrieve the maintenance run with the provided ID.
render.render_update_maintenance Write write 0 Update the maintenance run with the provided ID. Updates from this endpoint are asynchronous. To check your update's status, use the [Retrieve maintenance run](https://api-docs.render.com/reference/retrieve-maintenance) endpoint.
render.render_trigger_maintenance Write write 0 Trigger the scheduled maintenance run with the provided ID. Triggering maintenance is asynchronous. To check whether maintenance has started, use the [Retrieve maintenance run](https://api-docs.render.com/reference/retrieve-maintenance) endpoint. As maintenance progresses, the run's `state` will change from `scheduled` to other values, such as `in_progress` and `succeeded`.
render.render_create_webhook Write write 0 Create a new webhook.
render.render_list_webhooks Read read 0 List webhooks
render.render_retrieve_webhook Read read 0 Retrieve the webhook with the provided ID
render.render_update_webhook Write write 0 Update the webhook with the provided ID.
render.render_delete_webhook Write write 0 Delete the webhook with the provided ID.
render.render_list_webhook_events Read read 0 Retrieve a list of events that have been sent to this webhook, with optional filtering by timestamp.
render.render_list_workflows Read read 0 List workflows that match the provided filters. If no filters are provided, all workflows accessible by the authenticated user are returned.
render.render_create_workflow Write write 0 Create a new workflow service with the specified configuration.
render.render_get_workflow Read read 0 Retrieve the workflow service with the provided ID.
render.render_update_workflow Write write 0 Update the workflow service with the provided ID.
render.render_delete_workflow Write write 0 Delete the workflow service with the provided ID.
render.render_list_workflow_versions Read read 0 List known versions of the workflow service with the provided ID.
render.render_create_workflow_version Write write 0 Creates and deploys a new version of a workflow.
render.render_get_workflow_version Read read 0 Retrieve the specific workflow service version with the provided ID.
render.render_list_tasks Read read 0 List workflow tasks that match the provided filters. If no filters are provided, all task definitions accessible by the authenticated user are returned.
render.render_get_task Read read 0 Retrieve the workflow task with the provided ID.
render.render_list_task_runs Read read 0 List task runs that match the provided filters. If no filters are provided, all task runs accessible by the authenticated user are returned.
render.render_create_task Write write 0 Kicks off a run of the workflow task with the provided ID, passing the provided input data.
render.render_stream_task_runs_events Read read 0 Establishes a unidirectional event stream. The server sends events as lines formatted per the SSE spec. Clients SHOULD set `Accept: text/event-stream` and keep the connection open.
render.render_get_task_run Read read 0 Retrieve the workflow task run with the provided ID.
render.render_cancel_task_run Write write 0 Cancel a running task run with the provided ID.