TweekIT MCP Server

equilibrium-team/tweekit-mcp

Connects to TweekIT's hosted conversion engine to normalize and transform 400+ file formats through MCP tool calls. Exposes a convert operation that takes base64 encoded files and returns processed outputs like resized PNGs, cropped PDFs, or format conversions. Built on Equilibrium's MediaRich technology, which has handled enterprise media workflows since 2000. You'd reach for this when building AI agents that need to ingest messy real world files like DOC, XLS, PSD, or DWG and output something standardized. Authentication uses API key and secret pairs from your TweekIT account. Free tier includes 10,000 calls. Works over streamable HTTP so there's nothing to host yourself.

GitHub stars: 1
tools: 5
auth: Secret needed
transport: STDIO, HTTP
env vars: 8
last updated: Nov 10, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.tweekit.io/mcp --name tweekit --header 'ApiKey: ${APIKEY}' --header 'ApiSecret: ${APISECRET}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http tweekit https://mcp.tweekit.io/mcp --header 'ApiKey: YOUR_APIKEY' --header 'ApiSecret: YOUR_APISECRET'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 5 tools

Verified live against the running server on Nov 6, 2026.

doctypeRetrieve a list of supported file formats or map a file extension to its document type. Args: apiKey (str): The API key for authentication. Falls back to TWEEKIT_API_KEY when omitted. apiSecret (str): The API secret for authentication. Falls back to TWEEKIT_API_SECRET when omi...3 params

Retrieve a list of supported file formats or map a file extension to its document type. Args: apiKey (str): The API key for authentication. Falls back to TWEEKIT_API_KEY when omitted. apiSecret (str): The API secret for authentication. Falls back to TWEEKIT_API_SECRET when omi...

Parameters* required

apiKeyvalue

TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted.

apiSecretvalue

TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted.

extensionstring

File extension to inspect; use '*' to list all supported inputs.default: *

convertConvert an uploaded document payload with TweekIT. The file must already be base64 encoded (see `blob`). The conversion can be resized and cropped by providing optional geometry parameters. For raster outputs, set `alpha`/`bgColor` to control transparency handling. Args: inext...15 params

Convert an uploaded document payload with TweekIT. The file must already be base64 encoded (see `blob`). The conversion can be resized and cropped by providing optional geometry parameters. For raster outputs, set `alpha`/`bgColor` to control transparency handling. Args: inext...

Parameters* required

alphaboolean

Preserve alpha transparency when producing raster formats.default: true

apiKeyvalue

TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted.

apiSecretvalue

TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted.

bgColorstring

Background color (hex RGB) to composite behind transparent pixels.default:

blob*string

Base64 encoded document payload (DocData).

heightinteger

Optional pixel height for the converted output.default: 0

inext*string

Input file extension (e.g., pdf, docx, png).

noRasterizeboolean

Forward to TweekIT to disable rasterization when supported.default: false

outfmt*string

Requested output format to send as Fmt.

pageinteger

Page number to convert for multi-page inputs.default: 1

widthinteger

Optional pixel width for the converted output.default: 0

x1integer

Left crop coordinate in source pixels.default: 0

x2integer

Right crop coordinate in source pixels.default: 0

y1integer

Top crop coordinate in source pixels.default: 0

y2integer

Bottom crop coordinate in source pixels.default: 0

convert_urlDownload a remote file and convert it with TweekIT in one step. This helper first fetches `url`, infers the input extension when possible, and then forwards the bytes to `convert`. Supply `fetchHeaders` when the remote resource needs authentication or custom headers. Args: url...16 params

Download a remote file and convert it with TweekIT in one step. This helper first fetches `url`, infers the input extension when possible, and then forwards the bytes to `convert`. Supply `fetchHeaders` when the remote resource needs authentication or custom headers. Args: url...

Parameters* required

alphaboolean

Preserve alpha transparency when producing raster formats.default: true

apiKeyvalue

TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted.

apiSecretvalue

TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted.

bgColorstring

Background color (hex RGB) to composite behind transparent pixels.default:

fetchHeadersvalue

Optional HTTP headers to include when downloading the URL.

heightinteger

Optional pixel height for the converted output.default: 0

inextvalue

Override for the detected input extension (e.g., pdf).

noRasterizeboolean

Forward to TweekIT to disable rasterization when supported.default: false

outfmt*string

Requested output format to send as Fmt.

pageinteger

Page number to convert for multi-page inputs.default: 1

url*string

Direct download URL for the source document or image.

widthinteger

Optional pixel width for the converted output.default: 0

x1integer

Left crop coordinate in source pixels.default: 0

x2integer

Right crop coordinate in source pixels.default: 0

y1integer

Top crop coordinate in source pixels.default: 0

y2integer

Bottom crop coordinate in source pixels.default: 0

fetchFetch a URL and return content. - Images return as FastMCP Image. - PDFs return as File(format="pdf"). - Text/JSON return as a JSON payload with metadata and text.1 params

Fetch a URL and return content. - Images return as FastMCP Image. - PDFs return as File(format="pdf"). - Text/JSON return as a JSON payload with metadata and text.

Parameters* required

url*string

HTTP or HTTPS URL to retrieve and normalize.

searchSimple web search using DuckDuckGo HTML endpoint. Returns a list of {title, url, snippet} objects. Best‑effort parsing.2 params

Simple web search using DuckDuckGo HTML endpoint. Returns a list of {title, url, snippet} objects. Best‑effort parsing.

Parameters* required

max_resultsinteger

Maximum number of results to return (1-10).default: 5

query*string

Search keywords to send to DuckDuckGo.

Configuration

TWEEKIT_API_KEYsecret

TweekIT API key issued from the TweekIT account portal (optional when targeting a loopback NOAUTH Miner Renderery via TWEEKIT_MINER_NOAUTH=1).

TWEEKIT_API_SECRETsecret

API secret paired with TWEEKIT_API_KEY for authenticated conversions (optional when TWEEKIT_MINER_NOAUTH=1 is enabled on loopback).

TWEEKIT_API_BASE_URL

Optional TweekIT API or On-Premises Miner Renderery URL (e.g., http://127.0.0.1:16377/api/image/ for localhost processing).

TWEEKIT_MINER_LOCAL

Optional 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_ONLY

Optional flag ('1' or '0'). When '1', enforces localhost/on-prem Miner Renderery routing and blocks third-party cloud egress.

TWEEKIT_MINER_NOAUTH

Optional flag ('1' or '0'). When '1', allows loopback Miner Renderery requests without cloud API credentials.

TWEEKIT_ONPREM_HOSTS

Optional comma-separated list of trusted private LAN Miner Renderery hostnames or IPs permitted under TWEEKIT_LOCAL_ONLY=1.

TWEEKIT_REQUIRE_LOCAL_MINER_FOR_FILES

Optional flag ('1' or '0'). When '1', convert_file refuses to upload local files unless routed to a local or on-prem Miner Renderery.

Readme