Tools Router

Tools Router (Unified)

Consolidates: cli-router + tools-router + data-router Purpose: All external tool execution (CLI, MCP, databases) Legacy References: ~/.claude/db/skills/routers/cli-router/, ~/.claude/db/skills/routers/data-router/

CLI Tools (Local Binaries)

AI/LLM Agents

Context Extraction

Data Processing

Semantic Search

MCP Tools (Lootbox)

Routes tasks to MCP tools via lootbox code-mode for external service integration.

MCP Tool Categories

Knowledge Graph

Research & Search

Methodology & Reasoning

Solvers

Storage & Memory

External Services

Lootbox Code-Mode

Configuration

server: ws://localhost:9742/ws
ui: http://localhost:9742/ui
config: ~/lootbox.config.json

Local Tools (Always Available)

tools.kv.*       // Key-value store
tools.sqlite.*   // SQLite database
tools.memory.*   // In-memory storage
tools.graphql.*  // GraphQL queries

Invocation Patterns

# List available tools
lootbox tools

# Execute single operation
lootbox exec 'await tools.neo4j.query({ cypher: "MATCH (n) RETURN n LIMIT 5" })'

# Chain operations
lootbox exec '
  const results = await tools.perplexity.search({ query: "Claude Code best practices" });
  await tools.kv.set({ key: "research", value: results });
  return results;
'

# Parallel operations
lootbox exec '
  const [a, b] = await Promise.all([
    tools.neo4j.query({ cypher: "MATCH (n:Skill) RETURN n" }),
    tools.deepgraph.semantic_search({ query: "authentication" })
  ]);
  return { skills: a, code: b };
'

Routing Logic

MCP Task Detected
    │
    ├── Graph operations?
    │   ├── Neo4j? → tools.neo4j
    │   ├── Code graph? → tools.deepgraph
    │   └── Text graph? → tools.relate
    │
    ├── Research?
    │   ├── AI search? → tools.perplexity
    │   ├── Web search? → tools.brave-search
    │   └── Page index? → tools.pageindex-local
    │
    ├── Reasoning?
    │   ├── Methodology? → tools.meta-cc
    │   ├── Multi-model? → tools.zen
    │   └── AoT? → tools.distil
    │
    ├── Constraint solving?
    │   ├── SMT? → tools.solver-z3
    │   ├── Optimization? → tools.solver-minizinc
    │   └── SAT? → tools.solver-pysat
    │
    └── Storage?
        ├── Files? → tools.filesystem
        ├── KV? → tools.kv
        └── Memory? → tools.memory

Tool Selection Matrix

Integration

• lootbox: Code-mode execution
• MCP servers: External tool providers
• cli-index: CLI tool fallback
• meta-router: Parent routing

Quick Reference

# Start lootbox server
lootbox server --port 9742

# Check available namespaces
lootbox tools

# Neo4j query
lootbox exec 'await tools.neo4j.query({ cypher: "..." })'

# Perplexity search
lootbox exec 'await tools.perplexity.search({ query: "..." })'

# Chained operations
lootbox exec '
  const data = await tools.X.fetch();
  return tools.Y.process(data);
'