Harbor Cloud
Hosted Harbor workspaces, plugins, skills, functions, apps, traces, and MCP access.
Harbor Cloud is the managed control plane at tryharbor.ai. Use it when you want shared workspace credentials, hosted execution, traces, and MCP access without running local infrastructure.
Harbor Cloud
Harbor Cloud is the hosted workspace where teams connect plugins once and let agents, apps, SDK clients, and command-line runs use those tools through a single audited control plane.
What Cloud owns
| Surface | What it does |
|---|---|
| Workspaces | Membership, roles, source visibility, shared settings, and workspace-scoped API access. |
| Plugins | Connected sources and tools, including OAuth-backed services and custom MCP/API sources. |
| Skills | Agent-readable markdown that teaches when and how to use Harbor capabilities. |
| Exec | Hosted TypeScript execution for tool calls, fan-out, transforms, and runtime primitives. |
| Functions | Reusable, versioned code published from a working defineJob file. |
| Apps | Small HTTP surfaces published from deployApp files. |
| Traces | Runs, spans, tool calls, artifacts, logs, and audit records. |
| MCP server | The hosted agent entrypoint at https://mcp.tryharbor.ai/mcp. |
Runtime model
Agents and developers should separate discovery from execution:
hrbr inspect 'return await hrbr.sources.list()'
hrbr inspect 'return await hrbr.tools.search({ query: "github pull requests", limit: 3 })'
hrbr exec -f ./task.tsUse inspect for auth state, workspace state, source readiness, tool
schemas, jobs, apps, runs, and triggers. Use exec for Harbor Cloud
execution: plugin tool calls, multi-step code, fan-out, runtime storage, and
publishing traced work.
SDK access
Application code should use @hrbr/client or Python
harbor-sdk against the same hosted API:
import { createHarborClient } from '@hrbr/client'
const harbor = createHarborClient({
baseUrl: 'https://api.tryharbor.ai',
workspaceId: process.env.HARBOR_WORKSPACE_ID!,
auth: { kind: 'api_key', key: process.env.HARBOR_API_KEY! },
})
const run = await harbor.runtime.execute({
code: 'return "hello from Harbor Cloud"',
})Use @hrbr/sdk when you need Harbor system contracts, generated
protocol artifacts, or local platform adapters.