HubDocs

Guides / MCP setup and tools

MCP explorer

Every hosted tool, its arguments, permissions, examples and response schema.

View Markdown

Use the connection guide to authorize your agent. The endpoint is https://cloud.myhub.host/mcp. Local projects use the CLI.

This reference is generated from Hub's hosted tool registry. Examples show tool arguments to give your MCP client; this page does not run operations or request credentials. Organization roles apply in addition to OAuth scopes. New apps use organization access.

All tools return ok and either data or an error with code, message and an optional hint. Deployments return an accepted release; poll its exact number to verify it. Start, stop, restart, and suspend wait for completion by default. With wait: false, they return an operation ID to poll with hub_app_runtime until succeeded, failed, expired, or unknown. Policy changes through hub_app_runtime_set also return an operation ID. See deployment lifecycle, runtime operations and automation.

20 of 20 tools

hub_whoami

Read only · hub:read

Show the authenticated account, selected organization and control plane. Connect your account through browser OAuth when authorization is required.

No arguments. Send an empty object.

hub_whoami arguments
{}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_usage

Read only · hub:read

Read the selected organization’s plan, limits, allocation usage and AI Credits in USD. Runtime inventory is not billable compute metering.

No arguments. Send an empty object.

hub_usage arguments
{}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_runtime

Read only · hub:read

Inspect runtime without waking the app. Pass operation to poll a runtime change until succeeded, failed, expired or unknown. Use hub_app_runtime_set to change sleep policy.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
operation
Optional		stringpattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
hub_app_runtime arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "operation": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_runtime_set

Changes apps · hub:write

Choose exactly one setting: sleepAfter only if every service can pause between HTTP requests, or alwaysOn for background work. Changes affect the entire instance and return an operation ID. Poll hub_app_runtime with operation until succeeded, failed, expired or unknown. Start a sleeping instance before changing policy.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
sleepAfter
Optional		integerminimum: 5 · maximum: 86400
alwaysOn
Optional		booleanValue: true
hub_app_runtime_set arguments
{
  "target": "my-app",
  "alwaysOn": true
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "sleepAfter": {
      "type": "integer",
      "minimum": 5,
      "maximum": 86400
    },
    "alwaysOn": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_suspend

Changes apps · hub:write

Pause all services while retaining RAM and disk. Requests can wake it. Background work pauses too. Waits for completion by default. Set wait=false to return an operation ID; verify it with hub_app_runtime and operation. Linked dependencies may prevent suspension.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
wait
Optional		booleanWait for completion; default true.
hub_app_suspend arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "wait": {
      "description": "Wait for completion; default true.",
      "type": "boolean"
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_apps

Read only · hub:read

List apps and instances in the selected organization with URLs, access, and release status.

No arguments. Send an empty object.

hub_apps arguments
{}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_deploy

Changes apps · hub:write

Deploy the pushed branch of a GitHub repository. Returns a release immediately; poll hub_app_status with its number. Changed GitHub sources return deploy_conflict unless replacement is explicitly confirmed with force. Managed Workspace cannot be replaced. Public repositories clone anonymously. Set watch=true for push-to-deploy. Private repositories and push-to-deploy require a GitHub grant and return an install link when needed.

ParameterTypeDetails
force
Optional		booleanConfirm changing the GitHub source of an existing app. Only set after the user authorizes replacement of this target. Cannot replace managed Workspace.
name
Required		stringExplicit app name to create or update.minLength: 1
instance
Optional		stringInstance name; default prod.
public
Optional		booleanMake a NEW instance public only when requested. Existing access is preserved; use hub_app_access to change it.
branch
Optional		stringGitHub branch; defaults to repository default. Only with git.
path
Optional		stringRepository subfolder, only with git.
watch
Optional		booleanRedeploy GitHub source on push; omitted preserves the setting for the same repository, otherwise defaults false; watching requires a GitHub grant. Only with git.
git
Required		stringGitHub owner/repository or GitHub URL. Push changes before deploying.minLength: 1
hub_deploy arguments
{
  "name": "my-app",
  "git": "your-org/your-repo"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "force": {
      "description": "Confirm changing the GitHub source of an existing app. Only set after the user authorizes replacement of this target. Cannot replace managed Workspace.",
      "type": "boolean"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app name to create or update."
    },
    "instance": {
      "description": "Instance name; default prod.",
      "type": "string"
    },
    "public": {
      "description": "Make a NEW instance public only when requested. Existing access is preserved; use hub_app_access to change it.",
      "type": "boolean"
    },
    "branch": {
      "description": "GitHub branch; defaults to repository default. Only with git.",
      "type": "string"
    },
    "path": {
      "description": "Repository subfolder, only with git.",
      "type": "string"
    },
    "watch": {
      "description": "Redeploy GitHub source on push; omitted preserves the setting for the same repository, otherwise defaults false; watching requires a GitHub grant. Only with git.",
      "type": "boolean"
    },
    "git": {
      "type": "string",
      "minLength": 1,
      "description": "GitHub owner/repository or GitHub URL. Push changes before deploying."
    }
  },
  "required": [
    "name",
    "git"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_status

Read only · hub:read

Read runtime status and URL, or check an exact release number from deploy. A queued/building/starting release is still in progress. A failed or superseded release is terminal; do not report it as a successful deployment.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
release
Optional		integerExact release number returned by deploy.maximum: 999999999
hub_app_status arguments
{
  "target": "my-app",
  "release": 3
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "release": {
      "description": "Exact release number returned by deploy.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 999999999
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_logs

Read only · hub:read

Return a finite log snapshot, build-first while a release is in progress. Use build and release to investigate a failed release. Output is bounded to the requested trailing lines and 64,000 characters; truncated marks clipped output.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
tail
Optional		integerTrailing lines; default 200, maximum 1000.minimum: 1 · maximum: 1000
service
Optional		stringCompose service; default the public service.
build
Optional		booleanRead the build log instead of runtime output.
release
Optional		integerExact release number returned by deploy.maximum: 999999999
hub_app_logs arguments
{
  "target": "my-app",
  "build": true,
  "release": 3,
  "tail": 100
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "tail": {
      "description": "Trailing lines; default 200, maximum 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "service": {
      "description": "Compose service; default the public service.",
      "type": "string"
    },
    "build": {
      "description": "Read the build log instead of runtime output.",
      "type": "boolean"
    },
    "release": {
      "description": "Exact release number returned by deploy.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 999999999
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_releases

Read only · hub:read

List release history for one explicit app or instance.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
hub_app_releases arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_redeploy

Changes apps · hub:write

Deploy the GitHub branch head again, or rebuild the current uploaded artifact. Returns a release immediately; poll its exact number using hub_app_status.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
hub_app_redeploy arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_access

Read: hub:read · Change settings: hub:write

Omit mode to read access. Set private (owner and invitees), org (organization and invitees), or public (anyone without login) only when the user requested that audience. Applies to the named instance.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
mode
Optional		stringOne of: "private", "org", "public"
hub_app_access arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "mode": {
      "type": "string",
      "enum": [
        "private",
        "org",
        "public"
      ]
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_env

Read only · hub:read

List environment variable names, build-time flags and update times for the target. Secret values are never returned.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
hub_app_env arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_env_set

Changes apps · hub:write

Set runtime variables, or include them at build time with build=true. Returns changed names and any queued release immediately, never values. This may restart or rebuild the app; poll the returned release number. Use only values authorized for this app.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
values
Required		objectVariable names mapped to their string values. Values are sent securely to Hub and never returned.
build
Optional		booleanMake these variables available while building as well as at runtime.
hub_app_env_set arguments
{
  "target": "my-app",
  "values": {
    "NODE_ENV": "production"
  }
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "values": {
      "type": "object",
      "propertyNames": {
        "type": "string",
        "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
      },
      "additionalProperties": {
        "type": "string"
      },
      "description": "Variable names mapped to their string values. Values are sent securely to Hub and never returned."
    },
    "build": {
      "description": "Make these variables available while building as well as at runtime.",
      "type": "boolean"
    }
  },
  "required": [
    "target",
    "values"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_env_unset

Changes apps · hub:write

Remove the named variables. Returns removed names and any queued release immediately; poll its release number. May restart or rebuild the app.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
names
Required		arrayNames to remove; no values.minItems: 1 · Items: string
hub_app_env_unset arguments
{
  "target": "my-app",
  "names": [
    "OLD_SETTING"
  ]
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "names": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
      },
      "description": "Names to remove; no values."
    }
  },
  "required": [
    "target",
    "names"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_rollback

Changes apps · hub:write

Create a new release from an earlier release. Omit release to choose the newest successful release older than the serving release. Returns the new release immediately; poll its exact number. Does not roll back database contents or environment variables.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
release
Optional		integerEarlier release number to restore; default the newest successful release older than the serving release.maximum: 999999999
hub_app_rollback arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "release": {
      "description": "Earlier release number to restore; default the newest successful release older than the serving release.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 999999999
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_start

Changes apps · hub:write

Start an app that was stopped. Inspect hub_app_status afterward to verify its services.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
wait
Optional		booleanWait for completion; default true. Set false to return an operation ID to poll with hub_app_runtime.
hub_app_start arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "wait": {
      "description": "Wait for completion; default true. Set false to return an operation ID to poll with hub_app_runtime.",
      "type": "boolean"
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_stop

Changes apps · hub:write

Stop the named app instance. This interrupts service until it is started again; existing data is retained.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
wait
Optional		booleanWait for completion; default true. Set false to return an operation ID to poll with hub_app_runtime.
hub_app_stop arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "wait": {
      "description": "Wait for completion; default true. Set false to return an operation ID to poll with hub_app_runtime.",
      "type": "boolean"
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_app_restart

Changes apps · hub:write

Restart the named app instance without rebuilding it. This can briefly interrupt service. Inspect hub_app_status afterward.

ParameterTypeDetails
target
Required		stringExplicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted.minLength: 1
wait
Optional		booleanWait for completion; default true. Set false to return an operation ID to poll with hub_app_runtime.
hub_app_restart arguments
{
  "target": "my-app"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Explicit app or app/instance, for example my-app/staging. Defaults to prod only when instance is omitted."
    },
    "wait": {
      "description": "Wait for completion; default true. Set false to return an operation ID to poll with hub_app_runtime.",
      "type": "boolean"
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

hub_validate

Read only · hub:read

Validate hub.yaml text without uploading or reading local files. A manifest is optional for auto-detected projects.

ParameterTypeDetails
manifest
Required		stringContents of hub.yaml; maximum 64 KiB of UTF-8 text.maxLength: 65536
hub_validate arguments
{
  "manifest": "app: my-app\nservices:\n  web:\n    build: .\n    port: 3000\n"
}

Full input and output schemas
Input schema
{
  "type": "object",
  "properties": {
    "manifest": {
      "type": "string",
      "maxLength": 65536,
      "description": "Contents of hub.yaml; maximum 64 KiB of UTF-8 text."
    }
  },
  "required": [
    "manifest"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Skill resource

Read hub://skills/deploy through a client that supports MCP resources. It returns the deployment workflow as Markdown, without credentials.

Download the machine-readable MCP reference.

hub_whoami

Next Page