SammaPix — Image & PDF tools for AI agents

Official registry Productivity

Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http sammapix-image-pdf-tools-for-ai-agents 'https://www.sammapix.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "sammapix-image-pdf-tools-for-ai-agents": {
            "type": "http",
            "url": "https://www.sammapix.com/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. SammaPix
  2. For AI agents (MCP server)
  3. Tools
  4. Tech Stack
  5. Quick Start
  6. Privacy
  7. Contributing
  8. License

SammaPix

35 free browser-based image tools — compress, convert, rename with AI, and more.


SammaPix is a free, open-source image optimization platform that runs entirely in the browser. No uploads. No account required. No watermarks. Your images never leave your device.

Built for content creators, developers, and anyone who works with images at scale.

Key features:

  • 100% client-side processing — images stay on your machine
  • 35 tools across four categories (optimize, AI, creative, organize)
  • AI-powered rename, alt text generation, and photo sorting via Google Gemini
  • Batch processing with ZIP download
  • HEIC, WebP, PDF, and video format support
  • Dark mode, fully responsive
  • Pro plan ($9/month) for unlimited AI credits and larger batches

For AI agents (MCP server)

SammaPix is also a remote MCP server so AI agents (Claude, Cursor, and any MCP-compatible client) can run real image & PDF processing directly — no local install.

  • Endpoint: https://www.sammapix.com/api/mcp (Streamable HTTP)
  • Auth: OAuth 2.1 — no API key to paste. Or generate a key for REST.
  • 20+ tools: compress, convert, resize, crop, rotate, flip, adjust, grayscale, blur, tint, negate, border, round, watermark, metadata · PDF compress/merge/split/rotate, image-to-PDF, PDF info
  • Pipeline: chain multiple image ops in one call — fewer round-trips, far fewer tokens for the agent
  • Zero-retention: files processed in memory and discarded. Pay-per-use, 25 free ops/day.

Add it to your agent:

{
  "mcpServers": {
    "sammapix": { "url": "https://www.sammapix.com/api/mcp" }
  }
}

Full docs, benefits, and REST examples: sammapix.com/for-ai-agents


Tools

Optimize
ToolDescription
CompressReduce file size without visible quality loss
WebP ConverterConvert JPG/PNG to WebP for faster web delivery
HEIC ConverterConvert iPhone HEIC photos to JPG or PNG
Batch ResizeResize multiple images by pixel dimensions or percentage
Crop & RatioCrop to standard aspect ratios or custom dimensions
PDF to ImageExtract pages from PDF as high-quality images
AI-Powered
ToolDescription
AI OrganizeDrop 100+ photos — AI sorts them into named folders
AI RenameGenerate descriptive, SEO-friendly filenames automatically
AI Alt TextGenerate accessibility alt text for any image
AI Photo SortSort photos by subject, scene, or custom criteria
Web OptimizeAI-assisted optimization for web performance
TranscribeExtract text from images (OCR)
Creative
ToolDescription
Film FiltersApply 14 analog film presets (Kodak, Fuji, Polaroid, etc.)
WatermarkAdd text or image watermarks with custom positioning
Organize
ToolDescription
EXIF ViewerInspect full metadata — GPS, camera, exposure, timestamps
EXIF RemoverStrip GPS and privacy data before sharing
Find DuplicatesDetect duplicate images by visual similarity
Batch RenameRename files in bulk with custom patterns and sequences
CullQuickly review and select keepers from a shoot
Sort by LocationGroup photos by GPS coordinates on an interactive map
Photo MapVisualize where your photos were taken

Tech Stack

LayerTechnology
FrameworkNext.js 15 (App Router)
LanguageTypeScript 5
StylingTailwind CSS
StateZustand + Immer
AuthNextAuth.js v4 (Google, GitHub, Magic Link)
DatabaseNeon (PostgreSQL) via Drizzle ORM
AIGoogle Gemini 1.5 Flash
PaymentsStripe
EmailResend
Compressionbrowser-image-compression
HEICheic-convert / heic2any
Batch downloadJSZip + file-saver
TestingPlaywright (E2E)

Dashboard

AI Organize


Quick Start

git clone https://github.com/samma1997/sammapix.git
cd sammapix
npm install
cp .env.local.example .env.local   # fill in your keys
npm run dev

Open http://localhost:3000.

Most tools work without any API keys — only AI features require a GEMINI_API_KEY.

Required environment variables
# Auth
NEXTAUTH_SECRET=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# Database
DATABASE_URL=          # Neon PostgreSQL connection string

# AI (required for AI tools only)
GEMINI_API_KEY=

# Payments (required for Pro plan only)
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
STRIPE_PRO_PRICE_ID=

NEXT_PUBLIC_APP_URL=http://localhost:3000

Privacy

All image processing tools run entirely in your browser using the Canvas API, WebAssembly, and client-side JavaScript libraries. Your images are never uploaded to any server.

For AI tools (AI Rename, AI Alt Text, AI Organize), a small thumbnail is sent to Google Gemini for analysis. Full-resolution originals never leave your device and are never stored anywhere.


Contributing

Contributions are welcome. Please open an issue before submitting a pull request for significant changes.

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/your-feature)
  3. Commit your changes
  4. Open a pull request

For bug reports and feature requests, use GitHub Issues.


License

MIT — see LICENSE for details.


Built by Luca Sammarco · Live at sammapix.com

Frequently asked questions

What is SammaPix — Image & PDF tools for AI agents?

Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.

How do I install SammaPix — Image & PDF tools for AI agents?

It runs as a remote server. In Claude Code: claude mcp add --transport http sammapix-image-pdf-tools-for-ai-agents 'https://www.sammapix.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does SammaPix — Image & PDF tools for AI agents need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is SammaPix — Image & PDF tools for AI agents open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains SammaPix — Image & PDF tools for AI agents?

It is published by samma1997. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.