TweekIT MCP Server
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Normalize and convert more than 400 file types via TweekIT's hosted MCP streamable HTTP endpoint.
| Author | io.github.equilibrium-team |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 212 ms |
| Last measured | 2026-10-26 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"TweekIT MCP Server": {
"url": "https://mcp.tweekit.io/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (5)
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 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.
Parameters:
apiKey— TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted.apiSecret— TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted.extension— string — File extension to inspect; use '*' to list all supported inputs.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
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: 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.
Parameters:
inext(required) — string — Input file extension (e.g., pdf, docx, png).outfmt(required) — string — Requested output format to send as Fmt.blob(required) — string — Base64 encoded document payload (DocData).x1— integer — Left crop coordinate in source pixels.x2— integer — Right crop coordinate in source pixels.y1— integer — Top crop coordinate in source pixels.y2— integer — Bottom crop coordinate in source pixels.page— integer — Page number to convert for multi-page inputs.alpha— boolean — Preserve alpha transparency when producing raster formats.width— integer — Optional pixel width for the converted output.apiKey— TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted.height— integer — Optional pixel height for the converted output.bgColor— string — Background color (hex RGB) to composite behind transparent pixels.apiSecret— TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted.noRasterize— boolean — Forward to TweekIT to disable rasterization when supported.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
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: 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.
Parameters:
url(required) — string — Direct download URL for the source document or image.outfmt(required) — string — Requested output format to send as Fmt.x1— integer — Left crop coordinate in source pixels.x2— integer — Right crop coordinate in source pixels.y1— integer — Top crop coordinate in source pixels.y2— integer — Bottom crop coordinate in source pixels.page— integer — Page number to convert for multi-page inputs.alpha— boolean — Preserve alpha transparency when producing raster formats.inext— Override for the detected input extension (e.g., pdf).width— integer — Optional pixel width for the converted output.apiKey— TweekIT API key passed via the ApiKey header. Defaults to the TWEEKIT_API_KEY environment variable when omitted.height— integer — Optional pixel height for the converted output.bgColor— string — Background color (hex RGB) to composite behind transparent pixels.apiSecret— TweekIT API secret paired with the apiKey. Defaults to the TWEEKIT_API_SECRET environment variable when omitted.noRasterize— boolean — Forward to TweekIT to disable rasterization when supported.fetchHeaders— Optional HTTP headers to include when downloading the URL.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
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.
Parameters:
url(required) — string — HTTP or HTTPS URL to retrieve and normalize.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
searchSimple web search using DuckDuckGo HTML endpoint. Returns a list of {title, url, snippet} objects. Best‑effort parsing.
Parameters:
query(required) — string — Search keywords to send to DuckDuckGo.max_results— integer — Maximum number of results to return (1-10).
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.