// MCP server

MCP server — give your agent an EDI toolkit.

SignalEDI MCP is the agent-facing integration control plane over the hosted REST data plane. Current public installs remain pinned to v0.4.0 and must use synthetic data only; its published Unix executable does not launch through npx. Hardened v0.5.0 fixes that launcher and adds default keyless docs, an isolated-sandbox profile, and a fail-closed production profile with allowlisted reads and guarded outbound/QuickBooks Online export operations. It remains pending npm and MCP Registry release proof.

The 18 tools below describe public v0.4 discovery, not the v0.5 production surface. Version 0.5 filters tools by profile: production exposes 15 local-guidance, kit, transaction/QuickBooks Online status read, outbound-send, and QuickBooks Online export tools; parse/validate, QuickBooks Online entity browsing, sync, and disconnect remain hidden.

Canonical package: @signaledi/mcp-server. Live npm is the last verified release (v0.4.0). Hardened v0.5.0 remains pending npm and MCP Registry proof. Public v0.4 is for synthetic evaluation only.

  • parse_edi — Raw X12 → structured JSON + validation summary.
  • validate_edi — Validate an interchange against X12 structural rules.
  • generate_test_document — Generate local synthetic 850/810/856/837 samples without credentials.
  • explain_edi_error — Local dictionary lookup for ack/validation errors.
  • lookup_x12 — Search segment and acknowledgement reference.
  • send_outbound_document — Serialize JSON to EDI and request an outbound partner send.
  • list_transactions — List recent transactions, scoped to the key.
  • get_transaction — Fetch one transaction with full lifecycle status.
  • quickbooks_status — QuickBooks Online connection status for your workspace (no tokens returned).
  • quickbooks_sync_to_qbo — Push EDI transactions into QuickBooks (810→Invoice, 850→Bill).
  • quickbooks_export_to_edi — Pull QuickBooks Online entities and emit outbound EDI to a partner.
  • quickbooks_list_entities — List QuickBooks Online Invoice, PO, Customer, Vendor, or Item rows.
  • quickbooks_disconnect — Revoke QuickBooks Online OAuth and remove the workspace connection.
  • list_partner_kits — List generic API-kit catalog entries; these are not partner implementation guides.
  • get_partner_kit — Fetch one kit by id (endpoints, webhooks, sample payloads).
  • validate_x12_structure — Alias for validate_edi — spec-facing discovery name.
  • parse_segments — Alias for parse_edi — spec-facing discovery name.
  • lookup_element_definition — Alias for lookup_x12 — search by element or segment.

Documented configuration examples: Claude Code, Cursor, VS Code. Registry id io.github.SignalEDI/mcp-server.

Create a platform key →API usage and MCP billing →SDK examples →

Known v0.4 limitation: its published Unix executable does not launch through npx. These pinned methods are for synthetic evaluation on a verified Windows host; wait for the verified v0.5 release before macOS or Linux use.

Cursor config (Windows)Open Cursor configuration
Claude Code CLI (Windows)claude mcp add signaledi -- cmd /c npx -y @signaledi/mcp-server@0.4.0
Config JSON{ "mcpServers": { "signaledi": { "command": "npx", "args": [ "-y", "@signaledi/mcp-server@0.4.0" ], "env": {} } } }
Get an API keyAPI reference →

Install from npm; do not clone internal source to run the adapter.

.mcp.json
{
  "mcpServers": {
    "signaledi": {
      "command": "npx",
      "args": ["-y", "@signaledi/mcp-server@0.4.0"]
    }
  }
}