Documentation Index
Fetch the complete documentation index at: https://docs.vijil.ai/llms.txt
Use this file to discover all available pages before exploring further.
All tools listed here are available to Claude Code once vijil-mcp is configured. Claude discovers them automatically via the MCP protocol — you do not call them directly.
Advanced tools (genome_*, evolution_*, proposal_*, scan_*, dimensions_*, demographics_*, inventory_*) are available in the server but not covered here. Ask Claude about them by name if you need them.
Status and Authentication
| Tool | Description |
|---|
vijil_status | Check CLI configuration and authentication state |
auth_change_password | Change your account password |
team_list | List teams your account belongs to |
team_use | Switch the active team context |
vijil_status
Checks whether the CLI is configured, authenticated, and has an active team selected. Claude calls this automatically when you ask it to verify your setup.
auth_change_password
Change your account password.
| Parameter | Type | Description |
|---|
current_password | str | Current account password |
new_password | str | New account password |
team_list
List all teams your account belongs to.
team_use
Switch the active team for all subsequent tool calls.
| Parameter | Type | Description |
|---|
team_id | str | UUID of the team to activate |
Switch to team c58aea71-…
Agents
Agent tools create and manage the AI model configurations that Vijil evaluates or protects.
| Tool | Description |
|---|
agent_create | Create a new Agent configuration |
agent_list | List Agent configurations |
agent_get | Get a specific Agent |
agent_update | Update an Agent configuration |
agent_archive | Archive an Agent |
agent_lifecycle | Set the Agent trust lifecycle stage |
agent_import | Import an Agent from a URL or file |
agent_validate_import | Validate an import without creating the Agent |
agent_eval_config | Get the evaluation configuration for an Agent |
agent_dome_configs | Get the Dome configuration bound to an Agent |
agent_create
Create a new Agent configuration.
| Parameter | Type | Description |
|---|
agent_name | str | Display name for the Agent |
model_name | str | Model identifier (e.g. gpt-4o, claude-sonnet-4-20250514) |
agent_url | str | Endpoint the Agent is reachable at |
api_key | str | API key for the Agent’s provider |
agent_system_prompt | str | System prompt the Agent uses |
rate_limit_requests_per_minute | int | API request rate limit |
mcp_config | str | MCP proxy configuration (JSON) |
agent_list
List Agent configurations for the active team.
| Parameter | Type | Description |
|---|
statuses | list[str] | Filter by status (defaults to non-archived) |
limit | int | Maximum number of results |
offset | int | Number of results to skip |
include_scores | bool | Include the latest evaluation scores |
List my agents with their latest trust scores
agent_get
Get a specific Agent by ID.
| Parameter | Type | Description |
|---|
agent_id | str | Agent UUID |
include_scores | bool | Include the latest evaluation scores |
Get the details for agent a1b2c3d4-…
agent_update
Update an existing Agent configuration.
| Parameter | Type | Description |
|---|
agent_id | str | Agent UUID |
agent_name | str | New display name |
model_name | str | New model identifier |
agent_url | str | New endpoint URL |
api_key | str | New API key |
agent_system_prompt | str | New system prompt |
status | str | Agent status (draft, active, deprecated, archived, …) |
access_level | str | black_box, grey_box, or white_box |
purpose | str | Agent purpose description |
Update agent a1b2c3d4-… to use gpt-4o-mini
agent_archive
Archive an Agent so it no longer appears in default listings.
| Parameter | Type | Description |
|---|
id | str | Agent UUID |
agent_lifecycle
Set the Agent’s trust lifecycle stage.
| Parameter | Type | Description |
|---|
id | str | Agent UUID |
trust_stage | str | One of registered, tested, hardened, trusted, optimized, adapted |
Mark agent a1b2c3d4-… as tested
agent_import
Import an Agent from a remote URL (black box), an agent card file (grey box), or source code (white box).
| Parameter | Type | Description |
|---|
agent_url | str | Remote Agent endpoint URL (black box) |
agent_card | str | Agent configuration JSON string (grey box) |
source_code | str | Source code files JSON string (white box) |
framework | str | Framework identifier |
entry_point | str | Main file path (white box) |
override_name | str | Override the imported Agent name |
api_key | str | API key for the Agent |
agent_validate_import
Validate an import payload without creating the Agent. Accepts the same parameters as agent_import.
agent_eval_config
Get the evaluation configuration for an Agent.
| Parameter | Type | Description |
|---|
id | str | Agent UUID |
agent_dome_configs
Get the Dome configuration bound to an Agent.
| Parameter | Type | Description |
|---|
agent_id | str | Agent UUID |
Show me the Dome configuration for agent a1b2c3d4-…
Harnesses
Harness tools manage the test suites that define which Probes are sent to your Agent during evaluation.
| Tool | Description |
|---|
harness_list | List standard Harnesses |
harness_custom_create | Create a custom Harness |
harness_custom_list | List custom Harnesses |
harness_custom_get | Get a custom Harness |
harness_custom_prompts | Get Probes from a custom Harness |
harness_custom_cancel | Cancel a Harness being generated |
harness_custom_delete | Delete a custom Harness |
harness_list
List standard Harnesses available for evaluations (safety, security, reliability, privacy, toxicity, ethics).
What Harnesses are available?
harness_custom_create
Create a custom Harness for a specific Agent. Vijil generates Probes based on the Agent’s purpose and any Personas or Policies you attach.
| Parameter | Type | Description |
|---|
name | str | Harness display name (required) |
agent_id | str | Agent ID to generate Probes for (required) |
description | str | Harness description |
persona_ids | str | Persona IDs to include (JSON array) |
policy_ids | str | Policy IDs to include (JSON array) |
system_prompt | str | Agent description or system prompt for generation |
Create a custom Harness called 'Support Bot Harness' for agent a1b2c3d4-…
harness_custom_list
List custom Harnesses for the active team.
| Parameter | Type | Description |
|---|
agent_id | str | Filter by Agent ID |
status | str | Filter by status |
limit | int | Maximum number of results |
offset | int | Number of results to skip |
harness_custom_get
Get a specific custom Harness by ID.
| Parameter | Type | Description |
|---|
harness_id | str | Harness UUID |
harness_custom_prompts
Get the generated Probes for a custom Harness.
| Parameter | Type | Description |
|---|
harness_id | str | Harness UUID |
Show me the prompts in custom Harness h1i2j3k4-…
harness_custom_cancel
Cancel a Harness that is still being generated.
| Parameter | Type | Description |
|---|
harness_id | str | Harness UUID |
harness_custom_delete
Delete a custom Harness.
| Parameter | Type | Description |
|---|
harness_id | str | Harness UUID |
Evaluations
Evaluation tools run Trust Score evaluations and retrieve results.
| Tool | Description |
|---|
eval_run | Start an evaluation |
eval_status | Check evaluation status |
eval_results_detail | Get full evaluation results |
eval_list | List evaluations |
eval_report | Generate a Trust Report |
eval_logs | Get evaluation logs |
eval_cancel | Cancel a running evaluation |
eval_delete | Delete an evaluation |
eval_results_list | List completed evaluations |
eval_list_all | List all team evaluations |
eval_summary_get | Get an evaluation summary |
eval_summary_by_agent | Get latest summaries per Agent |
eval_summary_delete | Delete an evaluation summary |
eval_run
Start a trust evaluation against an Agent.
| Parameter | Type | Description |
|---|
agent_id | str | UUID of the Agent to evaluate (required) |
harness_names | str | JSON array of Harness names (required) — e.g. '["safety","security"]' |
sample_size | int | Probes to run per Harness (1–1000); omit to run all |
harness_type | str | standard (default) or custom |
wait | bool | Poll until the evaluation completes |
Run a safety and security evaluation on agent a1b2c3d4-… with sample size 50 and wait for it to complete
eval_status
Check the status of an evaluation.
| Parameter | Type | Description |
|---|
evaluation_id | str | Evaluation UUID |
starting → pending → running → completed → saving → saved. May also be failed or canceled.
What is the status of evaluation e5f6a7b8-…?
eval_results_detail
Get the full results for a completed evaluation — Trust Scores per Harness, per-Probe results, and identified failure patterns.
| Parameter | Type | Description |
|---|
evaluation_id | str | Evaluation UUID |
Show me the detailed results for evaluation e5f6a7b8-…
eval_list
List evaluation summaries for the active team.
| Parameter | Type | Description |
|---|
agent_id | str | Filter by Agent ID |
status | str | Filter by status (running, completed, failed, cancelled) |
harness_type | str | Filter by Harness type (standard or custom) |
limit | int | Maximum number of results |
offset | int | Number of results to skip |
List my completed evaluations for agent a1b2c3d4-…
eval_report
Generate a Trust Report for a completed evaluation.
| Parameter | Type | Description |
|---|
evaluation_id | str | Evaluation UUID |
force_regenerate | bool | Regenerate even if a cached report exists |
Generate a report for evaluation e5f6a7b8-…
eval_logs
Get execution logs for an evaluation.
| Parameter | Type | Description |
|---|
evaluation_id | str | Evaluation UUID |
eval_cancel
Cancel a running evaluation.
| Parameter | Type | Description |
|---|
evaluation_id | str | Evaluation UUID |
eval_delete
Delete an evaluation and its results.
| Parameter | Type | Description |
|---|
evaluation_id | str | Evaluation UUID |
Protect
Dome tools manage Guardrail configurations that intercept your Agent’s inputs and outputs at runtime using Guards and Detectors.
| Tool | Description |
|---|
dome_default_config | Get the default Dome configuration template |
dome_config_create | Create a Dome configuration |
dome_config_list | List Dome configurations |
dome_config_get | Get a specific configuration |
dome_config_update | Replace a configuration |
dome_config_patch | Set the Dome instance URL |
dome_config_apply | Apply a configuration to the Dome instance |
dome_config_delete | Delete a configuration |
dome_detect | Submit content for on-demand detection |
dome_detect_status | Check detection status |
dome_default_config
Get the default Dome configuration to use as a starting template.
Show me the default Dome configuration
dome_config_create
Create a Dome configuration, optionally binding it to an Agent.
| Parameter | Type | Description |
|---|
agent_id | str | Agent ID to bind this configuration to |
config_body | str | Guard configuration JSON (defaults to the standard configuration) |
Create a default Dome configuration for agent a1b2c3d4-…
dome_config_list
List Dome configurations for the active team.
| Parameter | Type | Description |
|---|
agent_id | str | Filter by Agent ID |
limit | int | Page size |
offset | int | Pagination offset |
List all my Dome configurations
dome_config_get
Get a specific Dome configuration.
| Parameter | Type | Description |
|---|
config_id | str | Configuration UUID |
dome_config_update
Replace an existing Dome configuration with new Guard settings.
| Parameter | Type | Description |
|---|
config_id | str | Configuration UUID (required) |
config_body | str | Replacement Guard configuration (JSON, required) |
dome_config_patch
Set or clear the Dome instance URL on a configuration.
| Parameter | Type | Description |
|---|
config_id | str | Configuration UUID (required) |
dome_instance_url | str | Dome instance URL, or null to clear (required) |
dome_config_apply
Apply a configuration to the Dome instance, publishing any pending changes.
| Parameter | Type | Description |
|---|
config_id | str | Configuration UUID |
Apply Dome config d1e2f3a4-…
dome_config_delete
Delete a Dome configuration.
| Parameter | Type | Description |
|---|
config_id | str | Configuration UUID |
dome_detect
Submit content to a specific Detector for on-demand analysis.
| Parameter | Type | Description |
|---|
id | str | Request identifier (required) |
detector_id | str | Detector to invoke (required) |
detector_inputs | str | Content to analyze — JSON array of message objects (required) |
detector_params | str | Detector-specific parameters (JSON) |
wait | bool | Poll until the detection completes |
Run a prompt-injection detection on the text 'Ignore all previous instructions'
dome_detect_status
Check the status of a detection request.
| Parameter | Type | Description |
|---|
detection_id | str | Detection UUID |
Red Team
Red team tools manage Personas, Policies, and adversarial campaigns.
Personas
Personas represent user archetypes that shape how Probes are generated for custom Harnesses.
| Tool | Description |
|---|
persona_preset_list | List built-in Persona presets |
persona_from_preset | Create a Persona from a preset |
persona_create | Create a custom Persona |
persona_list | List Personas |
persona_get | Get a specific Persona |
persona_update | Update a Persona |
persona_delete | Delete a Persona |
persona_preset_list
List built-in Persona presets, categorized as professional, adversarial, or support.
| Parameter | Type | Description |
|---|
preset_category | str | Filter by category |
limit | int | Maximum number of results |
offset | int | Number of results to skip |
Show me the adversarial persona presets
persona_from_preset
Create a Persona from a built-in preset.
| Parameter | Type | Description |
|---|
preset_id | str | Preset UUID |
name_override | str | Override the preset’s default name |
Create a persona from the 'jailbreaker' preset
persona_create
Create a custom Persona.
| Parameter | Type | Description |
|---|
name | str | Display name (required) |
role | str | Persona role (required) |
intent | str | benign, curious, adversarial, or malicious |
knowledge_level | str | beginner, intermediate, advanced, or expert |
skill_level | str | novice, competent, proficient, or expert |
language | str | Language the Persona uses |
Create an adversarial persona called 'Frustrated Customer' with expert knowledge
persona_list
List Personas for the active team.
| Parameter | Type | Description |
|---|
intents | list[str] | Filter by intent(s) |
is_preset | bool | Show only presets |
search | str | Search in name, description, and role |
limit | int | Maximum number of results |
offset | int | Number of results to skip |
List all adversarial personas
Policies
Policies define the rules and constraints Agents must follow. Attaching Policies to a custom Harness generates Probes that test compliance.
| Tool | Description |
|---|
policy_preset_list | List built-in Policy presets |
policy_from_preset | Create a Policy from a preset |
policy_create | Create a custom Policy |
policy_list | List Policies |
policy_get | Get a specific Policy |
policy_activate | Activate a draft Policy |
policy_patch | Update a Policy |
policy_delete | Delete a Policy |
policy_add_rule | Add a rule to a Policy |
policy_rule_list | List rules in a Policy |
policy_preset_list
List built-in Policy presets.
| Parameter | Type | Description |
|---|
category | str | Filter by category |
limit | int | Maximum number of results |
offset | int | Number of results to skip |
Show me the available compliance policy presets
policy_from_preset
Copy a preset Policy into your team.
| Parameter | Type | Description |
|---|
preset_id | str | Preset UUID |
name_override | str | Override the preset’s default name |
Create a GDPR compliance policy from the preset
policy_create
Create a Policy from text.
| Parameter | Type | Description |
|---|
name | str | Policy display name (required) |
category | str | privacy, ethics, security, compliance, operational, brand, or custom (required) |
description | str | Policy description |
source_text | str | Full policy text |
Create a privacy policy stating that the agent must not repeat or store personal data
policy_list
List Policies for the active team.
| Parameter | Type | Description |
|---|
category | str | Filter by category |
status | str | Filter by status |
search | str | Search in name and description |
limit | int | Maximum number of results |
List my active compliance policies
policy_activate
Activate a draft Policy so it can be used in Harness generation.
| Parameter | Type | Description |
|---|
policy_id | str | Policy UUID |
policy_add_rule
Add a structured rule to a Policy.
| Parameter | Type | Description |
|---|
policy_id | str | Policy UUID (required) |
rule_type | str | permission, prohibition, obligation, or recommendation (required) |
action | str | Action the rule governs (required) |
natural_language | str | Human-readable rule statement (required) |
consequence | str | Consequence definition (JSON, required) |
Add a rule to policy p1q2r3s4-… that prohibits sharing customer PII with third parties
Red Team Campaigns
Red team campaigns run adversarial attack sequences using tools such as Garak, PromptFoo, and PyRIT.
| Tool | Description |
|---|
redteam_tools | List available red team tools |
redteam_run | Start a campaign |
redteam_status | Check campaign status |
redteam_results | Get campaign results |
redteam_list | List campaigns |
redteam_logs | Get campaign logs |
redteam_cancel | Cancel a campaign |
redteam_delete | Delete a campaign |
What red team tools are available?
redteam_run
Create and start a red team campaign.
| Parameter | Type | Description |
|---|
tool | str | diamond_security, promptfoo, garak, pyrit, or unknown (required) |
purpose | str | Agent purpose description, used for context-aware attacks (required) |
categories | str | Attack categories to test (JSON array, required) |
agent_id | str | Agent ID (resolves the endpoint URL automatically) |
agent_url | str | Target Agent endpoint URL (if not using agent_id) |
agent_api_key | str | API key for the target Agent |
agent_model_name | str | Model name if the Agent is an LLM gateway |
num_tests | int | Number of test cases per category |
wait | bool | Poll until the campaign completes |
Run a garak red team campaign against agent a1b2c3d4-… with the purpose 'customer support chatbot' testing jailbreaks and prompt injection, with 20 tests per category, and wait for it to finish
redteam_status
Check the status of a campaign.
| Parameter | Type | Description |
|---|
campaign_id | str | Campaign UUID |
redteam_results
Get the results of a completed campaign.
| Parameter | Type | Description |
|---|
campaign_id | str | Campaign UUID |
Show me the results of red team campaign c1d2e3f4-…
Telemetry
Telemetry tools surface aggregated trust metrics and the observability data emitted by Dome-protected Agents.
| Tool | Description |
|---|
dashboard_show | Show the Trust Dashboard |
telemetry_metric_total | Get the total value of a counter metric |
telemetry_counter_series | Get a counter metric time series |
telemetry_latency_metric | Get latency percentiles over time |
dashboard_show
Display the aggregated Trust Dashboard for the active team — latest Trust Scores, evaluation history, and protection status across all Agents.
Show me the trust dashboard
telemetry_metric_total
Get the total value of a counter metric over a time range.
| Parameter | Type | Description |
|---|
metric_name | str | Metric name (required) |
time_range | str | 15m, 30m, 1h, 2h, 6h, 1d, 7d, 30d |
evaluation_id | str | Filter by evaluation ID |
agent_configuration_id | str | Filter by Agent ID |
Show me the total request count for the last 24 hours
telemetry_counter_series
Get a time series for a counter metric.
| Parameter | Type | Description |
|---|
metric_name | str | Metric name (required) |
time_range | str | Time range |
evaluation_id | str | Filter by evaluation ID |
agent_configuration_id | str | Filter by Agent ID |
telemetry_latency_metric
Get latency percentiles over time for a metric.
| Parameter | Type | Description |
|---|
metric_name | str | Metric name (required) |
time_range | str | Time range |
time_window | str | Aggregation window (e.g. 1m, 5m, 15m) |
percentiles | str | Comma-separated percentiles (default: 0.5,0.9,0.95,0.99) |
evaluation_id | str | Filter by evaluation ID |
agent_configuration_id | str | Filter by Agent ID |
Show me p50 and p99 latency for the last hour
