Cargoffer MCP - Skybridge App

About

Cargoffer MCP is a Skybridge application that provides type-safe, interactive API documentation for the Cargoffer B2B logistics REST API. It enables AI assistants (Claude, ChatGPT, Cursor, Copilot) to explore and query the complete API surface through natural language.

Keywords

mcp model-context-protocol cargoffer logistics freight trucking trucks transport load-board carrier api-documentation openapi docs spanish english spain portugal latam b2b marketplace

Release

What is this?

Cargoffer MCP is a Skybridge application that provides type-safe, interactive API documentation for the Cargoffer B2B logistics REST API. It enables AI assistants (Claude, ChatGPT, Cursor, Copilot) to explore and query the complete API surface through natural language.

Features

• Search endpoints by keyword, tag, module, or locale
• View detailed endpoint docs including parameters, request bodies, and responses
• Explore schemas with TypeScript inference
• Navigation by tags for easy browsing
• Multi-locale support: Spanish (es) and English (en)
• Live documentation for 239+ API endpoints

Supported Modules

| Module | Description | Locales | |--------|------------|--------| | company | Company management, authentication, users | es, en | | truckers | Trucker/carrier management, freight | es, en | | vehicle-types | Vehicle type catalog | es, en |

Installation

Prerequisites

• Node.js >= 22.0.0
• pnpm (recommended) or npm

Quick Install

# Clone the repository
git clone https://github.com/cargoffer/cargoffer_mcp_skybridge.git
cd cargoffer_mcp_skybridge

# Install dependencies
pnpm install

# Start development server
pnpm dev

Connect to Claude Desktop

This is a Skybridge app frontend. For the actual MCP server that connects to Cargoffer APIs, use:

For Cargoffer API Docs (Bolsa de Carga):

{
  "mcpServers": {
    "cargoffer": {
      "command": "npx",
      "args": ["-y", "@cargoffer/cargo-mcp"]
    }
  }
}

Or run from source:

git clone https://github.com/cargoffer/cargo_mcp.git
cd cargo_mcp && npm install && npm start

Tools Available

search_docs

Search across all Cargoffer API documentation by keywords.

{
  query: "authentication",
  module: "company",        // optional
  locale: "es",            // optional: "es" | "en"
  limit: 10                // optional: 1-100
}

get_endpoint

Get detailed information about a specific API endpoint.

{
  module: "company",
  path: "/company/auth/login",
  method: "POST",
  locale: "es"
}

list_modules

List all available API modules with statistics.

{
  locale: "es"  // optional
}

get_navigation

Get navigation structure organized by tags for a module.

{
  module: "company",
  locale: "es"
}

search_by_tag

Find all endpoints with a specific tag.

{
  tag: "authentication",
  module: "company",  // optional
  locale: "es"       // optional
}

get_schema

Retrieve schema definitions for request/response structures.

{
  module: "company",
  schemaName: "LoginRequest",
  locale: "es"
}

list_schemas

List all available schemas for a module.

{
  module: "company",
  locale: "es"
}

API Coverage

Authentication & Users (company)

• POST /company/auth/login - User login
• POST /company/auth/register - Company registration
• POST /company/auth/refresh - Token refresh
• GET /company/users/me - Current user profile
• PUT /company/users/:id - Update user
• And 50+ more endpoints

Truckers & Carriers (truckers)

• GET /truckers - List truckers
• GET /truckers/:id - Get trucker details
• POST /truckers/search - Advanced search
• GET /truckers/:id/auctions - Trucker's auctions
• And 100+ more endpoints

Vehicle Types (vehicle-types)

• GET /vehicle-types - List vehicle types
• GET /vehicle-types/:id - Get vehicle type
• GET /vehicle-types/:id/pricing - Pricing by zone
• And 80+ more endpoints

Use Cases

For AI Assistants

This MCP enables AI assistants to:

1. Help with integration - Find the right endpoint for a given use case
2. Explain API contracts - Show schema structures for request/response
3. Generate code examples - Reference endpoint definitions
4. Debug integration issues - Compare expected vs actual schemas
5. Explore available features - Navigate by tags or modules

For Developers

• Interactive documentation in Claude, ChatGPT, or other MCP clients
• Type-safe exploration with automatic TypeScript inference
• Offline-capable - Bundle the documentation for local use

Deployment

Production Build

pnpm build
pnpm start

Environment Variables

# Optional: Custom port (default: 3000)
PORT=3000

# Optional: Enable.debug mode
DEBUG=false

Documentation

• Cargoffer API Docs - Full API reference
• Skybridge Framework - Framework documentation
• Model Context Protocol - MCP specification

🔑 How to get your API Key (Required)

To use Cargoffer MCP with live API calls, you need a Cargoffer API Key. Free tier available.

Get your API key:

1. Go to https://cargoffer.com or https://transcend.cargoffer.com
2. Create an account / Log in
3. Go to Dashboard → Developers → API Keys → Generate Key
4. Copy the key and set it as CARGOFFER_API_KEY environment variable

export CARGOFFER_API_KEY="your-key-here"
npx cargoffer-mcp-skybridge

💡 Need enterprise access? Cargoffer offers TRANSCEND TMS, Bolsa de Carga (freight marketplace), and eCMR/DeCA (digital CMR) with dedicated support. Contact [email protected] or visit https://cargoffer.com.

Tech Stack

• Skybridge - MCP Apps framework
• React - UI components
• TypeScript - Type safety
• Vite - Build tool

License

ISC - Cargoffer Team

Support

• Issues: GitHub Issues
• Email: [email protected]
• Website: https://cargoffer.com/