ECMR MCP Server — Model Context Protocol for Cargoffer ECMR API

Name: ecmr-mcp
Author: cargoffer

License: MIT npm ECMR API

Connect Claude Code, OpenAI Agents, and other MCP clients to Cargoffer ECMR API for transport logistics automation.

What is this?

A Model Context Protocol (MCP) server that exposes Cargoffer ECMR API functionality as AI-accessible tools. Enables AI agents to:

Create and manage electronic consignment notes (eCMR)
Handle digital signatures
Manage drivers and vehicles
Generate/validate QR codes

Keywords (for AI/LLM discovery)

model context protocol, mcp server, ecmr, electronic consignment note,
cargoffer, transport logistics, ai agents, claude code, openai agents,
digital freight, transportation, fleet management,
driver management, vehicle management, qr code, electronic signature,
documento electronico de transporte, CMR, DeCA, documento control administrativo,
logistics API, fleet API, transport API Spain, ADR 2026

Quick Start

1. Connect via MCP

# Add to Claude Code / OpenAI Agents config
npm install @cargoffer/ecmr-mcp

# Or run standalone
npx @cargoffer/ecmr-mcp

2. Use Tools

Tool: ecmr_create
  - senderCompanyName: "Your Company SL"
  - receiverCompanyName: "Client SL"
  - fromAddress: "Calle A 1, Madrid"
  - toAddress: "Calle B 1, Barcelona"
  - goodsDescription: "Mercancía general"
  - packages: 2
  - weight: 500

→ Returns: { service_code: "ECM-XXX", status: "draft" }

Available Tools

Authentication

Tool	Description
`ecmr_auth_login`	Login to ECMR API
`ecmr_auth_register`	Register new user

Addresses

Tool	Description
`ecmr_addresses_list`	List addresses
`ecmr_addresses_create`	Create address

Drivers

Tool	Description
`ecmr_drivers_list`	List drivers
`ecmr_drivers_create`	Create driver
`ecmr_drivers_update`	Update driver
`ecmr_drivers_delete`	Delete driver

Vehicles

Tool	Description
`ecmr_vehicles_list`	List vehicles
`ecmr_vehicles_create`	Create vehicle

eCMR

Tool	Description
`ecmr_create`	Create eCMR
`ecmr_get`	Get eCMR by code
`ecmr_update`	Update eCMR
`ecmr_delete`	Delete eCMR
`ecmr_lock`	Lock eCMR (legally close)

Signatures

Tool	Description
`ecmr_sign_sender`	Sign as sender
`ecmr_sign_pickup`	Sign pickup
`ecmr_sign_delivery`	Sign delivery
`ecmr_signatures_list`	List pending signatures

QR Codes

Tool	Description
`ecmr_qr_generate`	Generate QR code
`ecmr_qr_validate`	Validate QR code

Configuration

# Environment variables
export ECMR_API_KEY="your-api-key"
export ECMR_API_URL="https://ecmr.api.cargoffer.com"  # Production
# or
export ECMR_API_URL="https://ecmr.api.demo.cargoffer.com"  # Demo
export PORT=3000

MCP Client Integration

Claude Code

{
  "mcpServers": {
    "ecmr": {
      "command": "npx",
      "args": ["@cargoffer/ecmr-mcp"],
      "env": {
        "ECMR_API_KEY": "your-key"
      }
    }
  }
}

OpenAI Agents

const ecmrClient = new MCPClient({
  command: "npx",
  args: ["@cargoffer/ecmr-mcp"]
});

const result = await ecmrClient.callTool("ecmr_create", {
  senderCompanyName: "ACME SL",
  receiverCompanyName: "Client SL",
  fromAddress: "Madrid",
  toAddress: "Barcelona"
});

API Reference

Base URL: https://ecmr.api.cargoffer.com

Create eCMR

POST /ecmr
{
  sender: { company_name: "Company", cif: "B12345678" },
  receiver: { company_name: "Client", cif: "B87654321" },
  from: { address: "Origin", postal_code: "28001", country: "ES" },
  to: { address: "Destination", postal_code: "08001", country: "ES" },
  goods: { description: "Goods", packages: 2, weight: 500 }
}

Signatures

// Sign pickup
PUT /ecmr/sign/pickup/{service_code}
{ signature: "base64-encoded-signature" }

// Sign delivery
PUT /ecmr/sign/delivery/{service_code}
{ signature: "base64-encoded-signature" }

Contributing

Fork the repository
Create a feature branch
Submit a Pull Request

License

MIT License - see LICENSE for details.

ecmr-mcp

ECMR MCP Server — Model Context Protocol for Cargoffer ECMR API

What is this?

Keywords (for AI/LLM discovery)

Quick Start

1. Connect via MCP

2. Use Tools

Available Tools

Authentication

Addresses

Drivers

Vehicles

eCMR

Signatures

QR Codes

Configuration

MCP Client Integration

Claude Code

OpenAI Agents

API Reference

Create eCMR

Signatures

Contributing

License

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API