# ediFabric EDI

The ediFabric EDI MCP server for Claude Code handles X12 and HIPAA EDI files, converting, validating and building them. It can also produce 997 and 999 acknowledgments.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: EdiFabric
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/EdiFabric/edifabric-mcp
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/edifabric-edi

## What it does

The server turns EDI files into JSON and builds EDI files from JSON. It can validate files, split them into transaction sets, describe segment structures, and create 997 or 999 acknowledgments for X12; a TA1 can accompany an acknowledgment when the interchange requests one.

Files are read and written on the local machine, while the assistant receives summaries. The server needs Node.js 18 or later and an ediFabric serial. Without `EDIFABRIC_SERIAL`, it falls back to a demo serial with a small daily quota, which is not intended for production. Standard X12 and HIPAA models are fetched from EdiNation by default; that service receives transaction types and versions, not file contents.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `EDIFABRIC_SERIAL`, `EDIFABRIC_ALLOWED_DIRS`, `EDIFABRIC_MAP`, `EDIFABRIC_OFFLINE`, `EDIFABRIC_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env EDIFABRIC_SERIAL=<EDIFABRIC_SERIAL> --env EDIFABRIC_ALLOWED_DIRS=<EDIFABRIC_ALLOWED_DIRS> --env EDIFABRIC_MAP=<EDIFABRIC_MAP> --env EDIFABRIC_OFFLINE=<EDIFABRIC_OFFLINE> --env EDIFABRIC_TOKEN=<EDIFABRIC_TOKEN> --transport stdio edifabric-edi -- npx -y @edifabric/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add edifabric-edi --env EDIFABRIC_SERIAL=<EDIFABRIC_SERIAL> --env EDIFABRIC_ALLOWED_DIRS=<EDIFABRIC_ALLOWED_DIRS> --env EDIFABRIC_MAP=<EDIFABRIC_MAP> --env EDIFABRIC_OFFLINE=<EDIFABRIC_OFFLINE> --env EDIFABRIC_TOKEN=<EDIFABRIC_TOKEN> -- npx -y @edifabric/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "edifabric-edi": {
            "command": "npx",
            "args": [
                "-y",
                "@edifabric/mcp"
            ],
            "env": {
                "EDIFABRIC_SERIAL": "<EDIFABRIC_SERIAL>",
                "EDIFABRIC_ALLOWED_DIRS": "<EDIFABRIC_ALLOWED_DIRS>",
                "EDIFABRIC_MAP": "<EDIFABRIC_MAP>",
                "EDIFABRIC_OFFLINE": "<EDIFABRIC_OFFLINE>",
                "EDIFABRIC_TOKEN": "<EDIFABRIC_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "edifabric-edi": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@edifabric/mcp"
            ],
            "env": {
                "EDIFABRIC_SERIAL": "<EDIFABRIC_SERIAL>",
                "EDIFABRIC_ALLOWED_DIRS": "<EDIFABRIC_ALLOWED_DIRS>",
                "EDIFABRIC_MAP": "<EDIFABRIC_MAP>",
                "EDIFABRIC_OFFLINE": "<EDIFABRIC_OFFLINE>",
                "EDIFABRIC_TOKEN": "<EDIFABRIC_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e EDIFABRIC_SERIAL=<EDIFABRIC_SERIAL> -e EDIFABRIC_ALLOWED_DIRS=<EDIFABRIC_ALLOWED_DIRS> -e EDIFABRIC_MAP=<EDIFABRIC_MAP> -e EDIFABRIC_OFFLINE=<EDIFABRIC_OFFLINE> -e EDIFABRIC_TOKEN=<EDIFABRIC_TOKEN> edifabric-edi npx -y @edifabric/mcp
```
Replace <…> with your own values

## When to use it
- convert an EDI file to JSON
- validate a HIPAA file at SNIP level 4 and inspect its errors
- create 997 or 999 acknowledgments for X12
- split a file into separate transaction sets
- build an EDI file from JSON

## Example prompts
- Validate `claims.837` at SNIP level 4 and explain the errors.
- Create 999 acknowledgments for the files in the inbound folder.
- Turn `po.edi` into JSON, change the quantity on line two, then build an X12 file.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
