Reference outils
Reference API complete pour les 59 outils MCP VaultTools : schemas d'entree, schemas de sortie et exemples.
Codes d'erreur
ACCESS_DENIED Le chemin est en dehors des repertoires autorises. FILE_NOT_FOUND Le fichier d'entree n'existe pas au chemin indique. READ_ERROR Le fichier n'a pas pu etre lu (permissions, encodage). WRITE_ERROR Le fichier de sortie n'a pas pu etre ecrit (permissions, disque plein). INVALID_INPUT Le contenu du fichier est mal forme ou non pris en charge. PROCESSING_ERROR L'outil a rencontre une erreur pendant le traitement. INVALID_PARAMS Des parametres requis sont manquants ou invalides. CONFIG_ERROR La configuration du serveur est invalide (ex. : pas de repertoire de sortie). Aucun outil ne correspond a votre recherche.
IMAGE
vaulttools_image_convert
Convert image format (PNG, JPEG, WebP, BMP, TIFF, AVIF). File bytes never enter AI context.
Entree
output_format string Output format: png, jpeg, webp, bmp, tiff, avif.
path string Path to the input image file.
quality integernull Quality 1-100 (default 85). Applies to JPEG, WebP, AVIF.
Sortie
output_format string output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/photo.png",
"output_format": "jpeg"
}{
"output_path": "~/Documents/photo_converted.jpeg",
"output_format": "jpeg",
"output_size": "284.5 KB"
}Exemple realiste
{
"path": "~/Documents/photo.png",
"output_format": "webp",
"quality": 80
}{
"output_path": "~/Documents/photo_converted.webp",
"output_format": "webp",
"output_size": "142.3 KB"
}vaulttools_image_compress
Compress an image by re-encoding at a lower quality. Returns savings percentage.
Entree
path string Path to the input image file.
quality integernull Quality 1-100 (default 75).
Sortie
compressed_size string compressed_size_bytes integer original_size string original_size_bytes integer output_path string savings_percent number Exemple minimal
{
"path": "~/Documents/banner.jpg"
}{
"output_path": "~/Documents/banner_compressed.jpg",
"original_size": "2.4 MB",
"compressed_size": "680.1 KB",
"savings_percent": 72.3
}Exemple realiste
{
"path": "~/Documents/banner.jpg",
"quality": 60
}{
"output_path": "~/Documents/banner_compressed.jpg",
"original_size": "2.4 MB",
"compressed_size": "412.8 KB",
"savings_percent": 83.2
}vaulttools_image_resize
Resize an image to target width/height. Maintains aspect ratio by default.
Entree
height integer Target height in pixels.
maintain_aspect booleannull Whether to maintain aspect ratio (default true). When true, the image fits within width x height.
path string Path to the input image file.
quality integernull Quality 1-100 (default 85).
width integer Target width in pixels.
Sortie
height integer output_path string output_size string output_size_bytes integer width integer Exemple minimal
{
"path": "~/Documents/photo.jpg",
"width": 800,
"height": 600
}{
"output_path": "~/Documents/photo_resized.jpg",
"output_size": "124.6 KB",
"width": 800,
"height": 600
}Exemple realiste
{
"path": "~/Documents/photo.jpg",
"width": 1200,
"height": 630,
"maintain_aspect": true,
"quality": 90
}{
"output_path": "~/Documents/photo_resized.jpg",
"output_size": "198.4 KB",
"width": 1200,
"height": 630
}vaulttools_image_info
Get image metadata: format, dimensions, file size. No output file produced.
Entree
path string Path to the input image file.
Sortie
file_size string file_size_bytes integer format string height integer width integer Exemple minimal
{
"path": "~/Documents/photo.jpg"
}{
"format": "jpeg",
"width": 3024,
"height": 4032,
"file_size": "3.8 MB"
}Exemple realiste
{
"path": "~/Documents/screenshot.png"
}{
"format": "png",
"width": 2560,
"height": 1440,
"file_size": "1.2 MB"
}vaulttools_image_exif_read
Read EXIF metadata from a JPEG or TIFF image. Returns tags and values.
Entree
path string Path to the input image file (JPEG or TIFF).
Sortie
exif_data any[] Array of EXIF tag/value pairs.
field_count integer Exemple minimal
{
"path": "~/Documents/photo.jpg"
}{
"exif_data": "[{\"tag\":\"Make\",\"value\":\"Apple\"},{\"tag\":\"Model\",\"value\":\"iPhone 15 Pro\"},{\"tag\":\"DateTime\",\"value\":\"2025:12:15 14:32:01\"}]",
"field_count": 24
}Exemple realiste
{
"path": "~/Documents/vacation/sunset.jpg"
}{
"exif_data": "[{\"tag\":\"Make\",\"value\":\"Canon\"},{\"tag\":\"Model\",\"value\":\"EOS R5\"},{\"tag\":\"ExposureTime\",\"value\":\"1/250\"},{\"tag\":\"FNumber\",\"value\":\"f/2.8\"},{\"tag\":\"ISOSpeedRatings\",\"value\":\"400\"},{\"tag\":\"GPSLatitude\",\"value\":\"48.8566\"}]",
"field_count": 42
}vaulttools_image_exif_strip
Strip all EXIF metadata from an image by re-encoding it.
Entree
path string Path to the input image file.
quality integernull Re-encoding quality 1-100 (default 90).
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/photo.jpg"
}{
"output_path": "~/Documents/photo_no_exif.jpg",
"output_size": "3.6 MB"
}Exemple realiste
{
"path": "~/Documents/photo.jpg",
"quality": 85
}{
"output_path": "~/Documents/photo_no_exif.jpg",
"output_size": "2.1 MB"
}vaulttools_image_favicon
Generate a complete favicon package (ICO + PNG sizes + webmanifest) as a ZIP file.
Entree
background stringnull Background color: "transparent" or "#RRGGBB" (default "transparent").
fit_mode stringnull Fit mode: "contain" or "cover" (default "contain").
path string Path to the input image file (ideally square, >= 512x512).
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/logo.png"
}{
"output_path": "~/Documents/logo_favicons.zip",
"output_size": "48.2 KB"
}Exemple realiste
{
"path": "~/Documents/logo.png",
"fit_mode": "cover",
"background": "#ffffff"
}{
"output_path": "~/Documents/logo_favicons.zip",
"output_size": "52.7 KB"
}vaulttools_image_mockup
Apply a device mockup frame (simple, browser, phone) around a screenshot image.
Entree
background stringnull Background color: "transparent" or "#RRGGBB" (default "#0F172A").
corner_radius integernull Corner radius in pixels.
output_format stringnull Output format: png, jpeg, webp, avif (default "png").
path string Path to the input image file (screenshot).
preset stringnull Preset: "simple", "browser", or "phone" (default "simple").
quality integernull Quality 1-100 (default 90).
shadow_blur numbernull Shadow blur sigma.
shadow_opacity numbernull Shadow opacity 0.0-1.0.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/screenshot.png"
}{
"output_path": "~/Documents/screenshot_mockup.png",
"output_size": "892.4 KB"
}Exemple realiste
{
"path": "~/Documents/screenshot.png",
"preset": "browser",
"background": "#1a1a2e",
"corner_radius": 12,
"shadow_blur": 20,
"shadow_opacity": 0.5,
"output_format": "png",
"quality": 95
}{
"output_path": "~/Documents/screenshot_mockup.png",
"output_size": "1.1 MB"
}vaulttools_image_palette
Extract a color palette from an image. Returns hex codes, RGB values, and percentages.
Entree
count integernull Number of colors to extract (2-12, default 6).
path string Path to the input image file.
Sortie
color_count integer palette any[] Array of extracted palette colors with hex, RGB, and percentage.
Exemple minimal
{
"path": "~/Documents/photo.jpg"
}{
"palette": "[{\"hex\":\"#2c3e50\",\"rgb\":\"44,62,80\",\"percentage\":28.4},{\"hex\":\"#e74c3c\",\"rgb\":\"231,76,60\",\"percentage\":18.1},{\"hex\":\"#ecf0f1\",\"rgb\":\"236,240,241\",\"percentage\":15.6}]",
"color_count": 6
}Exemple realiste
{
"path": "~/Documents/brand-photo.jpg",
"count": 4
}{
"palette": "[{\"hex\":\"#1a1a2e\",\"rgb\":\"26,26,46\",\"percentage\":35.2},{\"hex\":\"#16213e\",\"rgb\":\"22,33,62\",\"percentage\":24.8},{\"hex\":\"#0f3460\",\"rgb\":\"15,52,96\",\"percentage\":22.1},{\"hex\":\"#e94560\",\"rgb\":\"233,69,96\",\"percentage\":17.9}]",
"color_count": 4
}vaulttools_image_svg_to_png
Rasterize an SVG file to PNG at a specified size.
Entree
background stringnull Background: "transparent" or "#RRGGBB" (default "transparent").
fit stringnull Fit mode: "contain", "cover", or "stretch" (default "contain").
height integernull Output height in pixels (default: intrinsic SVG height).
path string Path to the input SVG file.
width integernull Output width in pixels (default: intrinsic SVG width).
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/icon.svg"
}{
"output_path": "~/Documents/icon_rasterized.png",
"output_size": "14.8 KB"
}Exemple realiste
{
"path": "~/Documents/icon.svg",
"width": 1024,
"height": 1024,
"fit": "contain",
"background": "transparent"
}{
"output_path": "~/Documents/icon_rasterized.png",
"output_size": "38.2 KB"
}vaulttools_image_transform
Transform an image: crop, rotate (0/90/180/270), flip horizontal/vertical.
Entree
crop Crop rectangle: {x, y, width, height}. Applied before rotate/flip.
flip_horizontal booleannull Flip horizontally.
flip_vertical booleannull Flip vertically.
output_format stringnull Output format (default: same as input). One of: png, jpeg, webp, bmp, tiff, avif, keep.
path string Path to the input image file.
quality integernull Quality 1-100 (default 85).
rotate integernull Rotation in degrees: 0, 90, 180, 270.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/photo.jpg"
}{
"output_path": "~/Documents/photo_transformed.jpg",
"output_size": "3.8 MB"
}Exemple realiste
{
"path": "~/Documents/photo.jpg",
"crop": {
"x": 100,
"y": 50,
"width": 800,
"height": 600
},
"rotate": 90,
"flip_horizontal": false,
"flip_vertical": false,
"output_format": "png",
"quality": 90
}{
"output_path": "~/Documents/photo_transformed.png",
"output_size": "1.4 MB"
}vaulttools_image_watermark
Add a text watermark to an image. Supports single position or tiled pattern.
Entree
angle numbernull Rotation angle in degrees (default 0, or -30 for tiled).
color stringnull Text color in #RRGGBB (default "#888888").
font_size integernull Font size in pixels (default 48).
opacity numbernull Opacity 0.0-1.0 (default 0.3).
output_format stringnull Output format (default: same as input).
path string Path to the input image file.
position stringnull Position: "center", "top-left", "top-right", "bottom-left", "bottom-right", "tiled" (default "center").
quality integernull Quality 1-100 (default 90).
text string Watermark text.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/photo.jpg",
"text": "DRAFT"
}{
"output_path": "~/Documents/photo_watermarked.jpg",
"output_size": "3.9 MB"
}Exemple realiste
{
"path": "~/Documents/photo.jpg",
"text": "CONFIDENTIAL",
"position": "tiled",
"font_size": 36,
"color": "#ff0000",
"opacity": 0.15,
"angle": -30,
"output_format": "png",
"quality": 90
}{
"output_path": "~/Documents/photo_watermarked.png",
"output_size": "4.2 MB"
}vaulttools_image_to_base64
Convert an image file to a base64 data URI string. Writes result to a .txt file.
Entree
path string Path to the input image file.
Sortie
data_uri_length integer output_path string Exemple minimal
{
"path": "~/Documents/icon.png"
}{
"output_path": "~/Documents/icon_base64.txt",
"data_uri_length": 8432
}Exemple realiste
{
"path": "~/Documents/avatar.jpg"
}{
"output_path": "~/Documents/avatar_base64.txt",
"data_uri_length": 24680
}vaulttools_image_from_base64
Convert a base64 data URI string back to an image file.
Entree
data_uri string Base64 data URI string (e.g. "data:image/png;base64,...").
output_filename string Output file name (e.g. "restored.png"). Written to first allowed directory or output directory.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"data_uri": "data:image/png;base64,iVBORw0KGgo...",
"output_filename": "restored.png"
}{
"output_path": "~/Documents/restored.png",
"output_size": "6.2 KB"
}Exemple realiste
{
"data_uri": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"output_filename": "decoded-photo.jpg"
}{
"output_path": "~/Documents/decoded-photo.jpg",
"output_size": "18.4 KB"
}vaulttools_pdf_merge
Merge multiple PDF files into one. File bytes never enter AI context.
Entree
paths string[] Paths to the PDF files to merge, in order.
Sortie
output_path string output_size string output_size_bytes integer page_count integer Exemple minimal
{
"paths": [
"~/Documents/part1.pdf",
"~/Documents/part2.pdf"
]
}{
"output_path": "~/Documents/part1_merged.pdf",
"output_size": "2.8 MB",
"page_count": 24
}Exemple realiste
{
"paths": [
"~/Documents/report/cover.pdf",
"~/Documents/report/chapter1.pdf",
"~/Documents/report/chapter2.pdf",
"~/Documents/report/appendix.pdf"
]
}{
"output_path": "~/Documents/report/cover_merged.pdf",
"output_size": "8.4 MB",
"page_count": 67
}vaulttools_pdf_split
Extract a page range from a PDF into a new file.
Entree
end_page integer Last page to extract (1-based, inclusive).
path string Path to the input PDF file.
start_page integer First page to extract (1-based).
Sortie
output_path string output_size string output_size_bytes integer page_count integer Exemple minimal
{
"path": "~/Documents/report.pdf",
"start_page": 1,
"end_page": 5
}{
"output_path": "~/Documents/report_p1-5.pdf",
"output_size": "420.3 KB",
"page_count": 5
}Exemple realiste
{
"path": "~/Documents/manual.pdf",
"start_page": 12,
"end_page": 18
}{
"output_path": "~/Documents/manual_p12-18.pdf",
"output_size": "1.1 MB",
"page_count": 7
}vaulttools_pdf_compress
Compress a PDF to reduce file size.
Entree
max_dimension integernull Max dimension for embedded images in pixels (default 2048).
path string Path to the input PDF file.
quality integernull Image compression quality 1-95 (default 75).
strip_metadata booleannull Whether to strip document metadata (default false).
Sortie
compressed_size string compressed_size_bytes integer original_size string original_size_bytes integer output_path string savings_percent number Exemple minimal
{
"path": "~/Documents/report.pdf"
}{
"output_path": "~/Documents/report_compressed.pdf",
"original_size": "12.4 MB",
"compressed_size": "4.2 MB",
"savings_percent": 66.1
}Exemple realiste
{
"path": "~/Documents/report.pdf",
"quality": 60,
"max_dimension": 1024,
"strip_metadata": true
}{
"output_path": "~/Documents/report_compressed.pdf",
"original_size": "12.4 MB",
"compressed_size": "2.8 MB",
"savings_percent": 77.4
}vaulttools_pdf_page_count
Get the number of pages in a PDF. No output file produced.
Entree
path string Path to the input PDF file.
Sortie
file_size string file_size_bytes integer page_count integer Exemple minimal
{
"path": "~/Documents/report.pdf"
}{
"page_count": 42,
"file_size": "3.6 MB"
}Exemple realiste
{
"path": "~/Documents/thesis.pdf"
}{
"page_count": 186,
"file_size": "28.4 MB"
}vaulttools_pdf_metadata_read
Read PDF metadata (title, author, subject, etc). No output file produced.
Entree
path string Path to the input PDF file.
Sortie
metadata string JSON object with title, author, subject, keywords, creator, producer fields.
Exemple minimal
{
"path": "~/Documents/report.pdf"
}{
"metadata": "{\"title\":\"Annual Report 2025\",\"author\":\"Jane Smith\",\"subject\":\"\",\"keywords\":\"\",\"creator\":\"Microsoft Word\",\"producer\":\"macOS Quartz PDFContext\"}"
}Exemple realiste
{
"path": "~/Documents/contract.pdf"
}{
"metadata": "{\"title\":\"Service Agreement\",\"author\":\"Legal Department\",\"subject\":\"Professional Services Contract\",\"keywords\":\"contract, services, agreement\",\"creator\":\"Adobe InDesign 2025\",\"producer\":\"Adobe PDF Library 17.0\"}"
}vaulttools_pdf_metadata_write
Update PDF metadata fields (title, author, subject, keywords, creator).
Entree
author stringnull Document author. Omit to preserve current value. Empty string clears it.
creator stringnull Creator application name. Omit to preserve current value. Empty string clears it.
keywords stringnull Document keywords. Omit to preserve current value. Empty string clears it.
path string Path to the input PDF file.
subject stringnull Document subject. Omit to preserve current value. Empty string clears it.
title stringnull Document title. Omit to preserve current value. Empty string clears it.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/report.pdf",
"title": "Q4 Report"
}{
"output_path": "~/Documents/report_metadata.pdf",
"output_size": "3.6 MB"
}Exemple realiste
{
"path": "~/Documents/report.pdf",
"title": "Q4 Financial Report",
"author": "Finance Team",
"subject": "Quarterly Financial Summary",
"keywords": "finance, quarterly, 2025",
"creator": "VaultTools"
}{
"output_path": "~/Documents/report_metadata.pdf",
"output_size": "3.7 MB"
}vaulttools_pdf_rotate
Rotate PDF pages by specified degrees (90, 180, 270).
Entree
path string Path to the input PDF file.
rotations string Rotation map as JSON object: {"1": 90, "3": 180}. Keys are 1-based page numbers, values are degrees (90, 180, 270).
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/scan.pdf",
"rotations": "{\"1\": 90}"
}{
"output_path": "~/Documents/scan_rotated.pdf",
"output_size": "1.8 MB"
}Exemple realiste
{
"path": "~/Documents/scan.pdf",
"rotations": "{\"1\": 90, \"3\": 180, \"5\": 270}"
}{
"output_path": "~/Documents/scan_rotated.pdf",
"output_size": "1.8 MB"
}vaulttools_pdf_reorder
Reorder PDF pages in a custom order.
Entree
order string Comma-separated 1-based page numbers defining the new order, e.g. "3,1,2".
path string Path to the input PDF file.
Sortie
output_path string output_size string output_size_bytes integer page_count integer Exemple minimal
{
"path": "~/Documents/slides.pdf",
"order": "3,1,2"
}{
"output_path": "~/Documents/slides_reordered.pdf",
"output_size": "5.2 MB",
"page_count": 3
}Exemple realiste
{
"path": "~/Documents/presentation.pdf",
"order": "1,3,5,7,2,4,6"
}{
"output_path": "~/Documents/presentation_reordered.pdf",
"output_size": "8.1 MB",
"page_count": 7
}vaulttools_pdf_annotate
Add page numbers or watermark text to PDF pages.
Entree
add_page_numbers booleannull Add page numbers to each page.
add_watermark booleannull Add watermark text to each page.
margin numbernull Margin in points (default 22).
page_number_font_size numbernull Page number font size 6-48 (default 11).
page_number_position stringnull Page number position: "top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right" (default "bottom-center").
page_number_prefix stringnull Page number prefix string (default "").
path string Path to the input PDF file.
start_number integernull Page number starting number (default 1).
watermark_font_size numbernull Watermark font size 10-160 (default 42).
watermark_opacity numbernull Watermark opacity 0.05-1.0 (default 0.18).
watermark_text stringnull Watermark text (default "CONFIDENTIAL").
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/report.pdf",
"add_page_numbers": true
}{
"output_path": "~/Documents/report_annotated.pdf",
"output_size": "3.7 MB"
}Exemple realiste
{
"path": "~/Documents/report.pdf",
"add_page_numbers": true,
"add_watermark": true,
"watermark_text": "DRAFT",
"watermark_opacity": 0.12,
"watermark_font_size": 60,
"start_number": 1,
"page_number_prefix": "Page ",
"page_number_font_size": 10,
"page_number_position": "bottom-center",
"margin": 30
}{
"output_path": "~/Documents/report_annotated.pdf",
"output_size": "3.9 MB"
}vaulttools_pdf_images_to_pdf
Combine multiple images into a single PDF document.
Entree
page_size stringnull Page size: "a4", "letter", or "fit" (default "a4").
paths string[] Paths to image files to combine into a PDF, in order.
Sortie
output_path string output_size string output_size_bytes integer page_count integer Exemple minimal
{
"paths": [
"~/Documents/scan1.jpg",
"~/Documents/scan2.jpg"
]
}{
"output_path": "~/Documents/scan1_combined.pdf",
"output_size": "1.4 MB",
"page_count": 2
}Exemple realiste
{
"paths": [
"~/Documents/receipts/receipt1.jpg",
"~/Documents/receipts/receipt2.jpg",
"~/Documents/receipts/receipt3.png"
],
"page_size": "a4"
}{
"output_path": "~/Documents/receipts/receipt1_combined.pdf",
"output_size": "2.8 MB",
"page_count": 3
}vaulttools_pdf_to_images
Extract embedded PDF page images as individual image files. Vector-only or text-only pages may not produce output.
Entree
format stringnull Output image format: "png", "jpeg", "webp" (default "png").
max_dimension integernull Max dimension for output images in pixels (default 2048).
path string Path to the input PDF file.
quality integernull Image quality 1-100 (default 90). Applies to JPEG and WebP.
Sortie
output_dir string output_paths string[] page_count integer Exemple minimal
{
"path": "~/Documents/brochure.pdf"
}{
"output_dir": "~/Documents/brochure_pages",
"output_paths": [
"~/Documents/brochure_pages/page_0001.png",
"~/Documents/brochure_pages/page_0002.png",
"~/Documents/brochure_pages/page_0003.png",
"~/Documents/brochure_pages/page_0004.png"
],
"page_count": 4
}Exemple realiste
{
"path": "~/Documents/presentation.pdf",
"format": "jpeg",
"quality": 85,
"max_dimension": 1920
}{
"output_dir": "~/Documents/presentation_pages",
"output_paths": [
"~/Documents/presentation_pages/page_0001.jpeg",
"~/Documents/presentation_pages/page_0002.jpeg",
"~/Documents/presentation_pages/page_0003.jpeg"
],
"page_count": 3
}TEXT
vaulttools_text_json_format
Pretty-print a JSON file with configurable indentation.
Entree
indent integernull Indentation spaces (default 2).
path string Path to the input JSON file.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/data.json"
}{
"output_path": "~/Documents/data_formatted.json",
"output_size": "4.2 KB"
}Exemple realiste
{
"path": "~/Documents/config.json",
"indent": 4
}{
"output_path": "~/Documents/config_formatted.json",
"output_size": "6.8 KB"
}vaulttools_text_json_minify
Minify a JSON file by removing whitespace.
Entree
path string Path to the input JSON file.
Sortie
original_size string original_size_bytes integer output_path string output_size string output_size_bytes integer savings_percent number Exemple minimal
{
"path": "~/Documents/data.json"
}{
"output_path": "~/Documents/data_minified.json",
"output_size": "2.1 KB",
"original_size": "4.2 KB",
"savings_percent": 50
}Exemple realiste
{
"path": "~/Documents/api-response.json"
}{
"output_path": "~/Documents/api-response_minified.json",
"output_size": "18.4 KB",
"original_size": "32.6 KB",
"savings_percent": 43.6
}vaulttools_text_json_validate
Validate a JSON file. Returns validity status and error details. No output file.
Entree
path string Path to the input JSON file.
Sortie
details string "valid" if the JSON is well-formed, otherwise an error description.
file_size string file_size_bytes integer valid boolean Exemple minimal
{
"path": "~/Documents/data.json"
}{
"valid": true,
"details": "valid",
"file_size": "4.2 KB"
}Exemple realiste
{
"path": "~/Documents/broken.json"
}{
"valid": false,
"details": "expected value at line 12 column 5",
"file_size": "1.8 KB"
}vaulttools_text_base64_encode
Encode file contents to base64.
Entree
path string Path to the input file to encode.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/secret.txt"
}{
"output_path": "~/Documents/secret_base64.txt",
"output_size": "1.4 KB"
}Exemple realiste
{
"path": "~/Documents/credentials.txt"
}{
"output_path": "~/Documents/credentials_base64.txt",
"output_size": "684 B"
}vaulttools_text_base64_decode
Decode base64 content back to original text.
Entree
path string Path to the input file containing Base64-encoded text.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/encoded.txt"
}{
"output_path": "~/Documents/encoded_decoded.txt",
"output_size": "1.0 KB"
}Exemple realiste
{
"path": "~/Documents/payload_base64.txt"
}{
"output_path": "~/Documents/payload_base64_decoded.txt",
"output_size": "512 B"
}vaulttools_text_csv_to_json
Convert a CSV file to JSON format.
Entree
has_headers booleannull Whether the first row contains headers (default true).
path string Path to the input CSV file.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/data.csv"
}{
"output_path": "~/Documents/data_converted.json",
"output_size": "12.4 KB"
}Exemple realiste
{
"path": "~/Documents/sales-report.csv",
"has_headers": true
}{
"output_path": "~/Documents/sales-report_converted.json",
"output_size": "48.2 KB"
}vaulttools_text_json_to_csv
Convert a JSON array of objects to CSV format.
Entree
path string Path to the input JSON file (must contain an array of objects).
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/users.json"
}{
"output_path": "~/Documents/users_converted.csv",
"output_size": "8.6 KB"
}Exemple realiste
{
"path": "~/Documents/api-export.json"
}{
"output_path": "~/Documents/api-export_converted.csv",
"output_size": "34.1 KB"
}vaulttools_text_markdown_to_html
Render a Markdown file to HTML.
Entree
path string Path to the input Markdown file.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/readme.md"
}{
"output_path": "~/Documents/readme_rendered.html",
"output_size": "6.4 KB"
}Exemple realiste
{
"path": "~/Documents/blog-post.md"
}{
"output_path": "~/Documents/blog-post_rendered.html",
"output_size": "14.8 KB"
}vaulttools_text_html_to_markdown
Convert an HTML file to Markdown.
Entree
path string Path to the input HTML file.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/snippet.html"
}{
"output_path": "~/Documents/snippet_converted.md",
"output_size": "1.2 KB"
}Exemple realiste
{
"path": "~/Documents/article.html"
}{
"output_path": "~/Documents/article_converted.md",
"output_size": "9.7 KB"
}vaulttools_text_convert_format
Convert between YAML, JSON, and TOML formats.
Entree
from_format string Source format: "yaml", "json", or "toml".
path string Path to the input file.
to_format string Target format: "yaml", "json", or "toml".
Sortie
from_format string output_path string output_size string output_size_bytes integer to_format string Exemple minimal
{
"path": "~/Documents/config.yaml",
"from_format": "yaml",
"to_format": "json"
}{
"output_path": "~/Documents/config_converted.json",
"output_size": "2.4 KB",
"from_format": "yaml",
"to_format": "json"
}Exemple realiste
{
"path": "~/Documents/settings.toml",
"from_format": "toml",
"to_format": "yaml"
}{
"output_path": "~/Documents/settings_converted.yaml",
"output_size": "3.1 KB",
"from_format": "toml",
"to_format": "yaml"
}vaulttools_text_xml_to_json
Convert an XML file to JSON format.
Entree
path string Path to the input XML file.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/data.xml"
}{
"output_path": "~/Documents/data_converted.json",
"output_size": "5.6 KB"
}Exemple realiste
{
"path": "~/Documents/sitemap.xml"
}{
"output_path": "~/Documents/sitemap_converted.json",
"output_size": "18.2 KB"
}vaulttools_text_html_entity_encode
Encode a text or HTML file using HTML entities.
Entree
path string Path to the input text or HTML file.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/email-template.html"
}{
"output_path": "~/Documents/email-template_encoded_entities.html",
"output_size": "3.8 KB"
}Exemple realiste
{
"path": "~/Documents/embed-snippet.txt"
}{
"output_path": "~/Documents/embed-snippet_encoded_entities.txt",
"output_size": "812 B"
}vaulttools_text_html_entity_decode
Decode HTML entities in a text or HTML file.
Entree
path string Path to the input text or HTML file containing HTML entities.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/snippet-encoded.html"
}{
"output_path": "~/Documents/snippet-encoded_decoded_entities.html",
"output_size": "2.9 KB"
}Exemple realiste
{
"path": "~/Documents/exported-markup.txt"
}{
"output_path": "~/Documents/exported-markup_decoded_entities.txt",
"output_size": "1.4 KB"
}vaulttools_text_diff
Compare two text files and produce a diff. Returns change statistics.
Entree
modified_path string Path to the modified text file.
original_path string Path to the original text file.
Sortie
added_lines integer changed_lines integer identical boolean output_path string removed_lines integer Exemple minimal
{
"original_path": "~/Documents/v1.txt",
"modified_path": "~/Documents/v2.txt"
}{
"output_path": "~/Documents/v1_diff.json",
"identical": false,
"added_lines": 12,
"removed_lines": 3,
"changed_lines": 5
}Exemple realiste
{
"original_path": "~/Documents/config-old.yaml",
"modified_path": "~/Documents/config-new.yaml"
}{
"output_path": "~/Documents/config-old_diff.json",
"identical": false,
"added_lines": 8,
"removed_lines": 2,
"changed_lines": 14
}vaulttools_text_regex_test
Test a regex pattern against file contents. Returns match count and writes detailed JSON results.
Entree
flags stringnull Regex flags: "g", "i", "m", "s", "u". Combine as needed, e.g. "gim".
path string Path to the input text file to test against.
pattern string Regular expression pattern.
Sortie
match_count integer output_path string Exemple minimal
{
"path": "~/Documents/log.txt",
"pattern": "ERROR"
}{
"output_path": "~/Documents/log_regex_results.json",
"match_count": 7
}Exemple realiste
{
"path": "~/Documents/access.log",
"pattern": "\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}",
"flags": "g"
}{
"output_path": "~/Documents/access_regex_results.json",
"match_count": 342
}vaulttools_text_regex_replace
Apply a regex replacement to file contents and write the transformed text to disk.
Entree
flags stringnull Regex flags: "g", "i", "m", "s", "u". Combine as needed, e.g. "gim".
path string Path to the input text file to transform.
pattern string Regular expression pattern.
replacement string Replacement string, including backreferences such as $1.
Sortie
output_path string output_size string output_size_bytes integer replacements integer Exemple minimal
{
"path": "~/Documents/config.env",
"pattern": "API_KEY=.*",
"replacement": "API_KEY=REDACTED"
}{
"output_path": "~/Documents/config_replaced.env",
"output_size": "168 B",
"replacements": 1
}Exemple realiste
{
"path": "~/Documents/report.md",
"pattern": "\\b2025\\b",
"replacement": "2026",
"flags": "g"
}{
"output_path": "~/Documents/report_replaced.md",
"output_size": "14.3 KB",
"replacements": 27
}vaulttools_text_word_count
Count words, characters, lines in a text file. No output file.
Entree
path string Path to the input text file.
Sortie
characters integer characters_no_spaces integer file_size string file_size_bytes integer lines integer paragraphs integer sentences integer words integer Exemple minimal
{
"path": "~/Documents/essay.txt"
}{
"characters": 14832,
"characters_no_spaces": 12456,
"words": 2481,
"lines": 186,
"paragraphs": 24,
"sentences": 142,
"file_size": "14.5 KB"
}Exemple realiste
{
"path": "~/Documents/manuscript.md"
}{
"characters": 82416,
"characters_no_spaces": 68204,
"words": 13624,
"lines": 1042,
"paragraphs": 186,
"sentences": 824,
"file_size": "80.5 KB"
}DEV
vaulttools_dev_hash
Compute hash (SHA1, SHA256, SHA512) of a file. No output file.
Entree
algorithm string Hash algorithm: sha1, sha256, sha512.
path string Path to the file to hash.
Sortie
algorithm string file_size string file_size_bytes integer hash string Exemple minimal
{
"path": "~/Documents/file.bin",
"algorithm": "sha256"
}{
"hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"algorithm": "sha256",
"file_size": "4.2 MB"
}Exemple realiste
{
"path": "~/Documents/release.tar.gz",
"algorithm": "sha512"
}{
"hash": "cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e",
"algorithm": "sha512",
"file_size": "28.6 MB"
}vaulttools_dev_color_convert
Convert colors between hex, RGB, and HSL formats. Inline, no file I/O.
Entree
color string Color value to convert (e.g. "#ff5733", "255,87,51", "11,80%,60%").
to_format string Target format: hex, rgb, hsl.
Sortie
input string result string to_format string Exemple minimal
{
"color": "#ff5733",
"to_format": "rgb"
}{
"input": "#ff5733",
"to_format": "rgb",
"result": "255,87,51"
}Exemple realiste
{
"color": "255,87,51",
"to_format": "hsl"
}{
"input": "255,87,51",
"to_format": "hsl",
"result": "11,100%,60%"
}vaulttools_dev_url_encode
URL-encode the contents of a text file. Supports full or component mode.
Entree
mode stringnull Encoding mode: full or component. Defaults to full.
path string Path to the input text file.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/query.txt",
"mode": "full"
}{
"output_path": "~/Documents/query_encoded.txt",
"output_size": "248 B"
}Exemple realiste
{
"path": "~/Documents/api-params.txt",
"mode": "component"
}{
"output_path": "~/Documents/api-params_encoded.txt",
"output_size": "1.2 KB"
}vaulttools_dev_url_decode
URL-decode the contents of a text file. Supports full or component mode.
Entree
mode stringnull Decoding mode: full or component. Defaults to full.
path string Path to the input text file with URL-encoded content.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/encoded-url.txt",
"mode": "full"
}{
"output_path": "~/Documents/encoded-url_decoded.txt",
"output_size": "186 B"
}Exemple realiste
{
"path": "~/Documents/webhook-payload.txt",
"mode": "component"
}{
"output_path": "~/Documents/webhook-payload_decoded.txt",
"output_size": "824 B"
}vaulttools_dev_qr_generate
Generate a QR code SVG file from text input.
Entree
size integernull QR code size in pixels (default 256).
text string Text or URL to encode into a QR code.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"text": "https://example.com"
}{
"output_path": "~/Documents/qrcode.svg",
"output_size": "1.8 KB"
}Exemple realiste
{
"text": "https://vault-tools.com/image-tools/compress",
"size": 512
}{
"output_path": "~/Documents/qrcode.svg",
"output_size": "2.4 KB"
}vaulttools_dev_qr_read
Read and decode a QR code from an image file. No output file.
Entree
path string Path to an image file containing a QR code.
Sortie
codes any[] Exemple minimal
{
"path": "~/Documents/qrcode.png"
}{
"codes": [
{
"text": "https://example.com"
}
]
}Exemple realiste
{
"path": "~/Documents/ticket-qr.jpg"
}{
"codes": [
{
"text": "EVT-2025-1234-ABCD-5678"
}
]
}vaulttools_dev_uuid
Generate UUIDs (v4) and write to a file.
Entree
count integernull Number of UUIDs to generate (default 1, max 1000).
Sortie
count integer output_path string Exemple minimal
{}{
"output_path": "~/Documents/uuids.txt",
"count": 1
}Exemple realiste
{
"count": 10
}{
"output_path": "~/Documents/uuids.txt",
"count": 10
}vaulttools_dev_jwt_decode
Decode a JWT token from a file. Writes decoded header and payload to output.
Entree
path string Path to a text file containing a JWT token.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/token.txt"
}{
"output_path": "~/Documents/token_decoded.json",
"output_size": "482 B"
}Exemple realiste
{
"path": "~/Documents/auth-token.txt"
}{
"output_path": "~/Documents/auth-token_decoded.json",
"output_size": "1.2 KB"
}vaulttools_dev_cron_parse
Parse a 5-field cron expression into a human-readable description. Inline, no file I/O.
Entree
expression string Cron expression with 5 fields: minute hour day-of-month month day-of-week.
Sortie
day_of_month string day_of_week string description string expression string hour string minute string month string Exemple minimal
{
"expression": "*/15 * * * *"
}{
"expression": "*/15 * * * *",
"description": "Every 15 minutes",
"minute": "*/15",
"hour": "*",
"day_of_month": "*",
"month": "*",
"day_of_week": "*"
}Exemple realiste
{
"expression": "0 9 * * 1"
}{
"expression": "0 9 * * 1",
"description": "At minute 0, hour 9, on Monday",
"minute": "0",
"hour": "9",
"day_of_month": "*",
"month": "*",
"day_of_week": "1"
}vaulttools_dev_lorem_generate
Generate lorem ipsum placeholder text. Inline, no file I/O.
Entree
count integernull Number of items to generate. Defaults to 1. Maximum 100.
mode stringnull Output mode: paragraphs, sentences, or words. Defaults to paragraphs.
Sortie
text string word_count integer Exemple minimal
{
"mode": "sentences",
"count": 1
}{
"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
"word_count": 8
}Exemple realiste
{
"mode": "words",
"count": 12
}{
"text": "Lorem lorem ipsum dolor sit amet consectetur adipiscing elit sed do eiusmod",
"word_count": 12
}vaulttools_dev_timestamp_to_human
Convert a Unix timestamp to a UTC date/time. Supports auto, seconds, or milliseconds input.
Entree
timestamp number Unix timestamp input.
unit stringnull Input unit: auto, seconds, or milliseconds. Defaults to auto.
Sortie
day integer hour integer human string iso string minute integer month integer second integer unit string year integer Exemple minimal
{
"timestamp": 1708300800,
"unit": "auto"
}{
"unit": "seconds",
"year": 2024,
"month": 2,
"day": 19,
"hour": 0,
"minute": 0,
"second": 0,
"iso": "2024-02-19T00:00:00Z",
"human": "Monday, February 19, 2024 00:00:00 UTC"
}Exemple realiste
{
"timestamp": 1708300800000,
"unit": "milliseconds"
}{
"unit": "milliseconds",
"year": 2024,
"month": 2,
"day": 19,
"hour": 0,
"minute": 0,
"second": 0,
"iso": "2024-02-19T00:00:00Z",
"human": "Monday, February 19, 2024 00:00:00 UTC"
}vaulttools_dev_timestamp_to_unix
Convert a UTC date/time to a Unix timestamp in seconds or milliseconds.
Entree
day integer UTC day value.
hour integernull UTC hour value. Defaults to 0.
minute integernull UTC minute value. Defaults to 0.
month integer UTC month value (1-12).
second integernull UTC second value. Defaults to 0.
unit stringnull Output unit: seconds or milliseconds. Defaults to seconds.
year integer UTC year value.
Sortie
timestamp integer unit string Exemple minimal
{
"year": 2025,
"month": 3,
"day": 2
}{
"timestamp": 1740873600,
"unit": "seconds"
}Exemple realiste
{
"year": 2025,
"month": 3,
"day": 2,
"hour": 0,
"minute": 0,
"second": 0,
"unit": "milliseconds"
}{
"timestamp": 1740873600000,
"unit": "milliseconds"
}FILE
vaulttools_file_checksum
Compute MD5, SHA1, SHA256, SHA512 checksums of a file. No output file.
Entree
path string Path to the input file.
Sortie
file_size string file_size_bytes integer md5 string sha1 string sha256 string sha512 string Exemple minimal
{
"path": "~/Documents/installer.dmg"
}{
"file_size": "148.2 MB",
"md5": "d41d8cd98f00b204e9800998ecf8427e",
"sha1": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
"sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"sha512": "cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e"
}Exemple realiste
{
"path": "~/Downloads/firmware-v2.3.bin"
}{
"file_size": "24.8 MB",
"md5": "7b6b1625bf04531e8a3e8fd1e0e8e126",
"sha1": "2ef7bde608ce5404e97d5f042f95f89f1c232871",
"sha256": "a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e",
"sha512": "b7f783baed8297f0db917462184ff4f08e69c2d5e5f79a942600f9725f58ce1f29c18139bf80b06c0fff2bdd34738452ecf40c488c22a7e3d80cdf6f9c1c0d47"
}vaulttools_file_zip_create
Create a ZIP archive from multiple files.
Entree
paths string[] Paths to the files to include in the ZIP archive.
Sortie
file_count integer output_path string output_size string output_size_bytes integer Exemple minimal
{
"paths": [
"~/Documents/file1.txt",
"~/Documents/file2.txt"
]
}{
"output_path": "~/Documents/file1_archive.zip",
"output_size": "3.4 KB",
"file_count": 2
}Exemple realiste
{
"paths": [
"~/Documents/project/index.html",
"~/Documents/project/styles.css",
"~/Documents/project/script.js",
"~/Documents/project/logo.png"
]
}{
"output_path": "~/Documents/project/index_archive.zip",
"output_size": "42.8 KB",
"file_count": 4
}vaulttools_file_zip_list
List entries in a ZIP archive. No output file.
Entree
path string Path to the ZIP archive.
Sortie
entries any[] Array of ZIP entry metadata.
entry_count integer Exemple minimal
{
"path": "~/Documents/archive.zip"
}{
"entries": "[{\"name\":\"readme.txt\",\"size\":1024,\"compressed_size\":512,\"index\":0},{\"name\":\"data.csv\",\"size\":8192,\"compressed_size\":2048,\"index\":1}]",
"entry_count": 2
}Exemple realiste
{
"path": "~/Documents/project-backup.zip"
}{
"entries": "[{\"name\":\"src/index.ts\",\"size\":4096,\"compressed_size\":1280,\"index\":0},{\"name\":\"src/utils.ts\",\"size\":2048,\"compressed_size\":768,\"index\":1},{\"name\":\"package.json\",\"size\":512,\"compressed_size\":256,\"index\":2},{\"name\":\"tsconfig.json\",\"size\":384,\"compressed_size\":192,\"index\":3}]",
"entry_count": 4
}vaulttools_file_zip_extract
Extract a single entry from a ZIP archive.
Entree
entry_index integer Zero-based index of the entry to extract (use zip_list to find indices).
path string Path to the ZIP archive.
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/archive.zip",
"entry_index": 0
}{
"output_path": "~/Documents/readme.txt",
"output_size": "1.0 KB"
}Exemple realiste
{
"path": "~/Documents/project-backup.zip",
"entry_index": 2
}{
"output_path": "~/Documents/package.json",
"output_size": "512 B"
}vaulttools_file_tsv_csv
Convert between TSV and CSV formats.
Entree
direction string Conversion direction: "tsv_to_csv" or "csv_to_tsv".
path string Path to the input file (TSV or CSV).
Sortie
output_path string output_size string output_size_bytes integer Exemple minimal
{
"path": "~/Documents/data.tsv",
"direction": "tsv_to_csv"
}{
"output_path": "~/Documents/data_converted.csv",
"output_size": "14.2 KB"
}Exemple realiste
{
"path": "~/Documents/export.csv",
"direction": "csv_to_tsv"
}{
"output_path": "~/Documents/export_converted.tsv",
"output_size": "16.8 KB"
}