hoziron-cli integration

Manage integration server lifecycle — connect, disconnect, and inspect MCP-compatible tool servers.

Synopsis

hoziron-cli integration <subcommand> [options]

Subcommands

Subcommand	Description
`connect <name>`	Connect an installed integration (start its server process)
`disconnect <name>`	Disconnect a running integration (stop its server process)
`reconnect <name>`	Reconnect an integration (restart its server process)
`status <name>`	Show the runtime status of an integration
`tools <name>`	Show the tools exposed by a running integration

hoziron-cli integration connect

$ hoziron-cli integration connect postgresql-connector
Integration 'postgresql-connector' connected.

hoziron-cli integration disconnect

$ hoziron-cli integration disconnect postgresql-connector
Integration 'postgresql-connector' disconnected.

hoziron-cli integration reconnect

$ hoziron-cli integration reconnect postgresql-connector
Integration 'postgresql-connector' reconnected.

hoziron-cli integration status

$ hoziron-cli integration status postgresql-connector
postgresql-connector: running

$ hoziron-cli integration status salesforce-connector
salesforce-connector: stopped

hoziron-cli integration tools

Show what tools an integration exposes to agents.

$ hoziron-cli integration tools postgresql-connector
TOOL                           DESCRIPTION
query                          Execute a read-only SQL query
list_tables                    List all tables in the connected database
describe_table                 Show columns and types for a table
execute                        Execute a write SQL statement (requires permission)

$ hoziron-cli integration tools github-connector
TOOL                           DESCRIPTION
create_issue                   Create a new GitHub issue
list_issues                    List issues with filters
create_pr                      Create a pull request
get_file                       Read a file from a repository
search_code                    Search code across repositories

Quick Install + Start

The hoziron-cli add command combines install + credential + start:

$ hoziron-cli add github --key ghp_abc123...
✓ Installed github integration
✓ Stored credential in vault
✓ Started github-connector (4 tools available)

Equivalent to:

hoziron-cli catalog install github-connector
hoziron-cli vault set GITHUB_TOKEN
hoziron-cli integration connect github-connector

Removing Integrations

# Remove the one-click integration (stops + uninstalls + removes credential)
$ hoziron-cli remove github
✓ Stopped github-connector
✓ Removed from vault
✓ Uninstalled

# List installed integrations
$ hoziron-cli integrations
NAME                   STATUS    TOOLS
postgresql-connector   running   4
github-connector       stopped   5
salesforce-connector   stopped   8

# Search available integrations
$ hoziron-cli integrations "database"
NAME                   DESCRIPTION
postgresql-connector   PostgreSQL database connector
mysql-connector        MySQL/MariaDB connector
mssql-connector        Microsoft SQL Server connector

Integration Architecture

Integrations are MCP-compatible server processes:

Agent → Skill (tool definition) → Integration Server (MCP) → External Service

The integration server runs as a child process of the daemon
Communication is via stdio (MCP protocol)
Each server can expose multiple tools
Credentials are passed via environment variables (from the vault)