# TweekIT MCP Server MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-equilibrium-team-tweekit
- Repository: https://github.com/equilibrium-team/tweekit-mcp
- Website: https://www.tweekit.io/

## Install
- Endpoint: https://mcp.tweekit.io/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: ApiKey (required; secret)
- Remote header: ApiSecret (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.tweekit.io/mcp
- Header: ApiKey
- Header: ApiSecret

## Tools
- doctype - 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. Endpoint: https://mcp.tweekit.io/mcp
- convert - 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. Endpoint: https://mcp.tweekit.io/mcp
- convert_url - 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. Endpoint: https://mcp.tweekit.io/mcp
- fetch - 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. Endpoint: https://mcp.tweekit.io/mcp
- search - Simple web search using DuckDuckGo HTML endpoint.

Returns a list of {title, url, snippet} objects. Best‑effort parsing. Endpoint: https://mcp.tweekit.io/mcp

## Resources
- config://tweekit-version - Get current version of the TweekIT API. MIME type: text/plain
- config://tweekit-mcp-version - Return the TweekIT MCP server version. MIME type: text/plain

## Prompts
Not captured

## Metadata
- Owner: io.github.equilibrium-team
- Version: 1.6.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Dec 1, 2025
- Source: https://registry.modelcontextprotocol.io