Tools Reference
The ECGrid MCP Server hosts tools across three product groups: Connectivity, DataSync (GPA), and Translation. Each product group requires its own credential header — a single connection can carry multiple headers.
Call tools/list at startup to get the current complete tool list with full input schemas — the response is always authoritative. For programmatic discovery, GET https://mcp.ecgrid.io/tools.json returns the same registry without authentication.
Connectivity Tools
Credential: X-Connectivity-API-Key — your ECGrid API key
37 tools across 13 categories. All Connectivity tools are prefixed connectivity_ and return structured JSON data.
| Category | Tools | Interactive UI |
|---|---|---|
| System | get-version, get-status-list | — |
| Users | get-user-by-id, get-user-by-login, list-users | — |
| Network | get-network-by-id | — |
| Mailboxes | get-mailbox-by-id, list-mailboxes, get-mailbox-by-name | get-mailbox-by-id, list-mailboxes |
| ECGrid IDs | get-ecgrid-id-by-id, find-edi-ids, list-ecgrid-ids-by-mailbox | All three |
| Partners | get-partner-by-id, list-partners, check-partner-config, test-partner-delivery, get-partner-document-counts | get-partner-by-id, list-partners |
| Comms | get-comm-by-id, list-comms, find-comms, test-comm, check-ftp-access | — |
| Parcels | get-parcel-by-id, list-inbox-parcels, list-outbox-parcels, list-pending-inbox-parcels | get-parcel-by-id |
| Interchanges | get-interchange-by-id, list-inbox-interchanges, list-outbox-interchanges, get-document-counts-by-status | get-interchange-by-id |
| Transactions | search-transactions | search-transactions |
| Callbacks | get-callback-event-by-id, get-callback-queue-by-id, list-callback-events, list-callback-queue | — |
| Carbon Copies | get-carbon-copy-by-id, list-carbon-copies | — |
| Keys | get-key, list-keys | — |
Response Modes
Structured JSON — all Connectivity tools return a structured JSON data object. The AI interprets this and presents it to the user in plain language. Developers use it directly in their applications.
Interactive UI components — 10 tools additionally render a visual, browsable widget in Claude Desktop and Claude.ai alongside the AI's text response. The tool call, parameters, and JSON response are identical regardless of whether a UI component renders. Identified in the table above.
DataSync Tools
Credential: X-DataSync-API-Key — your GPA Personal Access Token (PAT)
5 tools across 3 categories. All DataSync tools are prefixed datasync_.
| Category | Tools |
|---|---|
| Company | list-companies |
| Catalog | list-catalogs, list-catalog-products |
| Product | list-products, get-product-details |
Translation Tools
Credential: X-Translation-API-Key — your Translation API key
Translation tools are prefixed translation_. Tool documentation will be published here as tools are released.