AI Operations

Server

Download schema

AI-powered cargo management and optimization endpoints

Universal MCP endpoint

Connect Cosmo Cargo AI

Add this MCP server to your favorite AI tools in a few steps.

MCP Server URL

https://api.cosmocargo.space/ai/v1/mcp

Requires an X-API-Key header — replace YOUR_API_KEY with your key.

Choose your client

Set up Claude

Add Cosmo Cargo AI to Claude Code by running:
Terminal
claude mcp add --transport http --header 'X-API-Key: YOUR_API_KEY' 'Cosmo Cargo AI' 'https://api.cosmocargo.space/ai/v1/mcp'
Replace YOUR_API_KEY with your API key.
Restart Claude Code — the Cosmo Cargo AI tools are now available.

View official docs

Optimize cargo routing

POST

https://api.cosmocargo.space/ai/v1

/optimize

Uses advanced AI algorithms to find the optimal route for cargo shipments across the solar system, considering factors like transit time, cost, and special cargo requirements.

Optimize cargo routing › Request Body

CargoOptimizationRequest

origin

string · required

Origin space station or planet

Example: Earth Station Alpha

destination

string · required

Destination space station or planet

Example: Mars Colony Beta

CargoItem[] · required

OptimizationConstraints

Optimize cargo routing › Responses

200

Optimization completed successfully

OptimizationResult

SpaceRoute

estimatedCost

number · float

Cost in Galactic Credits

estimatedTime

integer

Transit time in Earth days

confidenceScore

number · float · min: 0 · max: 1

SpaceRoute[]

POST/optimize

fetch('https://api.cosmocargo.space/ai/v1/optimize', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': '<api-key>'
  },
  body: JSON.stringify({
    origin: 'Earth Station Alpha',
    destination: 'Mars Colony Beta',
    cargo: [
      {
        type: 'PERISHABLE',
        weight: 0,
        volume: 0,
        specialRequirements: ['temperature-controlled', 'zero-gravity-storage']
      }
    ],
    constraints: {
      maxTransitTime: 0,
      preferredCarriers: ['string'],
      avoidRoutes: ['string']
    }
  })
})

Example Request Body

{
  "origin": "Earth Station Alpha",
  "destination": "Mars Colony Beta",
  "cargo": [
    {
      "type": "PERISHABLE",
      "weight": 0,
      "volume": 0,
      "specialRequirements": [
        "temperature-controlled",
        "zero-gravity-storage"
      ]
    }
  ],
  "constraints": {
    "maxTransitTime": 0,
    "preferredCarriers": [
      "string"
    ],
    "avoidRoutes": [
      "string"
    ]
  }
}

json

Example Responses

{
  "recommendedRoute": {
    "routeId": "00000000-0000-0000-0000-000000000000",
    "waypoints": [
      "string"
    ],
    "carrier": "carrier",
    "vesselType": "FREIGHTER"
  },
  "estimatedCost": 0,
  "estimatedTime": 0,
  "confidenceScore": 0,
  "alternativeRoutes": [
    {
      "routeId": "00000000-0000-0000-0000-000000000000",
      "waypoints": [
        "string"
      ],
      "carrier": "carrier",
      "vesselType": "FREIGHTER"
    }
  ]
}

json

application/json

Predict shipment issues

POST

https://api.cosmocargo.space/ai/v1

/predict

Uses machine learning to predict potential issues with shipments including delays, damage risks, and route disruptions based on historical data and current space weather conditions.

Predict shipment issues › Request Body

PredictionRequest

shipmentId

string · uuid · required

predictionTypes

string[]

Enum values:

DELAY

DAMAGE

ROUTE_DISRUPTION

COST_OVERRUN

Predict shipment issues › Responses

200

Predictions generated successfully

PredictionResult

Prediction[]

overallRiskLevel

string · enum

Enum values:

LOW

MEDIUM

HIGH

CRITICAL

Analyze fleet performance

GET

https://api.cosmocargo.space/ai/v1

/analyze/fleet-performance

Provides AI-powered analytics on fleet performance including fuel efficiency, delivery times, and maintenance predictions.

Analyze fleet performance › query Parameters

timeRange

string · enum

Enum values:

30d

90d

Default: 30d

fleetId

string

Analyze fleet performance › Responses

200

Fleet analysis completed

overallScore

number · float · min: 0 · max: 100

object[]

Sample audio playback

GET

https://api.cosmocargo.space/ai/v1

/mpthreetest.mp3

Demo endpoint for audio player feature. Returns a sample MP3 file from a public CDN.

Sample audio playback › Responses

200

Audio file

string

Quantum Transport