XEDI Claude Code Plugin

Give Claude Code native guidance for the full xedi.ai MCP surface: EDI conversion, validation, mappings, workflows, connections, labels, usage, billing and partner-aware delivery.

Docs · MCP · xedi.ai

---

What It Does

This plugin helps Claude Code work with xedi.ai as an EDI automation platform. It adds focused skills for:

• Discovering and using the XEDI MCP server.
• Converting between business data formats and EDI standards.
• Validating EDIFACT, X12, TRADACOMS and PEPPOL payloads.
• Applying reusable mappings without mixing them up with partner envelopes.
• Managing encrypted workflow connections and browsing source folders.
• Listing and fetching SSCC pallet label templates.
• Building draft workflows from plain-English prompts.
• Inspecting workflow runs, notification reports and delivery tracking.
• Reading usage, token balance and subscription information.
• Routing documents through partner-aware delivery destinations such as TGMS, AS2, FTP, SFTP, email, Slack and Teams.
• Calling any authenticated /api/v1 endpoint through xedi.api_request when the platform exposes a capability before it has a named MCP wrapper.

Included Skills

Skill	Use It For
xedi:mcp	XEDI MCP discovery, authenticated API tools, connections, mappings, workflows and account usage.
xedi:platform-operations	Full platform operations: usage, tokens, subscriptions, connections, labels, mappings, workflow runs and generic /api/v1 calls.
xedi:edi-documents	Document conversion, validation, mapping, EDI envelope guidance and partner-aware delivery preparation.
xedi:workflow-builder	Creating, validating and updating XEDI workflows from natural-language requests.

MCP Connection

The plugin includes an MCP server definition named platform for:

https://xedi.ai/mcp/server

When installed, Claude Code asks for an XEDI API token as sensitive plugin configuration. The token is sent as:

Authorization: Bearer <your-xedi-api-token>

In Claude's tool-call UI this appears as plugin:xedi:platform.

Local Install

Clone this repository, then run Claude Code with the plugin directory:

git clone git@github.com:xedi/claude-plugin.git
cd claude-plugin
claude --plugin-dir .

During development, reload the plugin inside Claude Code after edits:

/reload-plugins

Example Prompts

Create a draft workflow that picks up CSV order files from my SFTP
connection folder /outgoing/orders/csv, maps them to a TRADACOMS Order,
delivers them to my TGMS trading partner, and sends Slack notifications
for success and error outcomes.

Validate this EDIFACT invoice and tell me whether it matches the selected
trading partner rules.

List my XEDI connections and build a workflow using the only available AS2
destination if it is unambiguous.

Show my XEDI usage summary, token balance and active managed-service
subscriptions.

Browse the selected SFTP connection folder and help me choose the source path
for a workflow trigger.

Create a reusable invoice mapping for JSON to EDIFACT, but keep envelope
values on the trading partner document settings.

Design Principles

• TGMS is treated as a first-class XEDI destination. Users should not need to know about its underlying transport.
• Mappings transform fields. Trading partners own envelopes, identifiers, ANA qualifiers and generation-number sequences.
• Workflow generation starts as draft unless the user has supplied all production choices and validation passes.
• Claude should discover node types, connection fields and API shapes through XEDI MCP instead of guessing.
• Dedicated MCP tools are preferred, with xedi.api_request used as the escape hatch for the full authenticated /api/v1 surface.
• Generated workflow drafts are validated before they are treated as usable; validation warnings are blockers to fix, not details to wave through.

Repository Layout

.
├── .claude-plugin/plugin.json
├── .mcp.json
├── assets/
│   ├── logo.png
│   └── logo.svg
├── references/
│   └── mcp-capabilities.md
└── skills/
    ├── edi-documents/SKILL.md
    ├── mcp/SKILL.md
    ├── platform-operations/SKILL.md
    └── workflow-builder/SKILL.md

Validate

claude plugin validate . --strict

Community Marketplace

This repository is prepared for Claude Code plugin distribution. For community marketplace submission, validate the plugin locally, then submit the GitHub repository through Anthropic's Claude Code plugin process.

License

This plugin is licensed under the Apache License 2.0.

XEDI, xedi.ai, the XEDI name, and the XEDI logos are trademarks or registered trademarks of XEDI Ltd. See NOTICE for trademark and attribution details.