Skip to content
MCP server

TweekIT MCP Server

Convert and preflight 450+ file types so AI assistants can read them

Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
1.8.3
Listing updated
3 days ago

About TweekIT MCP Server

TweekIT MCP Server is a freemium MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.tweekit.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tweekit": {
      "url": "https://mcp.tweekit.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • TWEEKIT_API_KEYTweekIT API key issued from the TweekIT account portal (optional when targeting a loopback NOAUTH Miner Renderery via TWEEKIT_MINER_NOAUTH=1).
  • TWEEKIT_API_SECRETAPI secret paired with TWEEKIT_API_KEY for authenticated conversions (optional when TWEEKIT_MINER_NOAUTH=1 is enabled on loopback).
  • TWEEKIT_API_BASE_URLOptional TweekIT API or On-Premises Miner Renderery URL (e.g., http://127.0.0.1:16377/api/image/ for localhost processing).
  • TWEEKIT_MINER_LOCALOptional flag ('1' or '0'). When '1', defaults API routing to the local On-Premises Miner Renderery (http://127.0.0.1:16377/api/image/).
  • TWEEKIT_LOCAL_ONLYOptional flag ('1' or '0'). When '1', enforces localhost/on-prem Miner Renderery routing and blocks third-party cloud egress.
  • TWEEKIT_MINER_NOAUTHOptional flag ('1' or '0'). When '1', allows loopback Miner Renderery requests without cloud API credentials.
  • TWEEKIT_ONPREM_HOSTSOptional comma-separated list of trusted private LAN Miner Renderery hostnames or IPs permitted under TWEEKIT_LOCAL_ONLY=1.
  • TWEEKIT_REQUIRE_LOCAL_MINER_FOR_FILESOptional flag ('1' or '0'). When '1', convert_file refuses to upload local files unless routed to a local or on-prem Miner Renderery.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $9.95 a month

Free plan; Starter $9.95/mo, Basic $19.95, Pro $39.95, Enterprise $99.95

Prices change. Check tweekit.io before you buy.

TweekIT MCP Server 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 to TweekIT MCP Server

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media