TweekIT MCP Server

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.

{
  "type": "object",
  "properties": {
    "apiKey": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted."
    },
    "apiSecret": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted."
    },
    "extension": {
      "default": "*",
      "description": "File extension to inspect; use '*' to list all supported inputs.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "inext": {
      "description": "Input file extension (e.g., pdf, docx, png).",
      "type": "string"
    },
    "outfmt": {
      "description": "Requested output format to send as Fmt.",
      "type": "string"
    },
    "blob": {
      "description": "Base64 encoded document payload (DocData).",
      "type": "string"
    },
    "apiKey": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted."
    },
    "apiSecret": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted."
    },
    "noRasterize": {
      "default": false,
      "description": "Forward to TweekIT to disable rasterization when supported.",
      "type": "boolean"
    },
    "width": {
      "default": 0,
      "description": "Optional pixel width for the converted output.",
      "type": "integer"
    },
    "height": {
      "default": 0,
      "description": "Optional pixel height for the converted output.",
      "type": "integer"
    },
    "x1": {
      "default": 0,
      "description": "Left crop coordinate in source pixels.",
      "type": "integer"
    },
    "y1": {
      "default": 0,
      "description": "Top crop coordinate in source pixels.",
      "type": "integer"
    },
    "x2": {
      "default": 0,
      "description": "Right crop coordinate in source pixels.",
      "type": "integer"
    },
    "y2": {
      "default": 0,
      "description": "Bottom crop coordinate in source pixels.",
      "type": "integer"
    },
    "page": {
      "default": 1,
      "description": "Page number to convert for multi-page inputs.",
      "type": "integer"
    },
    "alpha": {
      "default": true,
      "description": "Preserve alpha transparency when producing raster formats.",
      "type": "boolean"
    },
    "bgColor": {
      "default": "",
      "description": "Background color (hex RGB) to composite behind transparent pixels.",
      "type": "string"
    }
  },
  "required": [
    "inext",
    "outfmt",
    "blob"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "Direct download URL for the source document or image.",
      "type": "string"
    },
    "outfmt": {
      "description": "Requested output format to send as Fmt.",
      "type": "string"
    },
    "apiKey": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted."
    },
    "apiSecret": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted."
    },
    "inext": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Override for the detected input extension (e.g., pdf)."
    },
    "noRasterize": {
      "default": false,
      "description": "Forward to TweekIT to disable rasterization when supported.",
      "type": "boolean"
    },
    "width": {
      "default": 0,
      "description": "Optional pixel width for the converted output.",
      "type": "integer"
    },
    "height": {
      "default": 0,
      "description": "Optional pixel height for the converted output.",
      "type": "integer"
    },
    "x1": {
      "default": 0,
      "description": "Left crop coordinate in source pixels.",
      "type": "integer"
    },
    "y1": {
      "default": 0,
      "description": "Top crop coordinate in source pixels.",
      "type": "integer"
    },
    "x2": {
      "default": 0,
      "description": "Right crop coordinate in source pixels.",
      "type": "integer"
    },
    "y2": {
      "default": 0,
      "description": "Bottom crop coordinate in source pixels.",
      "type": "integer"
    },
    "page": {
      "default": 1,
      "description": "Page number to convert for multi-page inputs.",
      "type": "integer"
    },
    "alpha": {
      "default": true,
      "description": "Preserve alpha transparency when producing raster formats.",
      "type": "boolean"
    },
    "bgColor": {
      "default": "",
      "description": "Background color (hex RGB) to composite behind transparent pixels.",
      "type": "string"
    },
    "fetchHeaders": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional HTTP headers to include when downloading the URL."
    }
  },
  "required": [
    "url",
    "outfmt"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "HTTP or HTTPS URL to retrieve and normalize.",
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

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

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search keywords to send to DuckDuckGo.",
      "type": "string"
    },
    "max_results": {
      "default": 5,
      "description": "Maximum number of results to return (1-10).",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "additionalProperties": true
}