EBL MCP Server

What is EBL MCP Server?

EBL MCP Server is a Model Context Protocol (MCP) server for managing electronic Bills of Lading (eBLs). It provides functionality to issue, query, transfer, and surrender eBLs, targeting logistics and shipping workflows.

How to use EBL MCP Server?

Clone the repository, install dependencies with pnpm install, then run the server in development mode with pnpm dev or build and start in production with pnpm build && pnpm start. The server exposes MCP tools like issue_ebl.

Key features of EBL MCP Server

• Issue and register new electronic Bills of Lading
• Query details of existing eBLs
• Transfer eBL holder/owner
• Surrender eBL upon cargo delivery
• Built with TypeScript and the @modelcontextprotocol/sdk

Use cases of EBL MCP Server

• Automate issuance of eBLs in a shipping or trade platform
• Retrieve real-time status of a specific eBL
• Change ownership of a bill of lading during cargo transit
• Mark a bill of lading as surrendered after cargo delivery

FAQ from EBL MCP Server

What are the prerequisites for running EBL MCP Server?

You need Node.js (LTS version recommended) and pnpm (install via npm install -g pnpm).

How do I issue an eBL using the server?

Call the issue_ebl tool via the tools/call MCP method with the required arguments like requester_bu_id, bl_number, and file_content as shown in the sample.

What is the license for this project?

The project is licensed under the Apache License, Version 2.0.

How can I contribute to the project?

Fork the repository, create a feature branch from main, follow the coding standards (TypeScript, functional style, pure functions), and submit a pull request with at least one maintainer approval.

What technology stack is used?

The server is written in TypeScript, uses pnpm as the package manager, and runs on Node.js with the @modelcontextprotocol/sdk framework.