Connect Tinypng to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the resize image tool in Tinypng
Use the save to cloud storage tool in Tinypng
Use the convert image tool in Tinypng
Use the compress image tool in Tinypng
Use the get compression count tool in Tinypng
Supported Tools
resize_image
Resize Image
Compress and resize an image in one step. First compresses the source image via TinyPNG, then resizes it using the specified method. Supports four resize methods: **scale** (proportional by width or height), **fit** (fit within dimensions), **cover** (fill exact dimensions with intelligent cropping), and **thumb** (advanced cover with cut-out detection). Optionally convert format and preserve metadata in the same request.
save_to_cloud
Save to Cloud Storage
Compress an image and save it directly to Amazon S3 or Google Cloud Storage. Combines compression with cloud upload in a single operation. Optionally resize, convert format, and preserve metadata before uploading. Supports the documented Cache-Control storage header. Existing target objects can be overwritten; usage and cloud effects are retained.
convert_image
Convert Image
Compress and convert an image to a different format. Supports converting between AVIF, WebP, JPEG, and PNG. You can specify a single target format, multiple formats (the smallest result is returned), or use "*/*" to get the smallest among all supported formats. Optionally fill transparent backgrounds with a color when converting to non-transparent formats like JPEG.
compress_image
Compress Image
Compress an image using TinyPNG's lossy compression engine. Supports AVIF, WebP, JPEG, and PNG formats. The image type is automatically detected and optimized with the appropriate engine. Provide a publicly accessible URL to the image. Returns a downloadable optimized image and available compression statistics. You can optionally preserve metadata (copyright, creation date, GPS location) in the compressed output.
get_compression_count
Get Compression Count
Retrieve the number of compressions performed during the current calendar month. Uses the documented empty validation request without submitting an image. It does not identify the account owner or guarantee remaining quota.
Enable Tinypng in Metorial. In your Metorial portal, enable the Tinypng MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Tinypng tools.
Enable Tinypng in Metorial. In your Metorial portal, enable the Tinypng MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Tinypng tools.
Enable Tinypng in Metorial. In your Metorial portal, enable the Tinypng MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Tinypng tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Tinypng in Metorial. In your Metorial portal, enable the Tinypng MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Tinypng tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Tinypng in Metorial. In your Metorial portal, enable the Tinypng MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Tinypng tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Tinypng through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Tinypng and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Tinypng tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Compress AVIF, WebP, JPEG, and PNG images using lossy compression while preserving visual quality. Resize images using scale, fit, cover, and thumb methods. Convert images between AVIF, WebP, JPEG, and PNG formats. Preserve image metadata such as copyright, creation date, and GPS location. Save optimized images directly to Amazon S3 or Google Cloud Storage buckets. Track monthly compression usage.
Frequently asked questions
Common questions about connecting Tinypng to AI agents with Metorial.
How many tools does the Tinypng MCP server have?
The Tinypng MCP server exposes 5 tools, including Resize Image, Save to Cloud Storage, Convert Image. Each one is governed and traced through Metorial.
Does the Tinypng MCP server support triggers?
Tinypng exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Tinypng MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Tinypng MCP server through the same Metorial URL.
How do I give only some teams access to Tinypng?
Use role-based access control to decide which teams, users, and agents can use Tinypng and which of its tools they can call.
Can I self-host the Tinypng MCP server?
Yes. Metorial is open source, so you can run the Tinypng MCP server yourself or use the hosted gateway.
Connect Tinypng to production AI agents
See how Metorial gives your team governed access to Tinypng, with tracing and security controls built in.