Integration

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.

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Gitpod.Built from the 208 Gitpod tools below, on the connection you add once.

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 Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Gitpod

  1. Create your workspace

    Sign up free. Nothing to install.

  2. 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.

  3. 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.

Popular integrations

Browse the whole catalog