agent-corex 1.1.1

Fast, accurate MCP tool retrieval engine for LLMs with semantic search

Agent-CoreX

🚀 Production-ready MCP tool retrieval engine + CLI for AI agents

Agent-CoreX solves a critical problem in LLM systems:

When you have hundreds of tools, how do you select the right few without blowing up the context window?

---

Quick links: PyPI · Docs · Releases · GitHub

---

Install

Option 1 — Homebrew (macOS / Linux, no Python required)

brew tap ankitpro/agent-corex
brew install agent-corex

Option 2 — Direct binary download (no Python required)

# macOS (arm64 — M1/M2/M3 and Intel via Rosetta 2)
curl -fsSL https://github.com/ankitpro/agent-corex/releases/latest/download/agent-corex-macos-arm64 \
  -o /usr/local/bin/agent-corex && chmod +x /usr/local/bin/agent-corex

# Linux x86_64
curl -fsSL https://github.com/ankitpro/agent-corex/releases/latest/download/agent-corex-linux-x86_64 \
  -o /usr/local/bin/agent-corex && chmod +x /usr/local/bin/agent-corex

Windows — run PowerShell as Administrator:

# Installs to System32 — works from any terminal after this
Invoke-WebRequest `
  -Uri https://github.com/ankitpro/agent-corex/releases/latest/download/agent-corex-windows-x86_64.exe `
  -OutFile "$env:SystemRoot\System32\agent-corex.exe"
agent-corex --version

No admin access? See the per-user install →

Option 3 — pip (Python 3.8+)

pip install agent-corex

All three methods give you the same agent-corex CLI. Homebrew and the binary downloads require no Python installation.

---

Quick Start

# 1. Authenticate with the Agent-Corex backend
agent-corex login --key acx_your_key

# 2. Detect installed AI tools (Claude Desktop, Cursor, VS Code, etc.)
agent-corex detect

# 3. Inject agent-corex as an MCP server into all detected tools
agent-corex init

# 4. Verify everything is working
agent-corex status

# Run diagnostics if anything looks wrong
agent-corex doctor

---

CLI Reference

Setup & Auth

Command	Description
agent-corex login --key <key>	Store API key and verify with backend
agent-corex logout	Remove stored credentials
agent-corex keys	Show masked API key + live backend verification

Tool Detection & Injection

Command	Description
agent-corex detect	Detect installed AI tools and show config paths
agent-corex init [--yes]	Inject agent-corex MCP entry into all detected tools
agent-corex eject [--tool <t>] [--yes]	Remove agent-corex from tool configs
agent-corex status	Auth state, backend ping, injection status per tool

MCP Server Management

Command	Description
agent-corex list	List all MCP servers injected across detected tools
agent-corex registry	Browse the installable MCP server catalog
agent-corex install-mcp <name> [--yes]	Install any registry server into detected tools
agent-corex update [--yes]	Re-fetch registry and update injected server configs

Diagnostics

Command	Description
agent-corex doctor	Full health check: Python, PATH, config, backend, API key, injection
agent-corex health	Quick backend health check
agent-corex version	Print installed version

Gateway

Command	Description
agent-corex serve	Start the MCP gateway server (stdio — invoked by AI tools)

Tool Retrieval

Command	Description
agent-corex retrieve "<query>"	Semantic search for relevant tools

---

Supported AI Tools

Tool	Platform
Claude Desktop	macOS, Windows
Cursor	macOS, Windows, Linux
VS Code	macOS, Windows, Linux
VS Code Insiders	macOS, Windows, Linux
VSCodium	macOS, Windows, Linux

---

How It Works

Your AI tool (Claude / Cursor / VS Code)
         │  stdio
         ▼
  agent-corex serve        ← MCP gateway (single entry point)
         │
         ├─ retrieve_tools(query) → semantic search over all tools
         ├─ execute_tool(name, args) → routes call to correct MCP server
         └─ auth_check → validates Enterprise API key

The gateway exposes a small, fixed set of tools to Claude/Cursor instead of hundreds. This cuts context tokens by ~60% and keeps the LLM focused.

---

MCP Marketplace

Browse and install any MCP server with one command:

agent-corex registry              # browse catalog
agent-corex install-mcp github    # install GitHub MCP server
agent-corex install-mcp postgres  # install Postgres MCP server
agent-corex list                  # see all currently installed servers
agent-corex update                # pull latest configs from registry

---

Tool Retrieval (Python API)

from agent_core.retrieval.ranker import rank_tools

tools = rank_tools("edit a file", all_tools, top_k=5, method="hybrid")
# Returns: ["edit_file", "write_file", "create_file", ...]

Three ranking methods:

• keyword — fast exact-match, no model required
• embedding — semantic similarity via sentence-transformers
• hybrid (recommended) — 30% keyword + 70% semantic

---

Releases & CI/CD

Every tag push triggers:

Workflow	What it does
build-binaries.yml	PyInstaller binaries for Linux x86_64, macOS arm64, Windows x86_64 + SHA256 sidecars
publish.yml	Publishes to PyPI
update-homebrew-tap.yml	Auto-patches the Homebrew formula with new version + SHA256s

---

Contributing

See CONTRIBUTING.md.

git clone https://github.com/ankitpro/agent-corex
cd agent-corex
pip install -e ".[dev]"
pytest