{
  "source": "devstudio163/frete",
  "revision": "da99c048c36b0db06e49947ba472a92cbdcbf2e1",
  "transport": "Streamable HTTP",
  "serverUrl": "https://app.meuecommerce.com.br/mcp",
  "tools": [
    {
      "name": "get_shipping_rates",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instanceId": {
            "type": "string",
            "description": "Merchant/store id. Ignored on authenticated servers (the merchant comes from the API key); used only on local/unauthenticated servers."
          },
          "destinationCep": {
            "type": "string",
            "description": "Destination Brazilian postal code (CEP). 8 digits; dashes/spaces are ignored."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Product name."
                },
                "quantity": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "description": "Units of this product in the cart."
                },
                "unitPriceBRL": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Unit price in BRL (used for free-shipping thresholds)."
                },
                "weightKg": {
                  "type": "number",
                  "exclusiveMinimum": 0,
                  "description": "Unit weight in kg. Defaults to 0.3kg if omitted."
                }
              },
              "required": [
                "name",
                "quantity",
                "unitPriceBRL"
              ],
              "additionalProperties": false
            },
            "minItems": 1,
            "description": "Cart line items."
          },
          "requestId": {
            "type": "string",
            "description": "Idempotency/correlation id. Auto-generated when omitted."
          }
        },
        "required": [
          "destinationCep",
          "items"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "rates": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "serviceId": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "deliveryDays": {
                  "type": "number"
                },
                "price": {
                  "type": "number"
                },
                "free": {
                  "type": "boolean"
                }
              },
              "required": [
                "code",
                "serviceId",
                "label",
                "deliveryDays",
                "price"
              ],
              "additionalProperties": false
            }
          },
          "reason": {
            "type": "string",
            "description": "Why no rates were returned, when the list is empty."
          },
          "actionUrl": {
            "type": "string",
            "description": "When set (e.g. reason=subscription_required), send the merchant here to finish setup."
          }
        },
        "required": [
          "rates"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "track_shipment",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instanceId": {
            "type": "string",
            "description": "Merchant/store id. Ignored on authenticated servers (the merchant comes from the API key); used only on local/unauthenticated servers."
          },
          "codes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "description": "Correios tracking codes, e.g. \"AA123456789BR\". Spaces are ignored; up to 50 per call."
          }
        },
        "required": [
          "codes"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "found": {
                  "type": "boolean"
                },
                "delivered": {
                  "type": "boolean"
                },
                "lastStatus": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "timestamp": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "origin": {
                      "type": "string"
                    },
                    "destination": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "description"
                  ],
                  "additionalProperties": false
                },
                "events": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string"
                      },
                      "timestamp": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "origin": {
                        "type": "string"
                      },
                      "destination": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "code",
                      "description"
                    ],
                    "additionalProperties": false
                  }
                },
                "message": {
                  "type": "string"
                }
              },
              "required": [
                "code",
                "found",
                "delivered",
                "events"
              ],
              "additionalProperties": false
            }
          },
          "reason": {
            "type": "string",
            "description": "Why no lookup could be performed, when results is empty."
          },
          "actionUrl": {
            "type": "string",
            "description": "When set (e.g. reason=subscription_required), send the merchant here to finish setup."
          }
        },
        "required": [
          "results"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "generate_label",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instanceId": {
            "type": "string",
            "description": "Merchant/store id. Ignored on authenticated servers (the merchant comes from the API key); used only on local/unauthenticated servers."
          },
          "serviceCode": {
            "type": "string",
            "description": "Correios product code, e.g. '03220' (SEDEX) or '03298' (PAC)."
          },
          "weightGrams": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "Package weight in grams."
          },
          "dimensions": {
            "type": "object",
            "properties": {
              "comprimento": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Length in cm."
              },
              "largura": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Width in cm."
              },
              "altura": {
                "type": "number",
                "exclusiveMinimum": 0,
                "description": "Height in cm."
              }
            },
            "required": [
              "comprimento",
              "largura",
              "altura"
            ],
            "additionalProperties": false,
            "description": "Package dimensions in centimeters."
          },
          "objectFormat": {
            "type": "string",
            "enum": [
              "1",
              "2",
              "3"
            ],
            "description": "Object format: '1' envelope, '2' package/box (default), '3' roll."
          },
          "sender": {
            "type": "object",
            "properties": {
              "nome": {
                "type": "string",
                "description": "Full name or company name."
              },
              "cpfCnpj": {
                "type": "string",
                "description": "CPF or CNPJ, digits only."
              },
              "telefone": {
                "type": "string",
                "description": "Phone number."
              },
              "email": {
                "type": "string",
                "description": "Email address."
              },
              "endereco": {
                "type": "object",
                "properties": {
                  "cep": {
                    "type": "string",
                    "description": "CEP (8 digits; dashes/spaces ignored)."
                  },
                  "logradouro": {
                    "type": "string",
                    "description": "Street name."
                  },
                  "numero": {
                    "type": "string",
                    "description": "Street number."
                  },
                  "bairro": {
                    "type": "string",
                    "description": "Neighborhood."
                  },
                  "cidade": {
                    "type": "string",
                    "description": "City."
                  },
                  "uf": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2,
                    "description": "Two-letter state, e.g. 'SP'."
                  },
                  "complemento": {
                    "type": "string",
                    "description": "Address complement (apt, etc.)."
                  }
                },
                "required": [
                  "cep",
                  "logradouro",
                  "numero",
                  "bairro",
                  "cidade",
                  "uf"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "nome",
              "endereco"
            ],
            "additionalProperties": false,
            "description": "Remetente (sender / store)."
          },
          "recipient": {
            "type": "object",
            "properties": {
              "nome": {
                "type": "string",
                "description": "Full name or company name."
              },
              "cpfCnpj": {
                "type": "string",
                "description": "CPF or CNPJ, digits only."
              },
              "telefone": {
                "type": "string",
                "description": "Phone number."
              },
              "email": {
                "type": "string",
                "description": "Email address."
              },
              "endereco": {
                "type": "object",
                "properties": {
                  "cep": {
                    "type": "string",
                    "description": "CEP (8 digits; dashes/spaces ignored)."
                  },
                  "logradouro": {
                    "type": "string",
                    "description": "Street name."
                  },
                  "numero": {
                    "type": "string",
                    "description": "Street number."
                  },
                  "bairro": {
                    "type": "string",
                    "description": "Neighborhood."
                  },
                  "cidade": {
                    "type": "string",
                    "description": "City."
                  },
                  "uf": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2,
                    "description": "Two-letter state, e.g. 'SP'."
                  },
                  "complemento": {
                    "type": "string",
                    "description": "Address complement (apt, etc.)."
                  }
                },
                "required": [
                  "cep",
                  "logradouro",
                  "numero",
                  "bairro",
                  "cidade",
                  "uf"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "nome",
              "endereco"
            ],
            "additionalProperties": false,
            "description": "Destinatário (recipient / customer)."
          },
          "declaredItems": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "conteudo": {
                  "type": "string",
                  "description": "Item description."
                },
                "quantidade": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "description": "Quantity."
                },
                "valor": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Declared unit value in BRL."
                }
              },
              "required": [
                "conteudo",
                "quantidade",
                "valor"
              ],
              "additionalProperties": false
            },
            "minItems": 1,
            "description": "Declaração de conteúdo — required by Correios (at least one item)."
          }
        },
        "required": [
          "serviceCode",
          "weightGrams",
          "dimensions",
          "sender",
          "recipient",
          "declaredItems"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "prepostagemId": {
            "type": "string",
            "description": "Correios pré-postagem id. Pass it to get_label_pdf to fetch the PDF later if it wasn't ready."
          },
          "trackingCode": {
            "type": "string",
            "description": "Código de rastreamento, once the pré-postagem exists."
          },
          "status": {
            "type": "string",
            "description": "Correios pré-postagem status."
          },
          "labelPdfBase64": {
            "type": "string",
            "description": "Base64-encoded label PDF, once ready."
          },
          "reason": {
            "type": "string",
            "description": "Why the label wasn't (fully) produced."
          },
          "actionUrl": {
            "type": "string",
            "description": "When set (e.g. reason=subscription_required), send the merchant here to finish setup."
          }
        },
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    },
    {
      "name": "get_label_pdf",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instanceId": {
            "type": "string",
            "description": "Merchant/store id. Ignored on authenticated servers (the merchant comes from the API key); used only on local/unauthenticated servers."
          },
          "prepostagemId": {
            "type": "string",
            "description": "Correios pré-postagem id, as returned by generate_label in the `prepostagemId` field."
          }
        },
        "required": [
          "prepostagemId"
        ],
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "prepostagemId": {
            "type": "string",
            "description": "The pré-postagem id the PDF belongs to."
          },
          "status": {
            "type": "string",
            "description": "Correios status/business message, when the label isn't printable."
          },
          "labelPdfBase64": {
            "type": "string",
            "description": "Base64-encoded label PDF, once ready."
          },
          "reason": {
            "type": "string",
            "description": "Why the PDF wasn't returned."
          },
          "actionUrl": {
            "type": "string",
            "description": "When set (e.g. reason=subscription_required), send the merchant here to finish setup."
          }
        },
        "additionalProperties": false,
        "$schema": "http://json-schema.org/draft-07/schema#"
      }
    }
  ]
}