# TweekIT MCP Server

> TweekIT MCP Server is a freemium MCP server for files and documents. Convert and preflight 450+ file types so AI assistants can read them. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9.95 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://www.tweekit.io
- **Repository:** https://github.com/equilibrium-team/tweekit-mcp
- **MCP Registry name:** io.github.equilibrium-team/tweekit
- **Categories:** files and documents, design and media
- **Listing updated:** 2026-11-14

## About

TweekIT targets the 'unsupported file type' wall. It sits between an agent and unpredictable files, normalising formats and applying transforms such as cropping, resizing, format conversion and background changes. The engine descends from Equilibrium's MediaRich Server, which the README says has been developed since 2000, and the site lists over 400 supported types including camera RAW, PSD and DWG.

The MCP exposes two tools: a preflight check and file conversion. Routing is configurable. By default it uses the cloud API with a key and secret, but flags allow a local on-premises Miner, enforce localhost-only processing, or refuse to upload local files unless a local Miner is used.

Pricing is a fixed price per API request that falls on higher plans, starting with a free allowance. A Python SDK ships in the same package.

## Features

- **Preflight check:** Tests whether a file is ready for an AI workflow.
- **Wide format support:** Handles 450+ file types per the registry entry.
- **Local-only mode:** Can block cloud egress and use an on-prem Miner.
- **Upload guard:** Optionally refuses local file uploads unless routed locally.
- **Python SDK:** Includes a client for pipelines.
- **Hosted or stdio:** Runs as a PyPI package or hosted endpoint.

## Good for

- Make a PSD or DWG readable for an assistant
- Resize images to fit model limits
- Keep file conversion on-premises for sensitive material
- Normalise uploads in an AI pipeline

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tweekit https://mcp.tweekit.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tweekit.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tweekit": {
      "url": "https://mcp.tweekit.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tweekit": {
      "type": "http",
      "url": "https://mcp.tweekit.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tweekit": {
      "serverUrl": "https://mcp.tweekit.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tweekit": {
      "type": "http",
      "url": "https://mcp.tweekit.io/mcp"
    }
  }
}
```

## Tools

- `convert_file`: Convert a file to an AI-compatible format
- `preflight_check`: Check whether a file is ready for an AI workflow

## FAQ

### Is there a free tier?

Yes, 10 credits, up to 10,000 API requests.

### What does the cheapest paid plan cost?

Starter is $9.95 a month.

### Can files stay local?

Yes, with TWEEKIT_LOCAL_ONLY and an on-prem Miner.

### What credentials does it need?

A TweekIT API key and secret, optional for loopback Miner use.

### Is TweekIT MCP Server free?

TweekIT MCP Server has a free plan, with paid plans for more usage or features. Paid plans start at $9.95 a month.

### How do I add TweekIT MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http tweekit https://mcp.tweekit.io/mcp

### What are the best alternatives to TweekIT MCP Server?

The closest alternatives to TweekIT MCP Server are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/tweekit-mcp-server
