# Toolpilot

> High‑performance persistent MCP server optimized for Copilot CLI

- **Type:** MCP server
- **Install:** `agentstack add mcp-ossirytk-toolpilot`
- **Verified:** Pending review
- **Seller:** [ossirytk](https://agentstack.voostack.com/s/ossirytk)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Unlicense
- **Upstream author:** [ossirytk](https://github.com/ossirytk)
- **Source:** https://github.com/ossirytk/toolpilot

## Install

```sh
agentstack add mcp-ossirytk-toolpilot
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# toolpilot

High‑performance persistent MCP server for GitHub Copilot CLI and VS Code Copilot.

## Available tools

| Tool | Description |
|------|-------------|
| `fs_glob` | Deterministic glob expansion with capped output |
| `fs_tree` | Depth-limited directory tree (`include_hidden` available for dotfiles/dirs) |
| `text_search` | Literal/regex search with line and byte offsets, plus optional `glob` / `file_type` filters |
| `read_file` | UTF-8 file reader with optional `start_line`/`end_line` and `max_bytes` cap |
| `json_select` | Explicit field selection and typed filters for JSON files |
| `yaml_select` | Field extraction from YAML/TOML using dot-notation paths (including array indexes like `jobs.0.steps`) |
| `file_hash` | File checksums for `sha256` (default), `sha1`, and `md5` |
| `git_log` | Structured git history with optional diff stat and unified diff output |
| `server_stats` | Request/cache counters including cache entries and eviction counters |

The server runs as a single persistent stdio MCP process, returns structured
JSON only, and uses in-process caches for parsed JSON, memory-mapped text
files, and compiled regexes.

## Installation

### Prerequisites

A Rust toolchain is required. Install it via [rustup](https://rustup.rs/):

**Linux / macOS:**

```sh
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

**Windows (PowerShell):**

Download and run `rustup-init.exe` from , or install via winget:

```powershell
winget install Rustlang.Rustup
```

### Option 1 — `cargo install` from GitHub (recommended)

```sh
cargo install --git https://github.com/ossirytk/toolpilot
```

The binary is placed in `~/.cargo/bin/toolpilot` (Linux/macOS) or
`%USERPROFILE%\.cargo\bin\toolpilot.exe` (Windows). Ensure `~/.cargo/bin` is
on your `PATH` (rustup adds it automatically).

### Option 2 — `cargo binstall`

If you have [cargo-binstall](https://github.com/cargo-bins/cargo-binstall)
installed:

```sh
cargo binstall --git https://github.com/ossirytk/toolpilot toolpilot
```

### Option 3 — Build from source

```sh
git clone https://github.com/ossirytk/toolpilot
cd toolpilot
cargo build --release
```

The binary is written to `target/release/toolpilot`.

## Configuration

After installation, register toolpilot as an MCP server in your editor or CLI.

> **Note:** Do not use `cargo run` as the command — the compilation delay causes
> the client to time out before the server is ready. Always point to the
> compiled binary.

### GitHub Copilot CLI

Copy `mcp-config.example.json` to `~/.copilot/mcp-config.json` and set `command` to the binary path:

```json
{
  "mcpServers": {
    "toolpilot": {
      "type": "stdio",
      "command": "toolpilot"
    }
  }
}
```

If the binary is not on your `PATH`, use the absolute path to the compiled binary instead:

**Linux / macOS:**

```json
{
  "mcpServers": {
    "toolpilot": {
      "type": "stdio",
      "command": "/absolute/path/to/toolpilot/target/release/toolpilot"
    }
  }
}
```

**Windows:**

```json
{
  "mcpServers": {
    "toolpilot": {
      "type": "stdio",
      "command": "C:\\path\\to\\toolpilot\\target\\release\\toolpilot.exe"
    }
  }
}
```

### VS Code Copilot

#### Workspace-level (`.vscode/mcp.json`)

Add a `.vscode/mcp.json` file to your workspace:

```json
{
  "servers": {
    "toolpilot": {
      "type": "stdio",
      "command": "toolpilot"
    }
  }
}
```

#### User-level (`settings.json`)

Open **Settings → Open User Settings (JSON)** and add:

```json
{
  "mcp": {
    "servers": {
      "toolpilot": {
        "type": "stdio",
        "command": "toolpilot"
      }
    }
  }
}
```

The `settings.json` file is located at:

- **Linux:** `~/.config/Code/User/settings.json`
- **macOS:** `~/Library/Application Support/Code/User/settings.json`
- **Windows:** `%APPDATA%\Code\User\settings.json`

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ossirytk](https://github.com/ossirytk)
- **Source:** [ossirytk/toolpilot](https://github.com/ossirytk/toolpilot)
- **License:** Unlicense

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ossirytk-toolpilot
- Seller: https://agentstack.voostack.com/s/ossirytk
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.