TweekIT MCP Server
Normalize and convert more than 400 file types via TweekIT's hosted MCP streamable HTTP endpoint.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"tweekit": {
"url": "https://mcp.tweekit.io/mcp"
}
}
}Remote endpoints
https://mcp.tweekit.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢doctype(apiKey, apiSecret, extension)
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.
Input Schema
{
"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"
}
}
}Output Schema
{
"type": "object",
"additionalProperties": true
}🟡convert(inext, outfmt, blob, apiKey, apiSecret, ...)
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.
Input Schema
{
"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"
]
}🟢convert_url(url, outfmt, apiKey, apiSecret, inext, ...)
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.
Input Schema
{
"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(url)
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.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "HTTP or HTTPS URL to retrieve and normalize.",
"type": "string"
}
},
"required": [
"url"
]
}🟢search(query, max_results)
Simple web search using DuckDuckGo HTML endpoint. Returns a list of {title, url, snippet} objects. Best‑effort parsing.
Input Schema
{
"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"
]
}Output Schema
{
"type": "object",
"additionalProperties": true
}Community
Evidence