# Mime

> Mime is a freemium MCP server for developer tools. MCP server that maps filenames and extensions to MIME types and back, offline. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://pipeworx.io/packs/mime
- **Repository:** https://github.com/pipeworx-io/mcp-mime
- **MCP Registry name:** io.github.pipeworx-io/mime
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mime https://gateway.pipeworx.io/mime/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/mime/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mime": {
      "url": "https://gateway.pipeworx.io/mime/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mime": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/mime/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mime": {
      "serverUrl": "https://gateway.pipeworx.io/mime/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mime": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/mime/mcp"
    }
  }
}
```

## Tools

- `lookup_mime`: Get the MIME (media) type for a filename or extension.
- `extension_for`: Get the file extension(s) for a MIME type.

## 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.

## Alternatives

- [MIME webp](https://ai-powered.com/mcp/mime-webp): MIME webp is an MCP server for developer tools.
- [MIME webm](https://ai-powered.com/mcp/mime-webm): MIME webm is an MCP server for developer tools.
- [MIME png](https://ai-powered.com/mcp/mime-png): MIME png is an MCP server for developer tools.
- [MIME markdown](https://ai-powered.com/mcp/mime-markdown): MIME markdown is an open-source MCP server for files and documents.
- [MIME toml](https://ai-powered.com/mcp/mime-toml): MIME toml is an MCP server for developer tools.
- [MIME plain](https://ai-powered.com/mcp/mime-plain): MIME plain is an MCP server for developer tools.
- [MIME xml](https://ai-powered.com/mcp/mime-xml): MIME xml is an MCP server for developer tools.
- [MIME wav](https://ai-powered.com/mcp/mime-wav): MIME wav is an MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mime
