
Mime
MCP server that maps filenames and extensions to MIME types and back, offline
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Mime
Mime is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
The README describes this as a MIME type lookup server built on the Pipeworx gateway. It exposes two tools: one takes a filename or bare extension and returns its media type, the other goes the opposite direction and lists the extensions associated with a MIME type. Lookups run against a built-in table of common types, so they need no API key and no network call to an upstream service.
The server can be reached in three ways: a hosted streamable-HTTP endpoint on the Pipeworx gateway, a stdio bridge installed through npm that forwards calls to that same endpoint, or the TypeScript SDK. The npm bridge is not offline; it needs network access to reach the gateway. Calls without a key are capped at 50 per day, and a free Pipeworx account raises the cap to 200.
The endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the two pack tools, according to the README. Developers who want a narrow tool surface can set an environment variable to hide them in the npm bridge.
Install
Run in a terminal
claude mcp add --transport http mime https://gateway.pipeworx.io/mime/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/mime/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mime": {
"url": "https://gateway.pipeworx.io/mime/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mime": {
"type": "http",
"url": "https://gateway.pipeworx.io/mime/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mime": {
"serverUrl": "https://gateway.pipeworx.io/mime/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mime": {
"type": "http",
"url": "https://gateway.pipeworx.io/mime/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- lookup_mime
- Get the MIME (media) type for a filename or extension.
- extension_for
- Get the file extension(s) for a MIME type.
What it does
- Filename to MIME type
- Returns the media type for a filename or bare extension such as png or photo.png.
- MIME type to extensions
- Lists the file extensions associated with a given MIME type.
- Keyless lookups
- The lookup tools need no API key and are described as working from an inlined table.
- Multiple connection options
- Available as a hosted HTTP endpoint, an npm stdio bridge, or through the TypeScript SDK.
- Optional free account
- A Pipeworx key raises the daily call cap from 50 to 200 for the npm bridge and hosted use.
Good for
- Setting correct Content-Type headers when serving files from an application
- Identifying the media type of an uploaded file from its name in an AI agent workflow
- Finding likely extensions for a MIME type when validating file uploads
- Giving an assistant a quick MIME reference without a web search
Pricing
Freemium
Free anonymous use capped at 50 calls a day; free account raises cap to 200; paid credits for overage
Prices change. Check pipeworx.io before you buy.
Mime FAQ
Does the MIME lookup need an API key?
No. The README and website say both lookup tools are keyless and offline. A Pipeworx key is optional and only raises the daily call cap.
Does the npm package work offline?
No. The README says the npm package is a stdio bridge that forwards every call to the gateway and needs network access.
How many calls are allowed per day?
According to the pricing page, anonymous callers get 50 tool calls a day and registered free accounts get 200.
Are only the two MIME tools listed?
The README says the hosted endpoint also lists about 30 shared gateway meta-tools alongside the pack's tools, and the npm package can hide them.
Is Mime free?
Mime has a free plan, with paid plans for more usage or features.
How do I add Mime to Claude Code?
Run this command in your terminal: claude mcp add --transport http mime https://gateway.pipeworx.io/mime/mcp
What are the best alternatives to Mime?
The closest alternatives to Mime are MIME webp, MIME webm, MIME png, MIME markdown and MIME toml.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.