| name | claude-oracle |
| description | Automatic tool discovery across 17 sources — hooks search before planning and after errors, siblings avoid redundant searches |
| triggers | ["PreToolUse","PostToolUse"] |
Oracle Plugin
Tool discovery. Searches 17 sources in parallel to find relevant skills, plugins, and MCP servers.
Hooks
| Hook | When | Action |
|---|
| PreToolUse(EnterPlanMode) | Before planning | Searches for relevant tools before planning |
| PostToolUse(Bash) | After errors | Searches for tools that solve the error |
Commands
| Command | Description |
|---|
/search-oracle <query> [type] | Search for tools across all 17 sources |
Workflows
Discovery (standalone)
search("query") — search all sources- Review results with install commands
- Install useful tools: skills, plugins, or MCP servers
Discovery (with siblings)
- If historian active:
find_similar_queries("query") first to check if this search was done before
search("query") — oracle's own search across 17 sources- If praetorian active: compact the discovery results for future reference
- Present findings with install commands and note what siblings already provide
Error Tool Search (standalone)
- Error triggers PostToolUse hook
search("error description") — find tools that address this error class- Present matching tools with install commands
Error Tool Search (with siblings)
- Error triggers PostToolUse hook
- If historian active:
get_error_solutions("error") checks if solved before
search("error description") — oracle finds new tools- If gladiator active: error is also being observed for pattern detection
- Combined: past solution (historian) + new tools (oracle) + pattern tracking (gladiator)
Sibling Synergy
| Sibling | Value | How |
|---|
| Historian | Past searches avoid duplicate discovery | Historian checked first, oracle only runs if no history match |
| Praetorian | Cached compactions contain prior tool results | Restore before re-searching |
| Gladiator | Observations reveal tool gaps | Reflection may suggest searching for tools to fill gaps |
Data Sources (17)
Smithery Registry, Glama.ai, Official MCP Registry, npm, GitHub marketplace plugins, awesome-mcp-servers, awesome-mcp-lists, awesome-claude-code (ccplugins), awesome-claude-code (jmanhype), awesome-agent-skills, Playbooks.com, SkillsMP, and more.
Requires
claude mcp add oracle -- npx claude-oracle-mcp
