# ediFabric EDI

> ediFabric EDI is a freemium MCP server for files and documents. Validate, parse, build and acknowledge X12 and HIPAA EDI files locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://www.edifabric.com/docs/edifabric-native/introduction.html
- **Repository:** https://github.com/edifabric/edifabric-mcp
- **MCP Registry name:** com.edifabric/edifabric-mcp
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

This server wraps ediFabric Native, a compiled native EDI engine, so files are processed on your own machine and only folders you allow are readable or writable. An environment variable limits the folders, another points to a map.json with custom models, and an offline mode restricts it to those local models.

The tools cover the main EDI chores. parse_edi converts a file to JSON and summarises interchanges and transaction sets, validate_edi checks up to HIPAA SNIP level 4 and reports each error with its segment, acknowledge_edi saves a 999 or 997 with a TA1 when asked, and build_edi converts JSON back to EDI. split_edi saves each transaction set as its own file, describe_spec shows loops and segments with their JSON names, and get_status shows the licence and allowed folders.

Without a serial key it uses a demo serial with a small daily quota. Setup helpers include set_serial, set_token and set_map.

## Features

- **EDI to JSON:** parse_edi converts a file and summarises its contents.
- **HIPAA SNIP validation:** Validates up to level 4 and lists errors by segment.
- **Acknowledgments:** Saves 999 or 997 files, with TA1 when needed.
- **Build and split:** Convert JSON to EDI or split transaction sets into files.
- **Spec descriptions:** Shows loops and segments with JSON property names.
- **Local folders only:** Reads and writes only allowed directories.

## Good for

- Validate a claim or purchase-order file before sending
- Convert X12 into JSON for a pipeline
- Generate acknowledgments for received files
- Inspect a transaction set's structure

## Install

### Claude Code (Terminal)

```sh
claude mcp add edifabric-mcp --env EDIFABRIC_SERIAL='<EDIFABRIC_SERIAL>' --env EDIFABRIC_TOKEN='<EDIFABRIC_TOKEN>' -- npx -y @edifabric/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "edifabric-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edifabric/mcp"
      ],
      "env": {
        "EDIFABRIC_SERIAL": "<EDIFABRIC_SERIAL>",
        "EDIFABRIC_TOKEN": "<EDIFABRIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "edifabric-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edifabric/mcp"
      ],
      "env": {
        "EDIFABRIC_SERIAL": "<EDIFABRIC_SERIAL>",
        "EDIFABRIC_TOKEN": "<EDIFABRIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "edifabric-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@edifabric/mcp"
      ],
      "env": {
        "EDIFABRIC_SERIAL": "<EDIFABRIC_SERIAL>",
        "EDIFABRIC_TOKEN": "<EDIFABRIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "edifabric-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edifabric/mcp"
      ],
      "env": {
        "EDIFABRIC_SERIAL": "<EDIFABRIC_SERIAL>",
        "EDIFABRIC_TOKEN": "<EDIFABRIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "edifabric-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edifabric/mcp"
      ],
      "env": {
        "EDIFABRIC_SERIAL": "<EDIFABRIC_SERIAL>",
        "EDIFABRIC_TOKEN": "<EDIFABRIC_TOKEN>"
      }
    }
  }
}
```

## Tools

- `parse_edi`: Converts an EDI file to JSON, saves it and summarises interchanges and transaction sets.
- `validate_edi`: Validates an EDI file up to HIPAA SNIP level 4 and returns each error with its segment.
- `acknowledge_edi`: Saves a 999 or 997 for an X12 file, with a TA1 when requested.
- `build_edi`: Converts EDI JSON to an EDI file.
- `split_edi`: Saves each transaction set as its own EDI file.
- `describe_spec`: Describes a transaction set's loops and segments.
- `get_status`: Shows the licence, model sources and allowed folders.

## FAQ

### Does it work offline?

With EDIFABRIC_OFFLINE set it uses only the models in your map file.

### What if I have no licence?

It uses a demo serial with a small daily quota.

### Where do files go?

Processing is local and limited to the folders you allow.

### Is ediFabric EDI free?

ediFabric EDI has a free plan, with paid plans for more usage or features.

### How do I add ediFabric EDI to Claude Code?

Run this command in your terminal: claude mcp add edifabric-mcp --env EDIFABRIC_SERIAL='<EDIFABRIC_SERIAL>' --env EDIFABRIC_TOKEN='<EDIFABRIC_TOKEN>' -- npx -y @edifabric/mcp

### What are the best alternatives to ediFabric EDI?

The closest alternatives to ediFabric EDI 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/edifabric-edi
