ranbot-ai/skills/vercel-automation

Vercel Automation via Rube MCP

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

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Vercel connection via RUBE_MANAGE_CONNECTIONS with toolkit vercel
• 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 vercel
3. If connection is not ACTIVE, follow the returned auth link to complete Vercel OAuth
4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Monitor and Inspect Deployments

When to use: User wants to list, inspect, or debug deployments

Tool sequence:

1. VERCEL_LIST_ALL_DEPLOYMENTS or VERCEL_GET_DEPLOYMENTS - List deployments with filters [Required]
2. VERCEL_GET_DEPLOYMENT or VERCEL_GET_DEPLOYMENT_DETAILS - Get specific deployment info [Optional]
3. VERCEL_GET_DEPLOYMENT_LOGS or VERCEL_GET_RUNTIME_LOGS - View build/runtime logs [Optional]
4. VERCEL_GET_DEPLOYMENT_EVENTS - Get deployment event timeline [Optional]
5. VERCEL_LIST_DEPLOYMENT_CHECKS - View deployment check results [Optional]

Key parameters:

• projectId: Filter deployments by project
• state: Filter by deployment state (e.g., 'READY', 'ERROR', 'BUILDING')
• limit: Number of deployments to return
• target: Filter by environment ('production', 'preview')
• deploymentId or idOrUrl: Specific deployment identifier

Pitfalls:

• Deployment IDs and URLs are both accepted as identifiers in most endpoints
• Build logs and runtime logs are separate; use the appropriate tool
• VERCEL_GET_DEPLOYMENT_LOGS returns build logs; VERCEL_GET_RUNTIME_LOGS returns serverless function logs
• Deployment events include status transitions and are useful for debugging timing issues

2. Create and Manage Deployments

When to use: User wants to trigger a new deployment

Tool sequence:

1. VERCEL_LIST_PROJECTS - Find the target project [Prerequisite]
2. VERCEL_CREATE_NEW_DEPLOYMENT - Trigger a new deployment [Required]
3. VERCEL_GET_DEPLOYMENT - Monitor deployment progress [Optional]

Key parameters:

• name: Project name for the deployment
• target: Deployment target ('production' or 'preview')
• gitSource: Git repository source with ref/branch info
• files: Array of file objects for file-based deployments

Pitfalls:

• Either gitSource or files must be provided, not both
• Git-based deployments require proper repository integration
• Production deployments update the production domain alias automatically
• Deployment creation is asynchronous; poll with GET_DEPLOYMENT for status

3. Manage Environment Variables

When to use: User wants to add, list, or remove environment variables for a project

Tool sequence:

1. VERCEL_LIST_PROJECTS - Find the project ID [Prerequisite]
2. VERCEL_LIST_ENV_VARIABLES - List existing env vars [Required]
3. VERCEL_ADD_ENVIRONMENT_VARIABLE - Add a new env var [Optional]
4. VERCEL_DELETE_ENVIRONMENT_VARIABLE - Remove an env var [Optional]

Key parameters:

• projectId: Target project identifier
• key: Environment variable name
• value: Environment variable value
• target: Array of environments ('production', 'preview', 'development')
• type: Variable type ('plain', 'secret', 'encrypted', 'sensitive')

Pitfalls:

• Environment variable names must be unique per target environment
• type: 'secret' variables cannot be read back after creation; only the ID is returned
• Deleting an env var requires both projectId and the env var id (not the key name)
• Changes require a new deployment to take effect

4. Manage Domains and DNS

When to use: User wants to configure custom domains or manage DNS records

Tool sequence:

1. VERCEL_GET_DOMAIN - Check domain status and configuration [Required]
2. VERCEL_GET_DOMAIN_CONFIG - Get DNS/SSL configuration details [Optional]
3. VERCEL_LIST_PROJECT_DOMAINS - List domains attached to a project [Optional]
4. VERCEL_GET_DNS_RECORDS - List DNS records for a domain [Optional]
5. VERCEL_CREATE_DNS_RECORD - Add a new DNS record [Optional]
6. VERCEL_UPDATE_DNS_RECORD - Modify an existing DNS record [Optional]

Key parameters:

• domain: Domain name (e.g., 'example.com')
• name: DNS record name/subdomain
• type: DNS record type ('A', 'AAAA', 'CNAME', 'MX', 'TXT', 'SRV')
• value: DNS record value
• ttl: Time-to-live in seconds

Pitfalls:

• Domain must be added to the Vercel account before DNS management
• SSL certificates are auto-provisioned but may take time for new domains
• CNAME records at the apex domain are not supported; use A records instead
• MX records require priority values

5.