Engineering
claude-oracle avatar

claude-oracle

Automated tool and MCP server discovery for Claude Code. Searches 17+ registries to find relevant skills, plugins, and tools before planning or when errors occur.

Introduction

Claude Oracle is a specialized productivity plugin designed for developers using Claude Code who require immediate access to the latest Model Context Protocol (MCP) servers and agent skills. It functions as an intelligent layer that sits between your workflow and a vast ecosystem of 17 distinct tool registries, including Smithery, Glama.ai, official MCP registries, npm, and GitHub marketplaces. By acting as a discovery engine, it prevents the manual overhead of searching for external tools when a specific task requires new functionality or when a command execution fails.

  • Real-time parallel search across 17+ registries including awesome-mcp-servers, npm, and GitHub marketplace plugins.
  • Automated PreToolUse hook integration: proactively identifies tools relevant to your upcoming plan before you execute.
  • Automated PostToolUse hook integration: triggers intelligent searches upon encountering errors to suggest specific fixes or troubleshooting tools.
  • Sibling synergy capabilities: coordinates with the Historian plugin to avoid redundant searches and integrates with Praetorian for context management.
  • Deep integration with command-line interfaces: provides simple /search-oracle commands to fetch registry information and installation snippets directly into the chat.

This plugin is intended for power users and AI engineers who want to automate their toolchain management. The Oracle works best in environments where complex tasks often hit walls that could be bypassed by installing a specific tool.

  • Usage: Install via npm (npx claude-oracle-mcp). The plugin automatically monitors tool usage patterns.
  • Inputs/Outputs: The primary input is the semantic context of your plan or error; the output is a set of installable MCP server recommendations.
  • Constraints: Requires an active Claude Code environment and the installation of the underlying MCP server. It is most effective when used alongside other Emporium siblings like Historian and Gladiator for a holistic development experience.
  • Performance: The agent performs concurrent network requests to fetch metadata from diverse registries, typically adding negligible latency compared to the benefit of reduced manual research time.

Repository Stats

Stars
105
Forks
5
Open Issues
6
Language
JavaScript
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 09:25 AM
View on GitHub