expert_registry_listLABSCO SUMMARY
Two databases, because matching and relating are different jobs.
Vector search finds an expert that means roughly what you asked for; a graph finds the ones that work together. Running both and scoring on the combination is what lets expert_find_combinations propose a team rather than a single best match. The price is real infrastructure — Neo4j alongside the embedded vector store — which is why the Docker path exists. The contexts themselves are your markdown, editable in place and reloaded without a restart.
What it is
A registry of expert contexts — markdown knowledge files scoped to a technology — with the machinery to pick the right one automatically. It scans your project to detect what it is built with, matches that against the registry using both vector similarity and graph connectivity, and injects the chosen expert's knowledge into a prompt. Registry and context files live on disk and hot-reload when you edit them.
What you get
expert_detect_technologiesscans paths in your project to work out what it usesexpert_smart_discovercombines vector similarity and graph connectivity to pick the best expert for a task and its constraintsexpert_semantic_searchandexpert_find_similarsearch by meaning rather than by keywordexpert_load_contextloads an expert's knowledge andexpert_inject_contextfolds it into a promptexpert_explore_networkandexpert_find_combinationswalk expert relationships and propose complementary teamsexpert_registry_list,expert_registry_getandexpert_registry_searchcover the plain registry lookupsexpert_track_usageandexpert_get_analyticsrecord which expert was used and how it performed
Requirements
An expert-system directory containing registry/expert-registry.json, an expert-contexts/ folder of markdown, and performance/metrics.json — pointed at by EXPERT_SYSTEM_PATH. ChromaDB is embedded and creates its own directory; Neo4j is separate and needs NEO4J_URI and NEO4J_PASSWORD, most easily run in Docker. The README's install line names expert-registry-mcp at version 1.0.0, which PyPI does not have, and the container image it points to is not publicly available — so you clone the repository and install it with uv.
Setup effort
Build from source — git clone https://github.com/agentience/expert-registry-mcp
USE CASES
Getting expert framing without naming the expert
Detect the project's technologies, then let the hybrid search pick the right context.
Enriching a prompt with domain knowledge
Load the expert's context and inject it into the request you were about to send.
Assembling a team for a cross-cutting task
Explore the relationship network and find complementary experts.
Finding out which experts are actually helping
Record usage after each task and read the performance metrics back.
15 tools
Listed in project docs. Your client may show a different list.
expert_registry_getexpert_registry_searchexpert_detect_technologiesexpert_select_optimalexpert_assess_capabilityexpert_smart_discoverexpert_semantic_searchexpert_find_similarexpert_explore_networkexpert_find_combinationsexpert_load_contextexpert_inject_contextexpert_track_usageexpert_get_analyticsBEFORE YOU INSTALL
What to know first
Tools you get
15 tools named in the project's documentation.
Requires
- Python 3.11+ with uv
- A running Neo4j database reachable at NEO4J_URI
- NEO4J_PASSWORD in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
git clone https://github.com/agentience/expert-registry-mcp
cd expert-registry-mcp
uv venv
uv pip install -e .Start Neo4j (the README's Docker route):
docker run -d --name neo4j -p 7474:7474 -p 7687:7687 -e NEO4J_AUTH=neo4j/password neo4j:latestCreate your expert-system directory with registry/expert-registry.json, expert-contexts/ and performance/metrics.json, and point EXPERT_SYSTEM_PATH at it
MCP Clients
Claude Desktop
{
"mcpServers": {
"expert-registry": {
"command": "<YOUR_PATH_TO_EXPERT_REGISTRY_MCP>/.venv/bin/expert-registry-mcp",
"env": {
"EXPERT_SYSTEM_PATH": "<YOUR_EXPERT_SYSTEM_PATH>",
"NEO4J_URI": "bolt://localhost:7687",
"NEO4J_PASSWORD": "password"
}
}
}
}