# S3eidat Tools MCP

> S3eidat Tools as a local MCP server: PDF, image, text, developer and calculator tools for AI assistants. Runs on your machine; files are never uploaded.

Install: `npx -y s3eidat-tools-mcp` (stdio MCP server; `--http` for Streamable HTTP on 127.0.0.1:8787/mcp). Claude Code: `claude mcp add s3eidat -- npx -y s3eidat-tools-mcp`.
File inputs: local path or base64. File outputs: written to the given `output` path (or a temp folder); results return the path. No network, no telemetry.

## Docs

- [README](https://github.com/s3eidat/s3eidat-tools-mcp#readme): install for every AI client
- [Tools reference](https://s3eidat.github.io/s3eidat-tools-mcp/tools.md): every tool with inputs, outputs, examples
- [Tools JSON](https://s3eidat.github.io/s3eidat-tools-mcp/tools.json): machine-readable schemas
- [Skill](https://github.com/s3eidat/s3eidat-tools-mcp/tree/main/skills/s3eidat-tools): which tool for which job
- [Web tools](https://s3eidat.github.io/): the same tools in the browser, for humans

## PDF

- `pdf_compress`: Compress PDF (web: https://s3eidat.github.io/pdf-compress/)
- `pdf_extract_pages`: Extract PDF pages (web: https://s3eidat.github.io/pdf-split/)
- `pdf_form_fields`: List PDF form fields (web: https://s3eidat.github.io/pdf-fill/)
- `pdf_form_fill`: Fill a PDF form (web: https://s3eidat.github.io/pdf-fill/)
- `pdf_from_images`: Images to PDF (web: https://s3eidat.github.io/images-to-pdf/)
- `pdf_info`: PDF info
- `pdf_merge`: Merge PDFs (web: https://s3eidat.github.io/pdf-merge/)
- `pdf_metadata_read`: Read PDF metadata (web: https://s3eidat.github.io/pdf-metadata/)
- `pdf_metadata_write`: Edit or strip PDF metadata (web: https://s3eidat.github.io/pdf-metadata/)
- `pdf_organize`: Organize PDF pages (web: https://s3eidat.github.io/pdf-organizer/)
- `pdf_page_numbers`: Add page numbers (web: https://s3eidat.github.io/pdf-page-numbers/)
- `pdf_rotate`: Rotate PDF pages (web: https://s3eidat.github.io/pdf-organizer/)
- `pdf_sign_image`: Sign PDF with an image (web: https://s3eidat.github.io/pdf-sign/)
- `pdf_split`: Split PDF (web: https://s3eidat.github.io/pdf-split/)
- `pdf_to_images`: PDF to images (web: https://s3eidat.github.io/pdf-to-images/)
- `pdf_to_text`: PDF to text (web: https://s3eidat.github.io/pdf-to-text/)
- `pdf_watermark`: Watermark PDF (web: https://s3eidat.github.io/pdf-watermark/)

## Images

- `image_ascii_art`: Image to ASCII art (web: https://s3eidat.github.io/ascii-art/)
- `image_ascii_banner`: Text to ASCII banner (web: https://s3eidat.github.io/ascii-art/)
- `image_compress`: Compress image (web: https://s3eidat.github.io/image-squeeze/)
- `image_convert`: Convert image format (web: https://s3eidat.github.io/image-convert/)
- `image_crop`: Crop image (web: https://s3eidat.github.io/image-resize/)
- `image_exif_read`: Read photo metadata (EXIF) (web: https://s3eidat.github.io/exif-cleaner/)
- `image_exif_strip`: Remove photo metadata (EXIF) (web: https://s3eidat.github.io/exif-cleaner/)
- `image_favicon_set`: Favicon set generator (web: https://s3eidat.github.io/favicon-forge/)
- `image_from_base64`: Base64 / data URI to image file (web: https://s3eidat.github.io/image-to-base64/)
- `image_palette`: Colour palette from image (web: https://s3eidat.github.io/palette-from-image/)
- `image_placeholder`: Placeholder image (web: https://s3eidat.github.io/placeholder-image/)
- `image_resize`: Resize image (web: https://s3eidat.github.io/image-resize/)
- `image_rotate`: Rotate / flip image (web: https://s3eidat.github.io/photo-filters/)
- `image_svg_to_png`: SVG to PNG (web: https://s3eidat.github.io/svg-to-png/)
- `image_to_base64`: Image to Base64 / data URI (web: https://s3eidat.github.io/image-to-base64/)
- `image_watermark`: Watermark image (web: https://s3eidat.github.io/watermark/)

## Text

- `text_arabic`: Arabic text tools (web: https://s3eidat.github.io/arabic-tools/)
- `text_case`: Case convert (web: https://s3eidat.github.io/case-convert/)
- `text_citation`: Citation generator (web: https://s3eidat.github.io/citation-gen/)
- `text_clean`: Text cleaner (web: https://s3eidat.github.io/text-cleaner/)
- `text_diff`: Diff two texts (web: https://s3eidat.github.io/diff-view/)
- `text_escape`: Escape / unescape text (web: https://s3eidat.github.io/text-escape/)
- `text_fancy`: Fancy text (Unicode styles) (web: https://s3eidat.github.io/fancy-text/)
- `text_layout_fix`: Keyboard layout fixer (EN ⇄ AR) (web: https://s3eidat.github.io/layout-fixer/)
- `text_lorem`: Lorem ipsum generator (web: https://s3eidat.github.io/lorem-gen/)
- `text_morse`: Morse code translator (web: https://s3eidat.github.io/morse-code/)
- `text_number_to_words`: Number to words (English & Arabic) (web: https://s3eidat.github.io/number-words/)
- `text_readability`: Readability score (web: https://s3eidat.github.io/readability/)
- `text_slugify`: Slugify (web: https://s3eidat.github.io/slugify/)
- `text_social_count`: Social media character counter (web: https://s3eidat.github.io/social-counter/)
- `text_word_count`: Word count (web: https://s3eidat.github.io/word-count/)

## Developer: data formats

- `css_format`: CSS beautify / minify (web: https://s3eidat.github.io/html-css-format/)
- `csv_to_json`: CSV to JSON (web: https://s3eidat.github.io/csv-json/)
- `curl_to_code`: cURL to code (web: https://s3eidat.github.io/curl-convert/)
- `html_format`: HTML beautify / minify (web: https://s3eidat.github.io/html-css-format/)
- `json_format`: JSON format / minify / validate (web: https://s3eidat.github.io/json-studio/)
- `json_query`: JSON query (JSONPath) (web: https://s3eidat.github.io/json-studio/)
- `json_to_csv`: JSON to CSV (web: https://s3eidat.github.io/csv-json/)
- `json_to_types`: JSON to types (TypeScript, Go, Python, Zod) (web: https://s3eidat.github.io/json-to-types/)
- `json_to_yaml`: JSON to YAML (web: https://s3eidat.github.io/yaml-json/)
- `markdown_table`: Markdown table (web: https://s3eidat.github.io/markdown-table/)
- `markdown_table_parse`: Markdown table to JSON / CSV (web: https://s3eidat.github.io/markdown-table/)
- `sql_format`: SQL format / minify (web: https://s3eidat.github.io/sql-format/)
- `xml_format`: XML format / minify / validate / to JSON (web: https://s3eidat.github.io/xml-format/)
- `xml_query`: XML XPath query (web: https://s3eidat.github.io/xml-format/)
- `yaml_to_json`: YAML to JSON (web: https://s3eidat.github.io/yaml-json/)

## Developer: utilities

- `base_convert`: Number base convert (web: https://s3eidat.github.io/base-convert/)
- `base64_decode`: Base64 decode (web: https://s3eidat.github.io/base64-kit/)
- `base64_encode`: Base64 encode (web: https://s3eidat.github.io/base64-kit/)
- `bytes_convert`: Text ⇄ UTF-8 bytes (web: https://s3eidat.github.io/base-convert/)
- `chmod_calc`: chmod calculator (web: https://s3eidat.github.io/chmod-calc/)
- `cron_explain`: Cron explain (web: https://s3eidat.github.io/cron-explain/)
- `css_clamp`: Fluid CSS clamp() (web: https://s3eidat.github.io/css-units/)
- `css_units`: CSS unit converter (web: https://s3eidat.github.io/css-units/)
- `gitignore_generate`: Generate .gitignore (web: https://s3eidat.github.io/gitignore-gen/)
- `hash_compute`: Hash (MD5 / SHA) (web: https://s3eidat.github.io/hash-lab/)
- `http_status`: HTTP status codes (web: https://s3eidat.github.io/http-status/)
- `id_generate`: Generate IDs (UUID / ULID / NanoID) (web: https://s3eidat.github.io/uuid-forge/)
- `id_inspect`: Inspect a UUID / ULID (web: https://s3eidat.github.io/uuid-forge/)
- `ip_in_range`: Is this IP in that range? (web: https://s3eidat.github.io/subnet-calc/)
- `jwt_decode`: JWT decode (web: https://s3eidat.github.io/jwt-inspector/)
- `meta_tags_generate`: Meta tags generator (web: https://s3eidat.github.io/meta-tags/)
- `regex_test`: Regex test (web: https://s3eidat.github.io/regex-playground/)
- `subnet_calc`: Subnet calculator (IPv4 / IPv6) (web: https://s3eidat.github.io/subnet-calc/)
- `time_convert`: Timestamp convert (web: https://s3eidat.github.io/timestamp-convert/)
- `url_decode`: URL decode (web: https://s3eidat.github.io/url-toolkit/)
- `url_encode`: URL encode (web: https://s3eidat.github.io/url-toolkit/)
- `url_parse`: URL parse (web: https://s3eidat.github.io/url-toolkit/)
- `useragent_parse`: User agent parse (web: https://s3eidat.github.io/ua-parser/)

## Calculators

- `calc_age`: Age calculator (web: https://s3eidat.github.io/age-calc/)
- `calc_bmi`: BMI calculator (web: https://s3eidat.github.io/bmi-calc/)
- `calc_cash_count`: Cash counter (web: https://s3eidat.github.io/cash-counter/)
- `calc_compound_interest`: Compound interest / savings growth (web: https://s3eidat.github.io/compound-interest/)
- `calc_date_diff`: Date difference / add days (web: https://s3eidat.github.io/date-diff/)
- `calc_discount`: Discount / sale price calculator (web: https://s3eidat.github.io/discount-calc/)
- `calc_due_date`: Pregnancy due date (web: https://s3eidat.github.io/due-date/)
- `calc_equation`: Equation solver (web: https://s3eidat.github.io/equation-solver/)
- `calc_expression`: Scientific calculator (web: https://s3eidat.github.io/sci-calc/)
- `calc_fraction`: Fraction calculator (web: https://s3eidat.github.io/fraction-calc/)
- `calc_fuel_cost`: Fuel cost of a trip (web: https://s3eidat.github.io/fuel-cost/)
- `calc_gpa`: GPA calculator (web: https://s3eidat.github.io/gpa-calc/)
- `calc_hijri`: Hijri ⇄ Gregorian converter (web: https://s3eidat.github.io/hijri-converter/)
- `calc_hours`: Work hours / time card (web: https://s3eidat.github.io/hours-calc/)
- `calc_loan`: Loan / mortgage calculator (web: https://s3eidat.github.io/loan-calc/)
- `calc_percentage`: Percentage calculator (web: https://s3eidat.github.io/percentage-calc/)
- `calc_primes`: Prime number tools (web: https://s3eidat.github.io/prime-tools/)
- `calc_roman`: Roman numerals (web: https://s3eidat.github.io/roman-numerals/)
- `calc_salary`: Salary / pay period converter (web: https://s3eidat.github.io/salary-calc/)
- `calc_sleep`: Sleep cycle calculator (web: https://s3eidat.github.io/sleep-calc/)
- `calc_split_bill`: Split a bill (web: https://s3eidat.github.io/split-bill/)
- `calc_stats`: Descriptive statistics (web: https://s3eidat.github.io/stats-calc/)
- `calc_unit_convert`: Unit converter (web: https://s3eidat.github.io/unit-convert/)
- `calc_zakat`: Zakat calculator (web: https://s3eidat.github.io/zakat-calc/)

## Everyday & security

- `crypto_file_decrypt`: Decrypt a file (.s3enc) (web: https://s3eidat.github.io/file-encrypt/)
- `crypto_file_encrypt`: Encrypt a file (.s3enc) (web: https://s3eidat.github.io/file-encrypt/)
- `crypto_stego_hide`: Hide a message in an image (web: https://s3eidat.github.io/stego-image/)
- `crypto_stego_reveal`: Reveal a hidden message (web: https://s3eidat.github.io/stego-image/)
- `crypto_text_decrypt`: Decrypt text (AES-256-GCM) (web: https://s3eidat.github.io/text-encrypt/)
- `crypto_text_encrypt`: Encrypt text (AES-256-GCM) (web: https://s3eidat.github.io/text-encrypt/)
- `password_check`: Password strength check (web: https://s3eidat.github.io/password-check/)
- `password_generate`: Password & passphrase generator (web: https://s3eidat.github.io/pass-forge/)
- `prayer_times`: Prayer times (web: https://s3eidat.github.io/prayer-times/)
- `qibla_direction`: Qibla direction (web: https://s3eidat.github.io/qibla-finder/)
- `random_dice`: Dice roller, coin flip, random numbers (web: https://s3eidat.github.io/dice-roller/)
- `random_pick`: Wheel picker (random pick) (web: https://s3eidat.github.io/wheel-picker/)
- `random_teams`: Team maker (web: https://s3eidat.github.io/team-maker/)
- `secret_santa_draw`: Secret Santa draw (web: https://s3eidat.github.io/secret-santa/)
- `time_world_clock`: World clock & meeting planner (web: https://s3eidat.github.io/world-clock/)

## QR & barcodes

- `barcode_generate`: Barcode generator (web: https://s3eidat.github.io/barcode-gen/)
- `qr_generate`: QR code generator (web: https://s3eidat.github.io/qr-studio/)
- `qr_read`: QR code reader (web: https://s3eidat.github.io/qr-scanner/)
- `qr_wifi`: Wi-Fi QR code and card (web: https://s3eidat.github.io/wifi-card/)

## Document makers

- `doc_attendance_sheet`: Attendance sheet PDF (web: https://s3eidat.github.io/attendance-sheet/)
- `doc_business_cards`: Business cards PDF (web: https://s3eidat.github.io/business-card/)
- `doc_calendar`: Calendar PDF (web: https://s3eidat.github.io/calendar-maker/)
- `doc_invoice`: Invoice PDF (web: https://s3eidat.github.io/invoice-maker/)
- `doc_labels`: Label sheets PDF (web: https://s3eidat.github.io/label-maker/)
- `doc_receipt`: Receipt PDF (web: https://s3eidat.github.io/receipt-maker/)
- `doc_resume`: Resume / CV PDF (web: https://s3eidat.github.io/resume-builder/)

## For AI agents

- `ai_chart`: Chart to SVG/PNG
- `ai_chunk_text`: Chunk text for RAG
- `ai_create_pptx`: Create a PowerPoint deck
- `ai_create_xlsx`: Create an Excel workbook (.xlsx)
- `ai_csv_profile`: Profile a table (CSV, JSON, XLSX)
- `ai_detect_language`: Detect language
- `ai_diagram`: Diagram to SVG/PNG
- `ai_docx_to_markdown`: Word (.docx) to Markdown
- `ai_extract_entities`: Extract entities
- `ai_file_identify`: Identify a file type
- `ai_html_to_markdown`: HTML to Markdown
- `ai_image_diff`: Compare two images
- `ai_json_schema_infer`: Infer a JSON Schema from samples
- `ai_json_schema_validate`: Validate JSON against a JSON Schema
- `ai_markdown_to_docx`: Markdown to Word (.docx)
- `ai_markdown_to_pdf`: Markdown to PDF
- `ai_media_info`: Audio/video metadata
- `ai_ocr`: OCR (image or scanned PDF to text)
- `ai_pdf_to_markdown`: PDF to Markdown
- `ai_pptx_to_markdown`: PowerPoint (.pptx) to Markdown
- `ai_sql_query`: SQL query over tables
- `ai_text_similarity`: Text similarity and near-duplicates
- `ai_token_count`: Count tokens
- `ai_web_fetch`: Fetch a web page as Markdown
- `ai_xlsx_to_markdown`: Excel (.xlsx/.csv) to Markdown tables
- `ai_zip`: ZIP create / extract / list