Built-in Connectors
Wick ships a set of built-in connectors that every downstream app inherits at boot. They use the same module shape as user-registered connectors (Connector Module) and surface through MCP via the meta-tool pattern (MCP for LLMs).
A built-in is just a regular connector that calls connectors.Register(...) (or sits inside connectors.RegisterBuiltins() / RegisterLabSamples()) instead of waiting for app.RegisterConnector in your main.go. Once registered, it follows the same lifecycle:
- Auto-seeded as one empty row on first boot.
- Listed at
/manager/connectors/<key>for credentials + per-op enable. - Reachable from an LLM via
wick_list/wick_get/wick_execute.
Index
| Connector | Key | Purpose | Default tier |
|---|---|---|---|
| HTTP / REST | httprest | Generic JSON REST client — GET / POST / PUT / PATCH / DELETE any path. Useful when you want an LLM to call an API you haven't wrapped in a typed connector yet. | builtin |
| GitHub | github | List repos / issues / PRs, read file contents, create issues, post comments. | builtin |
| Bitbucket | bitbucket | Search repos, read commits / diffs, list and create pull requests, post PR comments (top-level or inline). | builtin |
| Slack | slack | Read channels, threads, users; send / edit / delete messages; manage reactions. OAuth credentials supported on the row. | builtin |
| Google Workspace | google_workspace | Manage Drive files, read/write Sheets, edit Docs, and manage Slides — all under one Google OAuth account. 20 ops across four Google APIs. | builtin |
| Phoenix | phoenix | Debug LLM behaviour in Arize Phoenix — list spans by room or app_id and inspect a single span's prompt, messages, tool calls, and token usage. Read-only. | builtin |
| Wick Manager | wickmanager | Read and edit wick's own apps / jobs / tools / connectors / tray lifecycle. For asking the LLM to inspect or tweak wick itself, not third-party APIs. | runtime |
| Workflow | workflow | Create, edit, test, simulate, and run workflows over MCP — the LLM-facing surface for the Workflows feature. | runtime |
| Notifications | notifications | Send a browser push notification to a subscribed user by opaque PN ID. Pairs with the per-session subscribe bell on the agents UI. | runtime |
| CRUD CRUD | crudcrud | Demo connector wrapping the public crudcrud.com sandbox. Ships with cmd/lab only — useful as a copy-paste starting point. | lab sample |
Tiers:
- builtin — registered by
connectors.RegisterBuiltins(); every downstream wick app gets it for free. - runtime — registered inline at boot in
internal/pkg/api/server.gobecause the operations need runtime services (configsSvc, jobsSvc, workflow engine, …) that only exist mid-boot. - lab sample —
connectors.RegisterLabSamples()incmd/labonly. Not present in production binaries.
Tag visibility
Every built-in is seeded with tags.Connector so it appears under the Connector group on the home page. Visibility within authenticated users follows the same tag-filter rule as user-registered connectors — see Connector Module ▶ Sharing connectors with tags.
The Wick Manager and Workflow connectors operate against in-process wick state (configs, jobs, workflow folders) and respect each subject's own access control on top of the connector-level tag filter:
- Wick Manager — every
app_*andsystem_*op is admin-only.job_*/tool_*/connector_*ops are per-resource-tag-filtered (admin sees all; non-admin sees only resources whose tags grant access). - Workflow — every
workflow_*mutation requires admin; read ops are visible to any authenticated caller.
See also
- Connector Module — module contract, file layout, registration,
wick:"..."tag grammar. - MCP for LLMs — transport,
wick_list/wick_get/wick_executeflow. - Connector API reference —
pkg/connectorexported types. - Encrypted Fields — how
secret-tagged credentials are stored and round-tripped.