📦
Veil
Veil is an MCP-first retrieval toolkit for coding agents.
0 installs
Trust: 37 — Low
Ai
Ask AI about Veil
Powered by Claude · Grounded in docs
I know everything about Veil. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Veil Agent Toolkit
Veil is an MCP-first retrieval toolkit for coding agents.
It provides one compact tool surface for local code retrieval, git context, web context, and GitHub context.
Setup
Run MCP server
npx -y @ushiradineth/veil@latest
Install MCP skill
npx -y skills add https://github.com/ushiradineth/veil --skill veil
MCP client configuration
Codex
codex mcp add veil -- npx -y @ushiradineth/veil@latest
Claude Code
claude mcp add --scope user veil -- npx -y @ushiradineth/veil@latest
OpenCode
Add to ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"veil": {
"type": "local",
"command": ["npx", "-y", "@ushiradineth/veil@latest"]
}
}
}
Capabilities
| Capability | MCP tool |
|---|---|
| Index status | veil_status |
| MCP and skill update check | veil_update_check |
| Incremental refresh | veil_refresh |
| Full rebuild | veil_build |
| Discover files/symbols/chunks | veil_discover |
| Fetch one chunk by id | veil_chunk |
| Intent-aware lookup | veil_lookup |
| File path retrieval | veil_files |
| Symbol retrieval | veil_symbols |
| Content search | veil_search |
| Grammar list/install/remove/update | veil_grammar_list, veil_grammar_install, veil_grammar_remove, veil_grammar_update |
| Grammar recommendation/install plan | veil_grammar_recommend |
| Grammar runtime package install | veil_grammar_runtime_install |
| Web search | veil_web_search |
| URL fetch | veil_fetch_url |
| Git status/log/diff/show | veil_git_status, veil_git_log, veil_git_diff, veil_git_show |
| GitHub context lookup | veil_gh_lookup |
| Diagnostics | veil_diagnostics |
Optional parser runtimes
- Core defaults stay minimal:
javascript,typescript,json. - Additional languages are optional and install only after explicit user approval via
veil_grammar_runtime_install. - Common optional coverage includes:
nix,elixir,zig,go,rustc,cpp,c-sharpmarkdownjava,php,ruby,lua,kotlin,swift
Runtime install reuse semantics
- Parser enable or install state is persisted in
<state_root>/grammars.json(default state root:.veil). - Runtime packages are installed into
<state_root>/grammars-runtimefor that workspace. - Separate MCP server instances reuse the same runtime install location when they target the same workspace and state root.
- Fallback policy is strict for known installable parsers: global fallback is only allowed when runtime install is
recorded as failed (
runtime_install_failed) or when no known runtime package mapping exists.
Note
Veil is still experimental and under active development. Please report any issues or suggestions.
