ediFabric EDI — Claude Code MCP server: features and setup
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.
no license ★ 1 updated 2026-11-13
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/mcpWhat ediFabric EDI 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.
What it helps with
- 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 for the agent
- Validate
claims.837at SNIP level 4 and explain the errors. - Create 999 acknowledgments for the files in the inbound folder.
- Turn
po.ediinto JSON, change the quantity on line two, then build an X12 file.
How to install ediFabric EDI
Platform CLI
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/mcpReplace <…> with your own values
Platform CLI
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/mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ediFabric EDI
How do I install ediFabric EDI in Claude Code?
Run claude mcp add edifabric-mcp -e EDIFABRIC_SERIAL=<EDIFABRIC_SERIAL> -e EDIFABRIC_TOKEN=<EDIFABRIC_TOKEN> -- npx -y @edifabric/mcp. Node.js 18 or later and an ediFabric serial are required.
What does ediFabric EDI do?
It converts X12 and HIPAA EDI files to JSON and back, validates them, and creates 997 or 999 acknowledgments. It can also split transaction sets and describe their structures.
Do EDI files leave the machine?
The server reads and writes files locally and returns summaries to the assistant. EdiNation receives transaction types and versions for its standard models, not the file contents.