protogrid

Search / io.github.equilibrium-team/tweekit

TweekIT MCP Server

R1· needs a key

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

v1.6.1 · active · repository · website · descriptor JSON · versions

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.
Quality76good
Trust86of 100
Uptime, 30 days100%
Latency p50280 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "tweekit": {
      "type": "http",
      "url": "https://mcp.tweekit.io/mcp",
      "headers": {
        "ApiKey": "${APIKEY}",
        "ApiSecret": "${APISECRET}",
        "Authorization": "${APIKEY}"
      }
    }
  }
}
claude mcp add --transport http tweekit https://mcp.tweekit.io/mcp --header "ApiKey: ${APIKEY}" --header "ApiSecret: ${APISECRET}" --header "Authorization: ${APIKEY}"
[mcp_servers.tweekit]
url = "https://mcp.tweekit.io/mcp"
env_http_headers = { "ApiKey" = "APIKEY", "ApiSecret" = "APISECRET", "Authorization" = "APIKEY" }
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tweekit": {
      "type": "remote",
      "url": "https://mcp.tweekit.io/mcp",
      "enabled": true,
      "headers": {
        "ApiKey": "{env:APIKEY}",
        "ApiSecret": "{env:APISECRET}",
        "Authorization": "{env:APIKEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "tweekit": {
      "type": "http",
      "url": "https://mcp.tweekit.io/mcp",
      "headers": {
        "ApiKey": "${APIKEY}",
        "ApiSecret": "${APISECRET}",
        "Authorization": "${APIKEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=tweekit&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnR3ZWVraXQuaW8vbWNwIiwiaGVhZGVycyI6eyJBcGlLZXkiOiIke0FQSUtFWX0iLCJBcGlTZWNyZXQiOiIke0FQSVNFQ1JFVH0iLCJBdXRob3JpemF0aW9uIjoiJHtBUElLRVl9In19"
}
{
  "servers": {
    "tweekit": {
      "type": "http",
      "url": "https://mcp.tweekit.io/mcp",
      "headers": {
        "ApiKey": "${APIKEY}",
        "ApiSecret": "${APISECRET}",
        "Authorization": "${APIKEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "tweekit": {
      "httpUrl": "https://mcp.tweekit.io/mcp",
      "headers": {
        "ApiKey": "${APIKEY}",
        "ApiSecret": "${APISECRET}",
        "Authorization": "${APIKEY}"
      }
    }
  }
}
extensions:
  "tweekit":
    enabled: true
    name: "tweekit"
    type: streamable_http
    uri: "https://mcp.tweekit.io/mcp"
    headers:
      "ApiKey": "${APIKEY}"
      "ApiSecret": "${APISECRET}"
      "Authorization": "${APIKEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${APIKEY}, ${APISECRET}, ${APIKEY}. The registry never accepts secret values.

Quality 76 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene64 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length2 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno 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_costabout 2,070 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

5 tools, about 2,070 tokens to load them all · tool set dcc72443b435 · checked 2026-10-20 09:31 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 86 / 100

provenance90
liveness100
freshness45
hygiene100

+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. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.tweekit.io/mcp streamable-httpapi_key ${APIKEY}yes100%280 ms2025-06-182026-10-20

Tools (5)

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.
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.
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.
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.
searchSimple web search using DuckDuckGo HTML endpoint. Returns a list of {title, url, snippet} objects. Best‑effort parsing.

Schemas: list_tools.

Also listed as

1 other active names share this repository: io.tweekit/mcp

Similar MCP servers

Official server.json
{
  "name": "io.github.equilibrium-team/tweekit",
  "title": "TweekIT MCP Server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.tweekit.io/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "ApiKey",
          "format": "string",
          "isSecret": true,
          "isRequired": true,
          "description": "TweekIT API key issued from the TweekIT account portal."
        },
        {
          "name": "ApiSecret",
          "format": "string",
          "isSecret": true,
          "isRequired": true,
          "description": "API secret paired with the ApiKey for authenticated conversions."
        }
      ]
    }
  ],
  "version": "1.6.1",
  "repository": {
    "id": "1032125130",
    "url": "https://github.com/equilibrium-team/tweekit-mcp",
    "source": "github"
  },
  "websiteUrl": "https://www.tweekit.io/",
  "description": "Normalize and convert more than 400 file types via TweekIT's hosted MCP streamable HTTP endpoint."
}