# TweekIT MCP Server

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

- name: io.github.equilibrium-team/tweekit
- version: 1.6.1
- connection class: R1 (autonomous)
- trust: 86/100
- quality: 76/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.equilibrium-team%2Ftweekit
- tools: https://api.protogrid.dev/v1/servers/io.github.equilibrium-team%2Ftweekit/tools

**An agent can connect on its own if it already holds `APIKEY`, `APISECRET`, `APIKEY`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "tweekit": {
      "type": "http",
      "url": "https://mcp.tweekit.io/mcp",
      "headers": {
        "ApiKey": "${APIKEY}",
        "ApiSecret": "${APISECRET}",
        "Authorization": "${APIKEY}"
      }
    }
  }
}
```

Placeholders to fill: `${APIKEY}`, `${APISECRET}`, `${APIKEY}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 45
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% -stale-322d
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 76/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 64 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 2 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); fetch (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); convert_url (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 2,070 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 5, about 2,070 tokens to load them all
- tool set hash: dcc72443b4354ea7f96bf340d61ba051
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.equilibrium-team/tweekit.svg)](https://protogrid.dev/servers/io.github.equilibrium-team/tweekit)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp.tweekit.io/mcp (streamable-http, auth api_key ${APIKEY}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (5)

- `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.
- `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.
- `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.
- `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.
- `search`: Simple web search using DuckDuckGo HTML endpoint.

Returns a list of {title, url, snippet} objects. Best‑effort parsing.