VAIL Agent Assurance — Claude Code MCP server: setup
The VAIL Agent Assurance MCP server for Claude Code scans agent instructions and tools for behavior risks. It creates probes to test what the scan finds.
no license ★ 1 updated 2026-11-14
claude mcp add --transport http agent-assurance https://agents.projectvail.com/mcpWhat VAIL Agent Assurance does
VAIL Agent Assurance scans an agent’s source, sorts observed behaviors into risk categories, and generates probes for testing. Results appear in the editor. The agent-improvement skill can also run local tests and propose source changes, which require approval one by one.
Connecting requires a VAIL account and browser sign-in to approve access; no API key is needed. Agent source is sent to VAIL when a scan or upload is requested. Local grading downloads vail-grading and installs it with pip in a separate virtual environment, along with pydantic and jsonpath-ng. Local test runs need shell access.
What it helps with
- spot behavior risks in an agent’s instructions and tools
- create probes to test identified risks
- run local tests against an agent’s behavior
- review proposed changes to an agent’s source
Example prompts for the agent
- Scan the agent in
./support-botand show me its behavior findings. - Create probes for the behavior risks found in my agent.
- Test the risks in
./support-botlocally and propose source changes.
How to install VAIL Agent Assurance
Platform CLI: remote server
claude mcp add --transport http agent-assurance https://agents.projectvail.com/mcpPlatform CLI: remote server
codex mcp add vail-agent-assurance --url https://agents.projectvail.com/mcpConfig file
{
"mcpServers": {
"vail-agent-assurance": {
"url": "https://agents.projectvail.com/mcp"
}
}
}Config file
{
"servers": {
"vail-agent-assurance": {
"type": "http",
"url": "https://agents.projectvail.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http vail-agent-assurance https://agents.projectvail.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about VAIL Agent Assurance
How do I install VAIL Agent Assurance in Claude Code?
Add the marketplace with claude mcp add --transport http agent-assurance https://agents.projectvail.com/mcp. Then add the server with claude mcp add --transport http vail-agent-assurance https://agents.projectvail.com/mcp.
What does VAIL Agent Assurance do?
It scans an AI agent’s source, groups observed behavior into risk categories, and creates probes to test it. Its agent-improvement skill can also test the agent locally and suggest source edits for approval.
What does VAIL Agent Assurance require?
A VAIL account and browser sign-in are needed to approve OAuth access. Local grading also needs shell access, pip, the vail-grading package, and its pydantic and jsonpath-ng dependencies.