# OpenFormatDB

> OpenFormatDB is an open-source MCP server for files and documents. Identify a file, look up its format and convert it locally with WebAssembly engines. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://openformatdb.org/agents/
- **Repository:** https://github.com/openformatdb/openformatdb/tree/HEAD/packages/mcp
- **MCP Registry name:** org.openformatdb/openformatdb
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

Before an agent writes a parser or reverse engineers a file, this server tells it what the file probably is and what software already handles it. identify_file ranks candidate formats from the first bytes, MIME type and extension, and the agent reads the bytes itself so the file never leaves the machine. lookup_format and search_formats return records with identifiers (including PRONOM and Wikidata ids), open-source software first, grammars, specifications and versions.

find_conversion returns the cheapest chains of open tools between two formats, lossless first, with each step's command and what is lost. convert_file runs conversions locally with ImageMagick, resvg, FFmpeg, Pandoc, 7-Zip, GDAL and Assimp compiled to WebAssembly. Engines of 2 to 59 MB are downloaded once, pinned and SHA-256 checked, and output is written next to the input without overwriting.

Two write tools, claim_format and publish_findings, edit YAML records in a repository checkout and print the git commands for a pull request; they never run git. Text is screened against a policy that excludes DRM removal, keys and copies of paywalled standards. Without a checkout the server reads the site's static API read-only. It needs Node 22.18 or later.

## Features

- **File identification:** Ranks candidate formats from magic bytes, MIME type and extension.
- **Format records:** Returns identifiers, software, grammars, specification and versions.
- **Conversion chains:** Finds the cheapest chain of open tools with commands and losses.
- **Local conversion:** Converts files with WebAssembly engines without uploading anything.
- **Claim a format:** Reserves a format for up to 90 days so work is not duplicated.
- **Publish findings:** Merges structure and tool findings into the record via a pull request.

## Good for

- Work out what an unknown file is before parsing it
- Convert a file between formats without uploading it
- Find open tools that read an obscure format
- Contribute documentation for an undocumented format

## Install

### Claude Code (Terminal)

```sh
claude mcp add openformatdb -- npx -y @openformatdb/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "openformatdb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}
```

## Tools

- `identify_file`: Candidate formats from the first bytes, MIME type and name
- `lookup_format`: Full record: identifiers, software, grammars, specification, family and versions, claims, advice
- `search_formats`: Search by name, alias, extension, MIME type, PRONOM or Wikidata id
- `find_conversion`: Cheapest chains of open tools between two formats, with commands and losses
- `convert_file`: Converts a file locally with WebAssembly engines; nothing is uploaded
- `list_sources`: Aggregated sources with counts, licences and snapshot dates
- `claim_format`: Declares you are documenting a format for up to 90 days
- `publish_findings`: Merges structure, grammars, tools, conversions and verification into the record

## FAQ

### Does the file get uploaded?

No. The agent reads the bytes locally and convert_file runs on your machine; only the engine's first download uses the network.

### Which converters are used?

ImageMagick, resvg, FFmpeg, Pandoc, 7-Zip, GDAL and Assimp compiled to WebAssembly.

### Can it overwrite my files?

No. Converted output is written next to the input and never overwrites.

### How do I install it?

Run npx -y @openformatdb/mcp, or add it to Claude Code with claude mcp add.

### Can it edit the database?

Only from a repository clone, where it edits YAML records and prints git commands for a pull request.

### Is OpenFormatDB free?

Yes. OpenFormatDB is open source, so you can use and self-host it for free.

### How do I add OpenFormatDB to Claude Code?

Run this command in your terminal: claude mcp add openformatdb -- npx -y @openformatdb/mcp

### What are the best alternatives to OpenFormatDB?

The closest alternatives to OpenFormatDB are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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