Skip to content
MCP server

ediFabric EDI

Validate, parse, build and acknowledge X12 and HIPAA EDI files locally

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, Windows, macOS
Runs
Locally
Version
1.0.1
Listing updated
3 days ago

About ediFabric EDI

ediFabric EDI is a freemium MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • EDIFABRIC_SERIALYour ediFabric serial key. Without it, the server uses the demo serial, which has a small daily quota.
  • EDIFABRIC_ALLOWED_DIRSFolders the tools may read and write, separated by ; on Windows and : elsewhere. Defaults to the client's roots or the home folder.
  • EDIFABRIC_MAPPath to a map.json with local or custom models.
  • EDIFABRIC_OFFLINESet to true to use only the models in EDIFABRIC_MAP.
  • EDIFABRIC_TOKENA token issued for you, for machines without internet access.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Demo serial with a small daily quota; licensed serial key removes it. Prices not in the content.

Prices change. Check edifabric.com before you buy.

ediFabric EDI 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 to ediFabric EDI

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools