TweekIT MCP Server

Install

Config snippet generator goes here (5 client tabs)

README

# TweekIT MCP Server

*Ingest and Convert Just About Any Filetype Into AI Workflows*

Current version: v1.6.1

> **🤖 Claude Users**: Tired of "unsupported file type" errors? Jump to our [Claude File Format Enabler](#solving-claudes-file-type-limitations) – a browser-based tool that converts 450+ formats (DOC, XLS, PSD, DWG, etc.) into Claude-compatible files in seconds.

## Overview

TweekIT MCP Server is the universal media translator for AI workflows, making any file ready for processing in seconds. **Built on the robust content processing engine of Equilibrium's MediaRich Server, a technology developed since 2000 and trusted by massive portals and media companies worldwide, TweekIT brings decades of expertise in handling complex media, drawing on a pedigree that includes the renowned DeBabelizer.**

With TweekIT, you can upload, preview, transform, and download over 400 supported file types using a consistent API or widget interface. It removes the pain of unpredictable input formats by automatically normalizing and preparing assets for the next step in your workflow.

### What is TweekIT?

TweekIT is a universal media ingestion and transformation service designed to take any supported file and make it AI ready in seconds. Whether you are normalizing formats, resizing assets, or extracting a single page from a complex document, TweekIT provides a consistent, API first way to get exactly the output you need without worrying about the quirks of individual file types.

### Why use it in an MCP context?

In a Model Context Protocol (MCP) workflow, TweekIT acts like a universal translator for media. It sits between your AI agent and the unpredictable real world files it encounters, ensuring every asset is transformed into a compatible, standardized format before processing. This is similar to how GitHub Actions streamlines software automation, but applied to media handling in AI pipelines.

With TweekIT in your MCP toolset, your agents can:

- Accept a wider range of inputs from users without failure
- Automatically apply transformations such as cropping, resizing, format conversion, and background changes
- Pass clean, ready to use assets to the next step in your AI workflow with no manual intervention fixing the constant customer file ingestion failures we are all to familiar with

> **🤖 Claude Users**: See [Solving Claude's File Type Limitations](#solving-claudes-file-type-limitations) for a dedicated guide on using TweekIT to overcome Claude's built-in file format restrictions and our standalone web converter tool.

### Example scenario

A user uploads a scanned PDF of an ID card as part of an onboarding process. Your MCP agent calls TweekIT to:

- Convert the PDF to a PNG image
- Crop to just the ID card
- Resize to a standard 300x300 pixel headshot
- Return the transformed image directly into the verification pipeline

The entire process happens in seconds, and your workflow never sees an incompatible file format.

### Key Capabilities

- Supports **400+** file types for seamless ingestion and conversion, **leveraging a core engine refined over two decades to handle dynamic imaging and video processing.**
- Stateless and API first design for fast, scalable integrations
- Widget or REST API access to fit any application architecture
- Enterprise grade security with secure key handling and short lived asset storage
- Instant compatibility fixes that prevent AI pipeline failures from bad input formats immediately

### Try it now

- **[AI File Format Enabler](examples/web-converter/)** – Browser-based converter for Claude, OpenAI, and other AI tools (DOC, XLS, PSD, DWG → PDF/PNG)
- [Live Demo](https://www.tweekit.io/demo/) – Upload and transform files in your browser
- [Use Case Examples](https://www.tweekit.io/use-case/) – See practical workflows and code samples on the website. **The specific MCP manifest conversions are shown in section 7 below.**

## Table of Contents

- [Overview](#overview)
- [Solving Claude's File Type Limitations](#solving-claudes-file-type-limitations)
- [Requirements](#requirements)
- [Installation](#installation)
- [Quickstart](#quickstart)
- [Authentication](#authentication)
- [Server and Hosting](#server-and-hosting)
- [Client Compatibility](#client-compatibility)
  - [Quickstart (Claude Desktop)](#quickstart-claude-desktop)
  - [Quickstart (ChatGPT MCP)](#quickstart-chatgpt-mcp)
  - [Quickstart (Cursor IDE)](#quickstart-cursor-ide)
  - [Quickstart (Continue IDE)](#quickstart-continue-ide)
- [Rate Limits and Pricing](#rate-limits-and-pricing)
- [Core Concepts](#core-concepts)
- [MCP API Reference](#mcp-reference)
- [REST API Reference](#rest-api-reference)
- [Use Cases](#use-cases)
- [Demo + Show Code](#demo--show-code)
- [Error Handling and Troubleshooting](#error-handling-and-troubleshooting)
- [Advanced Topics](#advanced-topics)
- [Registry Readiness](#registry-readiness)
- [Resources](#resources)

## Requirements

- Python 3.10 or later
- Docker (optional, for containeriz