Server definition

Hash: sha256:10bdc0a73a525fee6dee9767496b6be679a08cf5194f3b8fb7bc92445245fd61
What it is: What a remote MCP server returned when asked what it offers: 5 tools

The blob, as servednamed by its sha256

{
  "instructions": "Plain Freight ships goods from China to US addresses, 100 g to 2,000 kg, door to door. estimate_price gives a rough cost and check_goods says whether goods can be priced at once or need a person first; both record nothing and need no email. generate_offer prices a shipment for real (freight, US customs clearance, delivery; each option says whether import duty is included) and records a quote request. A second check of each offer runs for a few seconds after it and can add questions or hold prices for a person to review (needs_review); check_offer_status reads its result by quote_id, and settled is true once it has finished. track_shipment reads a booked shipment from its tracking link. No tool books or charges anything. Rate limits: 20 offers per hour per IP and 4 per email address. The email field is optional: when given, the written offer is mailed there, and replying to it, or the book_url form, is how a customer books. Human contact: [email protected]. Docs: https://plainfreight.com/for-agents",
  "tools": [
    {
      "description": "Checks whether Plain Freight can ship a product from China to the US, and which documents it needs. Records nothing. Input: the product description. Returns a verdict: instant_offer or branded_rate (priced at once, each on its applicable rate) or person_checks_first (for example batteries, chemicals, food, cosmetics, seeds, vapes or weapons: a person reviews the goods before any price), with a plain explanation and the documents or details to have ready. It applies the same goods screen as Plain Freight's offers; it is not legal or customs advice.",
      "inputSchema": {
        "properties": {
          "product": {
            "description": "The product, in the user's words (materials and whether it has a battery help)",
            "type": "string"
          }
        },
        "required": [
          "product"
        ],
        "type": "object"
      },
      "name": "check_goods",
      "outputSchema": {
        "properties": {
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "error": {
            "type": "string"
          },
          "explanation": {
            "type": "string"
          },
          "have_ready": {
            "description": "Documents or details the person will ask for",
            "type": [
              "string",
              "null"
            ]
          },
          "next_step": {
            "type": "string"
          },
          "verdict": {
            "description": "instant_offer: priced at once; branded_rate: priced at once on its applicable rate; person_checks_first: no price until a person reviews the goods",
            "enum": [
              "instant_offer",
              "branded_rate",
              "person_checks_first"
            ],
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Reads the result of the second check on a Plain Freight offer, by the offer's quote_id. Read-only. Returns settled (true once the check finished), possibly updated options and summary, follow-up questions whose answers change the price or customs channel, the offer email status, and needs_review. When needs_review is true, prices are withheld until a person at Plain Freight reviews the goods (for example batteries, food or chemicals), and Plain Freight follows up by email.",
      "inputSchema": {
        "properties": {
          "quote_id": {
            "description": "The quote_id of a Plain Freight offer (a UUID)",
            "type": "string"
          }
        },
        "required": [
          "quote_id"
        ],
        "type": "object"
      },
      "name": "check_offer_status",
      "outputSchema": {
        "properties": {
          "email": {
            "description": "Offer email status: sent, queued, deferred, skipped or failed",
            "type": [
              "string",
              "null"
            ]
          },
          "error": {
            "type": "string"
          },
          "needs_review": {
            "type": "boolean"
          },
          "options": {
            "items": {
              "properties": {
                "duties_included": {
                  "description": "true when US import duty is inside the price (DDP); false when duty is paid to the government at import",
                  "type": "boolean"
                },
                "firm": {
                  "description": "false means an estimate confirmed before booking",
                  "type": "boolean"
                },
                "includes": {
                  "description": "Exactly what this price covers",
                  "type": "string"
                },
                "key": {
                  "description": "air, sea or express",
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "price": {
                  "description": "Price in USD for the whole shipment",
                  "type": "number"
                },
                "transit": {
                  "description": "Door to door transit estimate",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "questions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "quote_id": {
            "type": "string"
          },
          "settled": {
            "type": "boolean"
          },
          "text": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Rough price estimate for shipping goods from China to a US address, 100 g to 2,000 kg. Records nothing, contacts no one and needs no email. Inputs: total weight, and optionally the product and carton sizes or total volume. Returns estimated door to door prices in USD for air (and sea from 100 kg chargeable weight), the chargeable weight used (the greater of actual weight and carton volume in cm3 / 6,000), transit estimates, and whether US import duty is included. Figures come from Plain Freight's pricing engine for densely packed goods, priced on the applicable rate; goods that need a review get no figure. The exact ZIP code, pickup city and cartons can move the price, so the result is an estimate, not an offer.",
      "inputSchema": {
        "properties": {
          "carton_count": {
            "description": "Number of cartons of that size",
            "minimum": 1,
            "type": "integer"
          },
          "carton_height_cm": {
            "description": "One carton's height in cm",
            "type": "number"
          },
          "carton_length_cm": {
            "description": "One carton's length in cm",
            "type": "number"
          },
          "carton_width_cm": {
            "description": "One carton's width in cm",
            "type": "number"
          },
          "product": {
            "description": "What is being shipped, in a few words (sets the goods rate)",
            "type": "string"
          },
          "total_cbm": {
            "description": "Total volume in cubic meters, if known instead of carton sizes",
            "type": "number"
          },
          "weight_kg": {
            "description": "Total actual weight of the shipment in kg",
            "maximum": 2000,
            "minimum": 0.1,
            "type": "number"
          }
        },
        "required": [
          "weight_kg"
        ],
        "type": "object"
      },
      "name": "estimate_price",
      "outputSchema": {
        "properties": {
          "actual_kg": {
            "type": "number"
          },
          "chargeable_kg": {
            "type": "number"
          },
          "error": {
            "type": "string"
          },
          "estimate": {
            "description": "Always true: a rough figure, not an offer",
            "type": "boolean"
          },
          "goods": {
            "properties": {
              "category": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "explanation": {
                "type": "string"
              },
              "have_ready": {
                "description": "Documents or details the person will ask for",
                "type": [
                  "string",
                  "null"
                ]
              },
              "verdict": {
                "description": "instant_offer: priced at once; branded_rate: priced at once on its applicable rate; person_checks_first: no price until a person reviews the goods",
                "enum": [
                  "instant_offer",
                  "branded_rate",
                  "person_checks_first"
                ],
                "type": "string"
              }
            },
            "type": "object"
          },
          "next_step": {
            "type": "string"
          },
          "options": {
            "items": {
              "properties": {
                "duty_included": {
                  "type": "boolean"
                },
                "estimate_usd": {
                  "description": "Estimated price in USD for the whole shipment",
                  "type": "number"
                },
                "label": {
                  "type": "string"
                },
                "mode": {
                  "enum": [
                    "air",
                    "sea"
                  ],
                  "type": "string"
                },
                "per_kg_usd": {
                  "type": "number"
                },
                "transit": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "priced_as": {
            "enum": [
              "general",
              "branded"
            ],
            "type": "string"
          },
          "priced_on": {
            "description": "Date the pricing engine produced these figures",
            "type": "string"
          },
          "volumetric_kg": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Prices a real shipment from China to a US address, 100 g to 2,000 kg, on Plain Freight's live pricing engine. Returns door to door prices in USD: each option covers freight, US customs clearance and delivery, and says whether US import duty is included (DDP) or paid at import. Carton dimensions affect the price: for light, bulky cargo the volumetric weight sets it. Side effects: each call records a separate quote request with Plain Freight, and if an email is given the written offer is emailed to that address once a second check settles (at most one offer email per address per day). Nothing is booked or charged. The result carries a quote_id, by which the second check's verdict can be read.",
      "inputSchema": {
        "properties": {
          "destination_zip": {
            "description": "US destination ZIP code of the shipment",
            "type": "string"
          },
          "dimensions": {
            "description": "Cartons and size, e.g. '4 cartons, 60x40x35 cm each'",
            "type": "string"
          },
          "email": {
            "description": "Optional. Address the written offer is mailed to; replying to that email is one way to book.",
            "type": "string"
          },
          "name": {
            "description": "Optional. The name to address the offer email to",
            "type": "string"
          },
          "notes": {
            "description": "Optional shipment facts: HS code, Amazon FBA requirements, delivery constraints, certifications held",
            "type": "string"
          },
          "origin": {
            "description": "Pickup city or supplier's city in China",
            "type": "string"
          },
          "product": {
            "description": "What is being shipped, e.g. 'LED desk lamps, 500 units'",
            "type": "string"
          },
          "urgency": {
            "enum": [
              "Not urgent",
              "Need best balance of cost and speed",
              "Urgent"
            ],
            "type": "string"
          },
          "weight_kg": {
            "description": "Total weight in kg (0.1 to 2000)",
            "maximum": 2000,
            "minimum": 0.1,
            "type": "number"
          }
        },
        "required": [
          "product",
          "weight_kg"
        ],
        "type": "object"
      },
      "name": "generate_offer",
      "outputSchema": {
        "properties": {
          "agent_review": {
            "enum": [
              "pending",
              "not_running"
            ],
            "type": "string"
          },
          "book_url": {
            "description": "plainfreight.com booking form, prefilled with this shipment and quote",
            "type": "string"
          },
          "contact": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "needs_review": {
            "description": "true: prices withheld until a person clears the goods",
            "type": "boolean"
          },
          "next_step": {
            "type": "string"
          },
          "options": {
            "items": {
              "properties": {
                "duties_included": {
                  "description": "true when US import duty is inside the price (DDP); false when duty is paid to the government at import",
                  "type": "boolean"
                },
                "firm": {
                  "description": "false means an estimate confirmed before booking",
                  "type": "boolean"
                },
                "includes": {
                  "description": "Exactly what this price covers",
                  "type": "string"
                },
                "key": {
                  "description": "air, sea or express",
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "price": {
                  "description": "Price in USD for the whole shipment",
                  "type": "number"
                },
                "transit": {
                  "description": "Door to door transit estimate",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "questions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "quote_id": {
            "description": "Reference for the offer's second check and for booking",
            "type": [
              "string",
              "null"
            ]
          },
          "shipment": {
            "properties": {
              "chargeable_kg": {
                "description": "weight the price is computed on: the greater of actual and volumetric weight",
                "type": "number"
              },
              "destination_zip": {
                "type": "string"
              },
              "dimensions": {
                "type": "string"
              },
              "product": {
                "type": "string"
              },
              "weight_kg": {
                "type": "number"
              }
            },
            "type": "object"
          },
          "summary": {
            "type": "string"
          },
          "valid_days": {
            "type": "number"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Reads a booked Plain Freight shipment from its tracking link. Input: the tracking link from the booking email (https://plainfreight.com/track/<token>) or the bare token; the token is the credential, so only someone the customer shared the link with can read the record. Returns the shipment reference, the current stage on the 10-stage lifecycle (Booking through Delivered), shipment details and the dated event log. Read-only; changes to a booking go by email to [email protected] with the shipment reference.",
      "inputSchema": {
        "properties": {
          "tracking_link": {
            "description": "The tracking URL from the booking email (https://plainfreight.com/track/<token>), or the token by itself",
            "type": "string"
          }
        },
        "required": [
          "tracking_link"
        ],
        "type": "object"
      },
      "name": "track_shipment",
      "outputSchema": {
        "properties": {
          "carrier": {
            "description": "Shown only once the invoice is paid",
            "type": [
              "string",
              "null"
            ]
          },
          "contact": {
            "type": "string"
          },
          "destination_city": {
            "type": [
              "string",
              "null"
            ]
          },
          "error": {
            "type": "string"
          },
          "events": {
            "items": {
              "properties": {
                "customer_note": {
                  "type": "string"
                },
                "happened_at": {
                  "type": "string"
                },
                "status": {
                  "description": "Lifecycle status the event belongs to",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "goods": {
            "type": [
              "string",
              "null"
            ]
          },
          "lifecycle": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "origin_city": {
            "type": [
              "string",
              "null"
            ]
          },
          "record_url": {
            "type": "string"
          },
          "reference": {
            "type": [
              "string",
              "null"
            ]
          },
          "stage": {
            "description": "e.g. '7 of 10'; null when cancelled",
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "status_label": {
            "type": "string"
          },
          "tracking_number": {
            "description": "Shown only once the invoice is paid",
            "type": [
              "string",
              "null"
            ]
          },
          "updated_at": {
            "type": "string"
          },
          "weight_kg": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:10bdc0a73a525fee6dee9767496b6be679a08cf5194f3b8fb7bc92445245fd61 | sha256sum