orchestra-mcp/plugin-tools-hooks

Hook event logging and notification plugin for Orchestra MCP.

Persists hook events fired by Claude Code hooks (Notification, ToolUse, SubagentStart, TaskComplete, etc.) into a local SQLite store, and exposes them to AI agents via MCP tools.

Install

orchestra plugin install orchestra-mcp/plugin-tools-hooks

Or build from source:

go build -o bin/tools-hooks ./cmd/

Tools

Tool	Description
receive_hook_event	Ingest a hook event (called by orchestra-mcp-hook.sh)
get_hook_events	Query stored hook events with optional filters

receive_hook_event

Called automatically by the orchestra-mcp-hook.sh Claude Code hook. Stores the event in the local SQLite database.

Parameters:

• event_type — Hook event type (e.g. Notification, ToolUse, SubagentStart, TaskComplete)
• session_id — Claude Code session ID
• tool_name — Tool name (for ToolUse events)
• agent_type — Agent type that fired the event
• payload — JSON payload from the hook

get_hook_events

Query recent hook events.

Parameters:

• event_type (optional) — Filter by event type
• session_id (optional) — Filter by session ID
• limit (optional) — Max events to return (default: 100)

Related Packages

• sdk-go — Plugin SDK
• gen-go — Generated Protobuf types
• framework — Orchestra MCP framework