claude-oracle — Claude Code plugin for tool discovery
claude-oracle searches 17 sources for skills, plugins, and MCP servers. It can look for relevant tools before planning or after a command error.
MIT ★ 78 updated 2026-03-05
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-oracle@claude-emporiumWhat claude-oracle does
Claude Oracle searches 17 sources for skills, plugins, and MCP servers. A hook starts a search before Claude Code enters plan mode; after a Bash tool call, another hook looks for tools related to errors. Search results include installation commands.
The plugin relies on the claude-oracle-mcp server, added with claude mcp add oracle -- npx claude-oracle-mcp. Without that server, the hook-triggered searches cannot run. You can also call /search-oracle <query> [type] directly. Its MCP tools include search, browse, and sources for finding tools, browsing categories, and checking source status.
What it helps with
- find relevant skills before planning a task
- search for a plugin that fits a project
- look for tools that can help resolve a command error
- check available sources for MCP tools
Example prompts for the agent
- Find tools for this task:
/search-oracle <query>. - Search for MCP servers in this category:
/search-oracle <query> <type>. - Before planning, look for relevant skills and plugins.
How to install claude-oracle
Plugin marketplace
/plugin marketplace add Vvkmnn/claude-emporium/plugin install claude-oracle@claude-emporiumStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about claude-oracle
How do I install claude-oracle in Claude Code?
Run these commands in order: /plugin marketplace add Vvkmnn/claude-emporium, then /plugin install claude-oracle@claude-emporium.
What does claude-oracle do?
It searches 17 sources for skills, plugins, and MCP servers. Hooks start searches before planning and after a Bash call, and results include install commands.
What does claude-oracle need to run?
It requires the claude-oracle-mcp server. Add it with claude mcp add oracle -- npx claude-oracle-mcp.
Source text
claude-oracle · MIT
# Claude Oracle
Automatic discovery of skills, plugins, and MCP servers for Claude Code. Searches 17 sources in parallel to find relevant tools before you start planning or when you hit errors.
## Installation
```bash
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-oracle@claude-emporium
```
## Requirements
MCP server: [`claude-oracle-mcp`](https://www.npmjs.com/package/claude-oracle-mcp)
```bash
claude mcp add oracle -- npx claude-oracle-mcp
```
## Hooks
| Event | Trigger | What It Does |
|-------|---------|-------------|
| `PreToolUse` | `EnterPlanMode` | Searches for relevant tools before planning |
| `PostToolUse` | `Bash` | Searches for tools that solve errors |
## Commands
| Command | Description |
|---------|-------------|
| `/search-oracle <query> [type]` | Search for tools across all sources |
## MCP Tools
| Tool | Purpose |
|------|---------|
| `search` | Search all sources for relevant tools |
| `browse` | Browse by category or popularity |
| `sources` | Show available data sources and status |
## Data Sources (17)
Smithery Registry, Glama.ai, Official MCP Registry, npm Registry, GitHub marketplace plugins, awesome-mcp-servers (wong2), awesome-mcp-lists (collabnix), awesome-claude-code (ccplugins), awesome-claude-code (jmanhype), awesome-agent-skills, Playbooks.com, SkillsMP, and more.
## Settings
Configure in `~/.claude/settings.json` under `claude-emporium`:
```json
{
"claude-emporium": {
"suggest_siblings": false,
"claude-oracle": {
"search_before_plan": false,
"search_after_error": false
}
}
}
```
| Key | Default | What It Controls |
|-----|---------|-----------------|
| `search_before_plan` | `true` | Search for relevant tools before planning |
| `search_after_error` | `true` | Search for tools that solve errors |
| `suggest_siblings` | `true` | Show install suggestions for sibling plugins (global) |
## How It Works
Hooks inject prompts that trigger `claude-oracle-mcp` search at high-impact moments. Results include install commands so you can immediately add useful tools.
Zero setup — no databases, no local storage. All search is computed in-memory with TTL caching.
## License
MIT
© vvkmnn · MIT · Vvkmnn/claude-emporium