Best Smart Goods MCP

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum matches to return. Default 5. Values outside 1 to 20 are clamped."
    },
    "query": {
      "type": "string",
      "description": "Legal name for a GLEIF search. Required when tax_id is omitted. Ignored when tax_id is set."
    },
    "tax_id": {
      "type": "string",
      "description": "EU VAT number. When set, the answer is only the VIES check. A leading country code is used when present."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO code, for example HU. Narrows a name search. Used as the VAT country when tax_id has no leading country code. Defaults to HU for a tax id."
    }
  }
}

{
  "type": "object",
  "required": [
    "credits_remaining",
    "companies"
  ],
  "properties": {
    "companies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "lei": {
            "type": [
              "string",
              "null"
            ],
            "description": "GLEIF LEI when source is gleif."
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "enum": [
              "gleif",
              "vies"
            ],
            "type": "string",
            "description": "gleif for a name search, vies for a VAT check."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Registry status, or vat_valid or vat_invalid for VIES."
          },
          "tax_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO country code."
          },
          "confidence": {
            "type": "number",
            "description": "0.9 for VIES, 0.8 for GLEIF."
          },
          "vies_valid": {
            "type": "boolean",
            "description": "Present only on a VIES row."
          },
          "company_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Registration number when the source provides one."
          }
        }
      },
      "description": "Matches, already limited. Empty when nothing matched."
    },
    "credits_remaining": {
      "type": "number",
      "description": "Balance after this successful call."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}