Skip to content

TweekIT MCP Server

by equilibrium-team · remote · no sign-in to list tools · v1.6.1 · published by GitHub user equilibrium-team

Normalize and convert more than 400 file types via TweekIT's hosted MCP streamable HTTP endpoint.

Changes · 2
CompareRegistry entry

5 tools: 2 change things and 3 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http tweekit https://mcp.tweekit.io/mcp --header 'ApiKey: <your-apikey>' --header 'ApiSecret: <your-apisecret>'

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

5 tools

Changes things 2Claude Code: ask
  • convertConvert an uploaded document payload with TweekIT.No findings

    Why it is in this group

    • The name "convert" says "convert": a word for a change.
    Description, as the server wrote it
    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: Source file extension such as `pdf`, `docx`, or `png`. outfmt: Desired output format (`Fmt` in the API body). blob: Base64 encoded document payload (`DocData`). apiKey: TweekIT API key (`ApiKey` header). Falls back to `TWEEKIT_API_KEY` env var. apiSecret: TweekIT API secret (`ApiSecret` header). Falls back to `TWEEKIT_API_SECRET` env var. noRasterize: Forwarded to TweekIT to skip rasterization when possible. width: Optional pixel width to request in the output. height: Optional pixel height to request in the output. x1: Left crop coordinate in source pixels. y1: Top crop coordinate in source pixels. x2: Right crop coordinate in source pixels. y2: Bottom crop coordinate in source pixels. page: Page number to extract for multipage inputs. alpha: Whether the output should preserve alpha transparency. bgColor: Background color to composite behind transparent pixels. Returns: A FastMCP `Image` or `File` payload, or an error description.
  • convert_urlDownload a remote file and convert it with TweekIT in one step.No findings

    Why it is in this group

    • The name "convert_url" says "convert": a word for a change.
    Description, as the server wrote it
    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: Direct download URL for the source document or image. outfmt: Desired output format (`Fmt`). apiKey: TweekIT API key (`ApiKey` header). Falls back to `TWEEKIT_API_KEY` env var. apiSecret: TweekIT API secret (`ApiSecret` header). Falls back to `TWEEKIT_API_SECRET` env var. inext: Optional override for the source extension if it cannot be detected from the URL or response headers. noRasterize: Forwarded to TweekIT to skip rasterization when possible. width: Optional pixel width to request in the output. height: Optional pixel height to request in the output. x1: Left crop coordinate in source pixels. y1: Top crop coordinate in source pixels. x2: Right crop coordinate in source pixels. y2: Bottom crop coordinate in source pixels. page: Page number to extract for multipage inputs. alpha: Whether the output should preserve alpha transparency. bgColor: Background color to composite behind transparent pixels. fetchHeaders: Optional mapping of HTTP headers to include when fetching. Returns: A FastMCP `Image` or `File` payload, or an error description.
Only reads 3Claude Code: allow
  • doctypeRetrieve a list of supported file formats or map a file extension to its document type.No findings

    Why it is in this group

    • The description's first verb is "retrieve": a word for reading.
    Description, as the server wrote it
    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 omitted. extension (str): The file extension to query (e.g., 'jpg', 'pdf') or leave off or use '*' to return all supported input formats. Returns: Dict[str, Any]: A dictionary containing the supported file formats or an error message.
  • fetchFetch a URL and return content.No findings

    Why it is in this group

    • The name "fetch" says "fetch": a word for reading.
    Description, as the server wrote it
    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.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.6.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http tweekit https://mcp.tweekit.io/mcp --header 'ApiKey: <your-apikey>' --header 'ApiSecret: <your-apisecret>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__tweekit__doctype",
      "mcp__tweekit__fetch",
      "mcp__tweekit__search"
    ],
    "ask": [
      "mcp__tweekit__convert",
      "mcp__tweekit__convert_url"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as tweekit. Review it before you use it.