# Clone the repository
git clone https://github.com/yourusername/toolgate.git
cd toolgate

# Install with pip
pip install -e .

# Or install with dev dependencies
pip install -e ".[dev]"

# config.yaml
upstream_servers:
  - name: filesystem
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]

  - name: git
    command: npx
    args: ["-y", "@modelcontextprotocol/server-git", "--repository", "/path/to/repo"]

gating:
  top_k: 10
  always_include:
    - "read_*"
    - "git_status"
  always_exclude:
    - "delete_*"
  session_boost: 0.15
  session_window: 5

index:
  model_name: "sentence-transformers/all-MiniLM-L6-v2"
  similarity_metric: "cosine"

metrics:
  enabled: true
  db_path: "~/.toolgate/metrics.db"

toolgate serve --config config.yaml

{
  "mcpServers": {
    "toolgate": {
      "command": "toolgate",
      "args": ["serve", "--config", "/path/to/config.yaml"]
    }
  }
}

toolgate serve --config config.yaml

toolgate index --config config.yaml

toolgate status --config config.yaml --limit 20

toolgate benchmark --benchmark-dir ./benchmark

┌─────────────┐
│  AI Agent   │
└──────┬──────┘
       │ MCP (stdio)
       ▼
┌─────────────────────────────────────┐
│          ToolGate Proxy             │
│  ┌───────────────────────────────┐  │
│  │   Semantic Search Engine      │  │
│  │  • sentence-transformers      │  │
│  │  • FAISS cosine similarity    │  │
│  └───────────────────────────────┘  │
│  ┌───────────────────────────────┐  │
│  │      Gating Rules             │  │
│  │  • always_include/exclude     │  │
│  │  • session boost              │  │
│  └───────────────────────────────┘  │
│  ┌───────────────────────────────┐  │
│  │    Metrics (SQLite)           │  │
│  │  • Token counting             │  │
│  │  • Latency tracking           │  │
│  └───────────────────────────────┘  │
└──────┬──────────────────┬───────────┘
       │                  │
       ▼                  ▼
┌─────────────┐    ┌─────────────┐
│ MCP Server  │    │ MCP Server  │
│ (filesystem)│    │    (git)    │
└─────────────┘    └─────────────┘

upstream_servers:
  - name: server_name        # Unique identifier
    command: executable      # Command to run
    args: [...]             # Command arguments
    env:                    # Optional environment variables
      VAR: value

gating:
  top_k: 10                 # Max tools to return (default: 10)
  always_include:           # Patterns to always include
    - "git_*"
    - "read_file"
  always_exclude:           # Patterns to always exclude
    - "dangerous_*"
  session_boost: 0.15       # Score boost for recent tools (0-1)
  session_window: 5         # Number of recent turns to track
  description_max_length: 200  # Truncation length

index:
  model_name: "sentence-transformers/all-MiniLM-L6-v2"
  cache_dir: "~/.cache/toolgate"  # Optional model cache
  similarity_metric: "cosine"     # cosine, euclidean, or dot

metrics:
  enabled: true
  db_path: "~/.toolgate/metrics.db"
  token_model: "cl100k_base"  # tiktoken encoding

# Install dev dependencies
pip install -e ".[dev]"

# Run all tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=toolgate --cov-report=html

# Run benchmark suite
python benchmark/run.py

# Or via CLI
toolgate benchmark