Skip to content
MCP server

Mime

MCP server that maps filenames and extensions to MIME types and back, offline

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/mime/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mime": {
      "url": "https://gateway.pipeworx.io/mime/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers