Gitpod integration
Gitpod runs standardised, ephemeral development environments on runners you host or on Gitpod's own infrastructure. Create, start, stop, archive and delete environments and the projects they are created from, drive the automation services and tasks declared in an environment's automations file and read their executions, start and follow AI agent runs and the prompts they use, run and cancel workflows and read their executions, outputs and actions, manage prebuilds and warm pools, register and configure runners with their environment classes, source-control integrations and host authentication tokens, administer the organisation (members, roles, groups, invites, custom domains, domain verification, policies, SSO and SCIM), store environment secrets, read audit logs, and pull credit, adoption and AI usage reporting. Every call is a POST to the RPC endpoint named in its path and takes its arguments as a JSON body. Authentication is a Gitpod personal access token or service account token sent as a bearer token in the Authorization header.
Say what should happen.
The workflow builds itself.
What you can do with Gitpod
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Create project, 2 operations
create_projectCreate projectPOSTCreates a new project with specified configuration.create_projectsCreate projectsPOSTCreates multiple projects in a single request.
Delete project, 2 operations
delete_projectDelete projectPOSTDeletes a project permanently.delete_projectsDelete projectsPOSTDeletes multiple projects in a single request.
Cancel prebuild, 1 operation
cancel_prebuildCancel prebuildPOSTCancels a running prebuild.
Cancel workflow execution, 1 operation
cancel_workflow_executionCancel workflow executionPOSTCancels a running workflow execution.
Cancel workflow execution action, 1 operation
cancel_workflow_execution_actionCancel workflow execution actionPOSTCancels a running workflow execution action.
Check authentication for host, 1 operation
check_authentication_for_hostCheck authentication for hostPOSTChecks if a user is authenticated for a specific host.
Check repository acces, 1 operation
check_repository_accessCheck repository accessPOSTChecks if a principal has read access to a repository.
Create agent execution conversation token, 1 operation
create_agent_execution_conversation_tokenCreate agent execution conversation tokenPOSTCreates a token for conversation access with a specific agent run.
Create custom domain, 1 operation
create_custom_domainCreate custom domainPOSTCreates a custom domain configuration for an organization.
Create domain verification, 1 operation
create_domain_verificationCreate domain verificationPOSTInitiates domain verification process to enable organization features.
Create environment, 1 operation
create_environmentCreate environmentPOSTCreates a development environment from a context URL (e.g. Git repository) and starts it.
Create environment access token, 1 operation
create_environment_access_tokenCreate environment access tokenPOSTCreates an access token for the environment.
Create environment clas, 1 operation
create_runner_environment_classCreate runner environment classPOSTCreates a new environment class for a runner.
Create environment from project, 1 operation
create_environment_from_projectCreate environment from projectPOSTCreates an environment from an existing project configuration and starts it.
Create environment logs token, 1 operation
create_environment_logs_tokenCreate environment logs tokenPOSTCreates an access token for retrieving environment logs.
Create group, 1 operation
create_groupCreate groupPOSTCreates a new group within an organization.
Create host authentication token, 1 operation
create_host_authentication_tokenCreate host authentication tokenPOSTCreates a new authentication token for accessing remote hosts.
Create membership, 1 operation
create_membershipCreate membershipPOSTCreates a membership for a user in a group.
Create organization, 1 operation
create_organizationCreate organizationPOSTCreates a new organization with the specified name and settings.
Create organization invite, 1 operation
create_organization_inviteCreate organization invitePOSTCreates an invite link for joining an organization. Any existing OrganizationInvites are invalidated and can no longer be used.
Create prebuild, 1 operation
create_prebuildCreate prebuildPOSTCreates a prebuild for a project.
Create prebuild logs token, 1 operation
create_prebuild_logs_tokenCreate prebuild logs tokenPOSTCreates a logs access token for a prebuild.
Create project from environment, 1 operation
create_project_from_environmentCreate project from environmentPOSTCreates a new project using an existing environment as a template.
Create project policy, 1 operation
create_project_policyCreate project policyPOSTCreates a new policy for a project.
Create prompt, 1 operation
create_promptCreate promptPOSTCreates a new prompt.
Create role assignment, 1 operation
create_role_assignmentCreate role assignmentPOSTCreates a role assignment for a group on a resource.
Create runner, 1 operation
create_runnerCreate runnerPOSTCreates a new runner registration with the server. Registrations are very short-lived and must be renewed every 30 seconds.
Create runner logs token, 1 operation
create_runner_logs_tokenCreate runner logs tokenPOSTCreates an access token for runner logs and debug information.
Create runner policy, 1 operation
create_runner_policyCreate runner policyPOSTCreates a new policy for a runner.
Create runner token, 1 operation
create_runner_tokenCreate runner tokenPOSTCreates a new authentication token for a runner.
Create scimconfiguration, 1 operation
create_scim_configurationCreate scim configurationPOSTCreates a new SCIM configuration for automated user provisioning.
Create scmintegration, 1 operation
create_scm_integrationCreate scm integrationPOSTCreates a new SCM integration for a runner.
Create secret, 1 operation
create_secretCreate secretPOSTCreates a new secret for a project.
Create security policy, 1 operation
create_security_policyCreate security policyPOSTCreates a new security policy.
Create service, 1 operation
create_automation_serviceCreate automation servicePOSTCreates a new automation service for an environment.
Create ssoconfiguration, 1 operation
create_sso_configurationCreate sso configurationPOSTCreates or updates SSO configuration for organizational authentication.
Create task, 1 operation
create_automation_taskCreate automation taskPOSTCreates a new automation task.
Create warm pool, 1 operation
create_warm_poolCreate warm poolPOSTCreates a warm pool for a project and environment class.
Create workflow, 1 operation
create_workflowCreate workflowPOSTCreates a new workflow with specified configuration.
Delete account, 1 operation
delete_accountDelete accountPOSTDeletes an account permanently.
Delete agent execution, 1 operation
delete_agent_executionDelete agent executionPOSTDeletes an agent run.
Delete custom domain, 1 operation
delete_custom_domainDelete custom domainPOSTRemoves a custom domain configuration from an organization.
Delete domain verification, 1 operation
delete_domain_verificationDelete domain verificationPOSTRemoves a domain verification request.
Delete environment, 1 operation
delete_environmentDelete environmentPOSTPermanently deletes an environment.
Delete group, 1 operation
delete_groupDelete groupPOSTDeletes a group and removes all its resource assignments.
Delete host authentication token, 1 operation
delete_host_authentication_tokenDelete host authentication tokenPOSTDeletes a host authentication token.
Delete membership, 1 operation
delete_membershipDelete membershipPOSTDeletes a membership for a user in a group.
Delete organization, 1 operation
delete_organizationDelete organizationPOSTPermanently deletes an organization.
Delete personal access token, 1 operation
delete_personal_access_tokenDelete personal access tokenPOSTDeletes a personal access token.
Delete prebuild, 1 operation
delete_prebuildDelete prebuildPOSTDeletes a prebuild.
Delete project policy, 1 operation
delete_project_policyDelete project policyPOSTDeletes a project policy.
Delete prompt, 1 operation
delete_promptDelete promptPOSTDeletes a prompt.
Delete role assignment, 1 operation
delete_role_assignmentDelete role assignmentPOSTDeletes a role assignment.
Delete runner, 1 operation
delete_runnerDelete runnerPOSTDeletes a runner permanently.
Delete runner policy, 1 operation
delete_runner_policyDelete runner policyPOSTDeletes a runner policy.
Delete scimconfiguration, 1 operation
delete_scim_configurationDelete scim configurationPOSTRemoves a SCIM configuration from an organization.
Delete scmintegration, 1 operation
delete_scm_integrationDelete scm integrationPOSTDeletes an SCM integration.
Delete secret, 1 operation
delete_secretDelete secretPOSTDeletes a secret permanently.
Delete security policy, 1 operation
delete_security_policyDelete security policyPOSTDeletes a security policy.
Delete service, 1 operation
delete_automation_serviceDelete automation servicePOSTDeletes an automation service. This call does not block until the service is deleted. If the service is not stopped it will be stopped before deletion.
Delete ssoconfiguration, 1 operation
delete_sso_configurationDelete sso configurationPOSTRemoves an SSO configuration from an organization.
Delete task, 1 operation
delete_automation_taskDelete automation taskPOSTDeletes an automation task.
Delete user, 1 operation
delete_userDelete userPOSTDeletes a user. If the User comes from an organization's SSO provider, the Account will also be deleted.
Delete warm pool, 1 operation
delete_warm_poolDelete warm poolPOSTDeletes a warm pool.
Delete workflow, 1 operation
delete_workflowDelete workflowPOSTDeletes a workflow permanently.
Get account, 1 operation
get_accountGet accountPOSTGets information about the currently authenticated account.
Get adoption usage summary, 1 operation
get_adoption_usage_summaryGet adoption usage summaryPOSTGets a summary of adoption and usage metrics.
Get agent execution, 1 operation
get_agent_executionGet agent executionPOSTGets details about a specific agent run, including its metadata, specification, and status (phase, error messages, and usage statistics).
Get agent trace summary, 1 operation
get_agent_trace_summaryGet agent trace summaryPOSTGets aggregated agent trace summary for the organization or a specific project.
Get agent trace time serie, 1 operation
get_agent_trace_time_seriesGet agent trace time seriesPOSTGets agent trace data as a time series.
Get announcement banner, 1 operation
get_announcement_bannerGet announcement bannerPOSTRetrieves the announcement banner configuration for an organization.
Get audit log, 1 operation
get_audit_logGet audit logPOSTGets one audit-log entry, including any typed details stored for it.
Get authenticated identity, 1 operation
get_authenticated_identityGet authenticated identityPOSTRetrieves information about the currently authenticated identity.
Get authenticated user, 1 operation
get_authenticated_userGet authenticated userPOSTGets information about the currently authenticated user.
Get co author summary, 1 operation
get_co_author_summaryGet co author summaryPOSTGets aggregated co-author summary for the organization or a specific project.
Get co author time serie, 1 operation
get_co_author_time_seriesGet co author time seriesPOSTGets co-author contribution data as a time series.
Get credit usage export, 1 operation
get_credit_usage_exportGet credit usage exportPOSTReturns a signed download URL for a CSV export of credit usage.
Get credit usage report, 1 operation
get_credit_usage_reportGet credit usage reportPOSTReturns a daily credit usage report for an enterprise organization.
Get cumulative credit usage, 1 operation
get_cumulative_credit_usageGet cumulative credit usagePOSTReturns cumulative credit usage for an organization and its teams.
Get custom domain, 1 operation
get_custom_domainGet custom domainPOSTRetrieves a specific custom domain configuration.
Get domain verification, 1 operation
get_domain_verificationGet domain verificationPOSTRetrieves the status of a domain verification request.
Get dotfiles configuration, 1 operation
get_dotfiles_configurationGet dotfiles configurationPOSTGets the dotfiles for a user.
Get editor, 1 operation
get_editorGet editorPOSTGets details about a specific editor.
Get enterprise aiusage summary, 1 operation
get_enterprise_ai_usage_summaryGet enterprise ai usage summaryPOSTReturns organization-level enterprise AI usage totals for reporting.
Get enterprise aiusage time serie, 1 operation
get_enterprise_ai_usage_time_seriesGet enterprise ai usage time seriesPOSTReturns daily enterprise AI usage totals for the organization.
Get environment, 1 operation
get_environmentGet environmentPOSTGets details about a specific environment including its status, configuration, and context URL.
Get environment clas, 1 operation
get_runner_environment_classGet runner environment classPOSTGets details about a specific environment class.
Get group, 1 operation
get_groupGet groupPOSTGets information about a specific group by ID or name.
Get host authentication token, 1 operation
get_host_authentication_tokenGet host authentication tokenPOSTGets details about a specific host authentication token.
Get membership, 1 operation
get_membershipGet membershipPOSTGets a specific membership by group ID and subject.
Get organization, 1 operation
get_organizationGet organizationPOSTGets details about a specific organization.
Get organization invite, 1 operation
get_organization_inviteGet organization invitePOSTReads the standing invite of an organisation, the link an outsider follows to request membership.
Get organization invite summary, 1 operation
get_organization_invite_summaryGet organization invite summaryPOSTRetrieves organization details and membership info based on an invite link.
Get organization policie, 1 operation
get_organization_policiesGet organization policiesPOSTGets organization policy settings by organization ID.
Get personal access token, 1 operation
get_personal_access_tokenGet personal access tokenPOSTGets details about a specific personal access token.
Get pr summary, 1 operation
get_pr_summaryGet pr summaryPOSTGets aggregated PR speed summary for the organization or a specific project.
Get pr time serie, 1 operation
get_pr_time_seriesGet pr time seriesPOSTGets PR speed metrics as a time series.
Get prebuild, 1 operation
get_prebuildGet prebuildPOSTGets details about a specific prebuild.
Get project, 1 operation
get_projectGet projectPOSTGets details about a specific project.
Get prompt, 1 operation
get_promptGet promptPOSTGets details about a specific prompt including name, description, and prompt content.
Get runner, 1 operation
get_runnerGet runnerPOSTGets details about a specific runner.
Get runner configuration schema, 1 operation
get_runner_configuration_schemaGet runner configuration schemaPOSTGets the latest runner configuration schema.
Get scimconfiguration, 1 operation
get_scim_configurationGet scim configurationPOSTRetrieves a specific SCIM configuration.
Get scmintegration, 1 operation
get_scm_integrationGet scm integrationPOSTGets details about a specific SCM integration.
Get security policy, 1 operation
get_security_policyGet security policyPOSTGets details about a specific security policy.
Get service, 1 operation
get_automation_serviceGet automation servicePOSTGets details about a specific automation service.
Get ssoconfiguration, 1 operation
get_sso_configurationGet sso configurationPOSTRetrieves a specific SSO configuration.
Get task, 1 operation
get_automation_taskGet automation taskPOSTGets details about a specific automation task.
Get task execution, 1 operation
get_automation_task_executionGet automation task executionPOSTGets details about a specific task execution.
Get user, 1 operation
get_userGet userPOSTGets basic information about a specific user by their ID.
Get warm pool, 1 operation
get_warm_poolGet warm poolPOSTGets details about a specific warm pool.
Get workflow, 1 operation
get_workflowGet workflowPOSTGets details about a specific workflow.
Get workflow execution, 1 operation
get_workflow_executionGet workflow executionPOSTGets details about a specific workflow execution.
Get workflow execution action, 1 operation
get_workflow_execution_actionGet workflow execution actionPOSTGets details about a specific workflow execution action.
Join organization, 1 operation
join_organizationJoin organizationPOSTAllows users to join an organization through direct ID, invite link, or domain-based auto-join.
Leave organization, 1 operation
leave_organizationLeave organizationPOSTRemoves a user from an organization while preserving organization data.
List agent execution, 1 operation
list_agent_executionsList agent executionsPOSTLists all agent runs matching the specified filter.
List audit log, 1 operation
list_audit_logsList audit logsPOSTLists audit logs with filtering and pagination options.
Showing the first 120 of 208 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Gitpod from Claude Code, Cursor or Codex
Connect Gitpod in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Gitpod operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Gitpod
- Create your workspace
Sign up free. Nothing to install.
- Connect Gitpod once
Add your Gitpod connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Gitpod integration FAQ
What can you do with the Gitpod integration?
LiveContext exposes 208 operations on Gitpod, covering create project, delete project, cancel prebuild and cancel workflow execution.
