AI Agents + MCP

Give agents the tools and the EDI runbook.

NeutronEDI's hosted MCP server exposes X12 read, validate, and write tools. The downloadable skills teach agent harnesses when to use each tool, what conventions to follow, and how to recover when documents or requests fail.

Download Skills MCP Setup Docs

Current MCP coverage: X12 only, through `read_x12`, `validate_x12`, and `write_x12`.

Hosted Streamable HTTP MCP

.mcp.json

{
  "mcpServers": {
    "neutron-edi": {
      "type": "http",
      "url": "https://api.neutronedi.com/mcp",
      "headers": {
        "X-API-Key": "${NEUTRON_EDI_API_KEY}"
      }
    }
  }
}

Server URL

https://api.neutronedi.com/mcp

Three Layers

MCP provides capability. Skills provide method.

Keep the primitives separate. The server exposes tools, the skills explain how to use them, and your agent harness orchestrates the work with your API key.

MCP Server

Remote Streamable HTTP tools at https://api.neutronedi.com/mcp, authenticated with X-API-Key on each request.

Skills

Operational runbooks that tell agents when to read, validate, or write X12 and how to recover from failures.

Agent Harness

Your AI runtime connects the MCP server, loads the right skill, and keeps credentials in the harness configuration.

X12 MCP Tools

Current hosted tools

The Neutron EDI MCP server currently advertises three X12 tools. EDIFACT remains available through the REST API, but it is not part of the MCP tool surface described here.

read_x12

Parse raw X12 content into structured JSON and optionally generate a 997.

validate_x12

Validate raw X12 content and return pass/fail details, errors, and warnings.

write_x12

Generate raw X12 content from structured JSON with ISA, Groups, GS, and Transactions.

representative-tool-call.json

{
  "tool": "read_x12",
  "arguments": {
    "content": "ISA*00*          *00*          *ZZ*SENDER         *ZZ*RECEIVER       *230101*1200*U*00401*000000001*0*P*>~...~",
    "include997": true
  }
}

Downloadable Skills

Tool-specific runbooks for X12 agents

Each skill has a focused `SKILL.md` for trigger conditions and workflows, plus reference files the agent can load only when it needs deeper detail.

read_x12

X12 Reader

x12-reader

Trigger on pasted ISA content, parse X12 into JSON, extract fields, inspect envelopes, and generate 997 acknowledgments when requested.

SKILL.md tool-notes.md transaction-sets.md

validate_x12

X12 Validator

x12-validator

Answer validity, compliance, rejection, and readiness questions with Neutron validation results and recovery steps.

SKILL.md tool-notes.md transaction-sets.md

write_x12

X12 Writer

x12-writer

Generate raw X12 from structured JSON, shape ISA/GS/ST envelopes, recover from write errors, and validate output before sending.

SKILL.md tool-notes.md transaction-sets.md

Authenticated per request

Connect once. Let the skill drive the workflow.

Configure your harness to send `X-API-Key` to the hosted MCP server. Then install the skills into your harness-specific skill directory so the model can load the right runbook at the right time.

Read MCP Setup Docs Create API Key

Setup checklist

1Point your harness at `https://api.neutronedi.com/mcp`.
2Send your Neutron EDI API key in the `X-API-Key` header on MCP requests.
3Install `x12-reader`, `x12-validator`, and `x12-writer` in your harness-specific skills directory.
4Ask the agent to parse, validate, or generate X12 and let the skill choose the tool sequence.