FreightSimple MCP by usefulapi

Quote and book shipments, upload customs documents and track status in FreightSimple.

Sollte ich dies verwenden

Qualität und Sicherheit

B
Qualität der Beschreibung
90%
Vollständigkeit des Schemas
77%
Qualität der Benennung
67%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (8)

  • LOWTool 'freightsimple_list_distribution_warehouse_brands' name length outside 3-30 rangein freightsimple_list_distribution_warehouse_brands
  • LOWTool 'freightsimple_list_dangerous_goods' name length outside 3-30 rangein freightsimple_list_dangerous_goods
  • LOWTool 'freightsimple_list_saved_commodities' name length outside 3-30 rangein freightsimple_list_saved_commodities
  • LOWTool 'freightsimple_get_saved_commodity_by_sku' name length outside 3-30 rangein freightsimple_get_saved_commodity_by_sku
  • LOWTool 'freightsimple_upload_customs_documents' name length outside 3-30 rangein freightsimple_upload_customs_documents
  • LOWTool 'freightsimple_create_saved_commodity' name length outside 3-30 rangein freightsimple_create_saved_commodity
  • LOWTool 'freightsimple_update_saved_commodity' name length outside 3-30 rangein freightsimple_update_saved_commodity
  • LOWTool 'freightsimple_delete_saved_commodity' name length outside 3-30 rangein freightsimple_delete_saved_commodity

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~3,838Tokens (Tool-Definitionen)
~3.1 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (3.00% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "freightsimple": {
      "url": "https://freightsimple.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://freightsimple.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (12)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢freightsimple_list_carriers

List the carriers available to this company, with their identifiers. GET /v1/carriers/list.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢freightsimple_list_distribution_warehouse_brands

List the distribution warehouse brands (for example Amazon sites) FreightSimple recognises, and whether each needs a delivery deadline. GET /v1/distribution-warehouse-brands/list.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢freightsimple_list_dangerous_goods(search)

Look up dangerous goods reference data (UN numbers, classes, packing groups). The optional search text filters on UN number, class, proper shipping name or description. GET /v1/dangerous-goods/list.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Text to match, for example 1203 or gasoline. Case-insensitive.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢freightsimple_get_shipment(shipment_id, tracking_id)

Get one shipment: its status, the quotes (when quoted), the selected quote, documents and tracking history. Give exactly one of shipment_id or tracking_id. Poll this after start_quoting until shipmentStatus is Quoted. GET /v1/shipments/get-shipment.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "shipment_id": {
      "description": "The shipment id returned by start_quoting.",
      "type": "string"
    },
    "tracking_id": {
      "description": "The tracking id (the tId in a tracking link).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢freightsimple_list_saved_commodities

List the saved commodities (reusable product definitions) of this company. GET /v1/saved-commodities/list.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢freightsimple_get_saved_commodity_by_sku(sku_identifier)

Get one saved commodity by its SKU identifier. GET /v1/saved-commodities/get-by-sku.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "sku_identifier": {
      "type": "string",
      "description": "The SKU identifier of the saved commodity."
    }
  },
  "required": [
    "sku_identifier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴freightsimple_start_quoting(pickupDate, pickup, delivery, lineItems, broker, ...)

Create a shipment and start the carrier quoting process (no cost is committed). Returns shipmentId and warnings. Quoting takes about 30 seconds: then poll freightsimple_get_shipment until shipmentStatus is Quoted. A cross-border shipment needs a broker. POST /v1/shipments/start-quoting.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "pickupDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Pickup date, yyyy-mm-dd."
    },
    "pickup": {
      "type": "object",
      "properties": {
        "locationType": {
          "type": "string",
          "enum": [
            "Warehouse",
            "DistributionWarehouse",
            "Residential",
            "ConstructionSite",
            "School",
            "TradeShow",
            "UniversityCollege",
            "Farm",
            "Mine",
            "Retail",
            "Hospitality",
            "Medical",
            "Airport",
            "SelfStorage",
            "Port",
            "Prison",
            "OtherLimitedAccess",
            "ReligiousSite",
            "Military",
            "Utility"
          ]
        },
        "distributionWarehouseBrand": {
          "description": "Brand id from list_distribution_warehouse_brands, when the site is one.",
          "type": "string"
        },
        "businessName": {
          "type": "string"
        },
        "addressLine": {
          "type": "string"
        },
        "addressLine2": {
          "type": "string",
          "description": "Use an empty string when there is no second line."
        },
        "city": {
          "type": "string"
        },
        "stateOrProvinceCode": {
          "type": "string"
        },
        "postalCode": {
          "type": "string"
        },
        "countryCode": {
          "type": "string",
          "enum": [
            "UnitedStates",
            "Canada"
          ]
        },
        "openFrom": {
          "type": "string",
          "description": "Opening time, 24-hour HH:mm, e.g. 09:00."
        },
        "openUntil": {
          "type": "string",
          "description": "Closing time, 24-hour HH:mm, e.g. 17:00."
        },
        "notes": {
          "type": "string",
          "description": "Use an empty string when there are no notes."
        },
        "contactName": {
          "type": "string"
        },
        "contactPhoneNumber": {
          "type": "string"
        },
        "contactPhoneNumberExtension": {
          "type": "string"
        },
        "contactEmail": {
          "type": "string"
        },
        "referenceNumber": {
          "type": "string"
        },
        "deadline": {
          "description": "Only for a location that accepts a delivery deadline.",
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "boothNumber": {
          "type": "string"
        },
        "specialServiceInsideRequired": {
          "type": "boolean"
        },
        "specialServiceLiftGateRequired": {
          "type": "boolean"
        },
        "hasShippingDock": {
          "type": "string",
          "enum": [
            "unknown",
            "yes",
            "no"
          ]
        },
        "hasForklift": {
          "type": "string",
          "enum": [
            "unknown",
            "yes",
            "no"
          ]
        }
      },
      "required": [
        "locationType",
        "businessName",
        "addressLine",
        "addressLine2",
        "city",
        "stateOrProvinceCode",
        "postalCode",
        "countryCode",
        "openFrom",
        "openUntil",
        "notes",
        "contactName",
        "contactPhoneNumber",
        "specialServiceInsideRequired",
        "specialServiceLiftGateRequired",
        "hasShippingDock",
        "hasForklift"
      ]
    },
    "delivery": {
      "type": "object",
      "properties": {
        "locationType": {
          "type": "string",
          "enum": [
            "Warehouse",
            "DistributionWarehouse",
            "Residential",
            "ConstructionSite",
            "School",
            "TradeShow",
            "UniversityCollege",
            "Farm",
            "Mine",
            "Retail",
            "Hospitality",
            "Medical",
            "Airport",
            "SelfStorage",
            "Port",
            "Prison",
            "OtherLimitedAccess",
            "ReligiousSite",
            "Military",
            "Utility"
          ]
        },
        "distributionWarehouseBrand": {
          "description": "Brand id from list_distribution_warehouse_brands, when the site is one.",
          "type": "string"
        },
        "businessName": {
          "type": "string"
        },
        "addressLine": {
          "type": "string"
        },
        "addressLine2": {
          "type": "string",
          "description": "Use an empty string when there is no second line."
        },
        "city": {
          "type": "string"
        },
        "stateOrProvinceCode": {
          "type": "string"
        },
        "postalCode": {
          "type": "string"
        },
        "countryCode": {
          "type": "string",
          "enum": [
            "UnitedStates",
            "Canada"
          ]
        },
        "openFrom": {
          "type": "string",
          "description": "Opening time, 24-hour HH:mm, e.g. 09:00."
        },
        "openUntil": {
          "type": "string",
          "description": "Closing time, 24-hour HH:mm, e.g. 17:00."
        },
        "notes": {
          "type": "string",
          "description": "Use an empty string when there are no notes."
        },
        "contactName": {
          "type": "string"
        },
        "contactPhoneNumber": {
          "type": "string"
        },
        "contactPhoneNumberExtension": {
          "type": "string"
        },
        "contactEmail": {
          "type": "string"
        },
        "referenceNumber": {
          "type": "string"
        },
        "deadline": {
          "description": "Only for a location that accepts a delivery deadline.",
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "boothNumber": {
          "type": "string"
        },
        "specialServiceInsideRequired": {
          "type": "boolean"
        },
        "specialServiceLiftGateRequired": {
          "type": "boolean"
        },
        "hasShippingDock": {
          "type": "string",
          "enum": [
            "unknown",
            "yes",
            "no"
          ]
        },
        "hasForklift": {
          "type": "string",
          "enum": [
            "unknown",
            "yes",
            "no"
          ]
        },
        "specialServiceAppointmentRequired": {
          "type": "boolean",
          "description": "True when the carrier must book a delivery appointment."
        }
      },
      "required": [
        "locationType",
        "businessName",
        "addressLine",
        "addressLine2",
        "city",
        "stateOrProvinceCode",
        "postalCode",
        "countryCode",
        "openFrom",
        "openUntil",
        "notes",
        "contactName",
        "contactPhoneNumber",
        "specialServiceInsideRequired",
        "specialServiceLiftGateRequired",
        "hasShippingDock",
        "hasForklift",
        "specialServiceAppointmentRequired"
      ]
    },
    "lineItems": {
      "minItems": 1,
      "maxItems": 21,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "handlingUnitType": {
            "type": "string",
            "enum": [
              "Skid",
              "Pallet",
              "Bin",
              "Box",
              "Bundle",
              "Cage",
              "Crate",
              "Drum",
              "Reel",
              "Roll",
              "Loose",
              "Other"
            ]
          },
          "numberHandlingUnits": {
            "default": 1,
            "description": "Number of handling units (default 1).",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "description": {
            "type": "string"
          },
          "lengthInches": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "widthInches": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "heightInches": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "weightPerHandlingUnitPounds": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "temperatureHandling": {
            "default": "NoSpecialHandling",
            "type": "string",
            "enum": [
              "KeepFrozen",
              "KeepRefrigerated",
              "ProtectFromFreezing",
              "NoSpecialHandling"
            ]
          },
          "isDangerous": {
            "type": "boolean"
          },
          "isStackable": {
            "default": false,
            "description": "Can other freight go on top (default false).",
            "type": "boolean"
          },
          "nmfcItemNumber": {
            "type": "string"
          },
          "dangerousUnNumber": {
            "type": "string"
          },
          "dangerousClassification": {
            "type": "string"
          },
          "dangerousPackingGroup": {
            "type": "string"
          },
          "dangerousProperShippingName": {
            "type": "string"
          },
          "dangerousTechnicalName": {
            "type": "string"
          },
          "dangerousNumberPackages": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "dangerousPackagingType": {
            "type": "string"
          },
          "dangerousNetExplosiveQuantityKg": {
            "type": "number"
          }
        },
        "required": [
          "handlingUnitType",
          "description",
          "lengthInches",
          "widthInches",
          "heightInches",
          "weightPerHandlingUnitPounds",
          "isDangerous"
        ]
      },
      "description": "1 to 21 line items."
    },
    "broker": {
      "description": "Required for a cross-border shipment.",
      "type": "object",
      "properties": {
        "businessName": {
          "type": "string"
        },
        "address": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string"
            },
            "stateOrProvinceCode": {
              "type": "string"
            },
            "postalCode": {
              "type": "string"
            },
            "countryCode": {
              "type": "string",
              "enum": [
                "UnitedStates",
                "Canada"
              ]
            },
            "addressLine": {
              "type": "string"
            },
            "addressLine2": {
              "type": "string"
            }
          },
          "required": [
            "city",
            "stateOrProvinceCode",
            "postalCode",
            "countryCode",
            "addressLine"
          ]
        },
        "contact": {
          "type": "object",
          "properties": {
            "emailAddress": {
              "type": "string"
            },
            "contactName": {
              "type": "string"
            },
            "phoneNumber": {
              "type": "string"
            },
            "phoneNumberExtension": {
              "type": "string"
            }
          },
          "required": [
            "contactName",
            "phoneNumber"
          ]
        },
        "accountNumber": {
          "type": "string"
        }
      },
      "required": [
        "businessName",
        "address",
        "contact"
      ]
    },
    "emergencyContact": {
      "description": "Required when any line item is dangerous.",
      "type": "object",
      "properties": {
        "contactName": {
          "type": "string"
        },
        "contactPhoneNumber": {
          "type": "string"
        },
        "contactPhoneNumberExtension": {
          "type": "string"
        },
        "erapPlanNumber": {
          "type": "string"
        },
        "erapPhoneNumber": {
          "type": "string"
        },
        "tdgResponsibleName": {
          "description": "Needed for a pickup or delivery in Canada.",
          "type": "string"
        }
      },
      "required": [
        "contactName",
        "contactPhoneNumber"
      ]
    },
    "branchId": {
      "description": "Branch id from the company address book, if used.",
      "type": "string"
    },
    "metadata": {
      "description": "Your own notes or JSON, returned unchanged.",
      "type": "string",
      "maxLength": 16000
    }
  },
  "required": [
    "pickupDate",
    "pickup",
    "delivery",
    "lineItems"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴freightsimple_start_booking(quoteId, pickupDate, bookingContact, confirm)

Book a quote from a quoted shipment. This makes a carrier pickup and commits the cost, so confirm must be true. Use the quoteId from get_shipment. Poll get_shipment until shipmentStatus is BookingConfirmed (about 15 seconds). POST /v1/shipments/start-booking.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "quoteId": {
      "type": "string",
      "description": "The quoteId of the chosen quote (from get_shipment)."
    },
    "pickupDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Pickup date, yyyy-mm-dd."
    },
    "bookingContact": {
      "description": "Who the operations team contacts about pickup and invoices.",
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "phoneNumber": {
          "type": "string"
        }
      }
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. Confirms the action goes to the carrier now."
    }
  },
  "required": [
    "quoteId",
    "pickupDate",
    "confirm"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴freightsimple_upload_customs_documents(shipmentId, mode, documents, confirm)

Upload customs documents (base64 PDFs, for example the commercial invoice) to a cross-border shipment. Each upload goes straight to the carrier, so confirm must be true. Use mode Replace to swap a corrected set. Upload from BookingConfirmed until delivered. POST /v1/shipments/upload-customs-documents.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "shipmentId": {
      "type": "string",
      "description": "The shipment id returned by start_quoting."
    },
    "mode": {
      "type": "string",
      "enum": [
        "Add",
        "Replace"
      ],
      "description": "Add keeps the existing documents; Replace swaps them."
    },
    "documents": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fileName": {
            "type": "string"
          },
          "base64EncodedPdf": {
            "type": "string"
          }
        },
        "required": [
          "fileName",
          "base64EncodedPdf"
        ]
      },
      "description": "The PDFs, base64 encoded."
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. Confirms the action goes to the carrier now."
    }
  },
  "required": [
    "shipmentId",
    "mode",
    "documents",
    "confirm"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴freightsimple_create_saved_commodity(description, handlingUnitType, isDangerous, isStackable, temperatureHandling, ...)

Save a reusable commodity definition for this company. POST /v1/saved-commodities/create.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "description": {
      "type": "string"
    },
    "handlingUnitType": {
      "type": "string",
      "enum": [
        "Skid",
        "Pallet",
        "Bin",
        "Box",
        "Bundle",
        "Cage",
        "Crate",
        "Drum",
        "Reel",
        "Roll",
        "Loose",
        "Other"
      ]
    },
    "isDangerous": {
      "type": "boolean"
    },
    "isStackable": {
      "type": "boolean"
    },
    "temperatureHandling": {
      "type": "string",
      "enum": [
        "KeepFrozen",
        "KeepRefrigerated",
        "ProtectFromFreezing",
        "NoSpecialHandling"
      ]
    },
    "nmfcItemNumber": {
      "type": "string"
    },
    "dangerousUnNumber": {
      "type": "string"
    },
    "dangerousClassification": {
      "type": "string"
    },
    "dangerousPackingGroup": {
      "type": "string"
    },
    "dangerousProperShippingName": {
      "type": "string"
    },
    "dangerousTechnicalName": {
      "type": "string"
    },
    "dangerousNumberPackages": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "dangerousPackagingType": {
      "type": "string"
    },
    "skuIdentifier": {
      "type": "string"
    },
    "lengthInches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "widthInches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "heightInches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "description",
    "handlingUnitType",
    "isDangerous",
    "isStackable",
    "temperatureHandling"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡freightsimple_update_saved_commodity(savedCommodityId, description, handlingUnitType, isDangerous, isStackable, ...)

Replace a saved commodity's fields. Send every required field again, not only the changed ones. POST /v1/saved-commodities/update.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "savedCommodityId": {
      "type": "string",
      "description": "The id of the saved commodity to update."
    },
    "description": {
      "type": "string"
    },
    "handlingUnitType": {
      "type": "string",
      "enum": [
        "Skid",
        "Pallet",
        "Bin",
        "Box",
        "Bundle",
        "Cage",
        "Crate",
        "Drum",
        "Reel",
        "Roll",
        "Loose",
        "Other"
      ]
    },
    "isDangerous": {
      "type": "boolean"
    },
    "isStackable": {
      "type": "boolean"
    },
    "temperatureHandling": {
      "type": "string",
      "enum": [
        "KeepFrozen",
        "KeepRefrigerated",
        "ProtectFromFreezing",
        "NoSpecialHandling"
      ]
    },
    "nmfcItemNumber": {
      "type": "string"
    },
    "dangerousUnNumber": {
      "type": "string"
    },
    "dangerousClassification": {
      "type": "string"
    },
    "dangerousPackingGroup": {
      "type": "string"
    },
    "dangerousProperShippingName": {
      "type": "string"
    },
    "dangerousTechnicalName": {
      "type": "string"
    },
    "dangerousNumberPackages": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "dangerousPackagingType": {
      "type": "string"
    },
    "skuIdentifier": {
      "type": "string"
    },
    "lengthInches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "widthInches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "heightInches": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "savedCommodityId",
    "description",
    "handlingUnitType",
    "isDangerous",
    "isStackable",
    "temperatureHandling"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴freightsimple_delete_saved_commodity(savedCommodityId)

Delete a saved commodity by id. This cannot be undone. POST /v1/saved-commodities/delete.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "savedCommodityId": {
      "type": "string",
      "description": "The id of the saved commodity to delete."
    }
  },
  "required": [
    "savedCommodityId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet12 Tools