hoziron integration

Manage integration server lifecycle — start, stop, and inspect MCP-compatible tool servers.

Synopsis

hoziron integration <subcommand> [options]

Subcommands

SubcommandDescription
start <name>Start an integration's server process
stop <name>Stop a running server
restart <name>Restart a server
status <name>Show runtime status
tools <name>Show exposed tools

hoziron integration start

$ hoziron integration start postgresql-connector
✓ Integration 'postgresql-connector' started (pid: 12345)
  Tools available: 4

hoziron integration stop

$ hoziron integration stop postgresql-connector
✓ Integration 'postgresql-connector' stopped

hoziron integration restart

$ hoziron integration restart postgresql-connector
✓ Integration 'postgresql-connector' restarted (pid: 12350)

hoziron integration status

$ hoziron integration status postgresql-connector
Integration: postgresql-connector
Status: running
PID: 12345
Uptime: 2h 15m
Tools: 4
Protocol: MCP (stdio)

$ hoziron integration status salesforce-connector
Integration: salesforce-connector
Status: stopped

hoziron integration tools

Show what tools an integration exposes to agents.

$ hoziron 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 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 add command combines install + credential + start:

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

Equivalent to:

hoziron catalog install github-connector
hoziron vault set GITHUB_TOKEN
hoziron integration start github-connector

Removing Integrations

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

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

# Search available integrations
$ hoziron 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)

See Also