brands

List a brand's authorized retailers

get_brand_retailers

Read-onlyIdempotent

List all retailers (shops) currently authorized by a brand on authorized.by. Read-only. Use this to list a brand's authorized shops; to check one shop by its domain or URL, use verify_retailer_authorization. Sorted by subscription plan (PREMIUM, then START, then FREE) and then by brand-connection count descending. Each retailer includes shop_url, seal_implemented (whether the authorized.by seal is live on their shop), official_shop, partnership_date, and certificate_url / certificate_url_de: links to the public authorized.by certificate page (English / German) proving this specific brand-retailer authorization. Share the certificate link when a user needs verifiable proof. Only active partnerships are returned: confirmed by both the brand and the retailer, with both profiles public and the brand approved by authorized.by. Revoked or pending partnerships are never listed. Responses are cached and refreshed when the underlying profile or partnership changes, so a revocation may take a short time to disappear. partnership_date is the date the authorization STARTED, not the date it was last verified; a partnership listed here is currently active as of the response time. Data scope: results only cover relationships registered and confirmed on authorized.by. An empty result or a not-found error does NOT prove that no authorization exists outside authorized.by. Distinguish outcomes: an empty list means no matching record on authorized.by; an error result whose text starts with 'Brand not found' or 'Retailer not found' means the given id/alias is unknown; an error result whose text starts with 'Tool execution failed' is a technical error and says nothing about the data.

Input Schema

Name	Required	Description	Default
`id_or_alias`	Yes	Brand numeric ID, slug or alias.

Output Schema

Name	Required	Description
`total`	Yes	Number of entries in the list.
`brand_id`	Yes	Numeric ID of the brand the list belongs to.
`retailers`	Yes
`premium_count`	Yes	Number of listed retailers on the PREMIUM plan.
`tuv_certified_count`	Yes	Number of listed retailers with a TÜV certification.

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedSep 14, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

changedInput schema / properties / id_or_alias / description

Previous value: -"Brand numeric ID or alias."New value: +"Brand numeric ID, slug or alias."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "description": "All retailers currently authorized by the brand, with per-retailer certificate links.",
+  "properties": {
+    "brand_id": {
+      "description": "Numeric ID of the brand the list belongs to.",
+      "type": "integer"
+    },
+    "premium_count": {
+      "description": "Number of listed retailers on the PREMIUM plan.",
+      "type": "integer"
+    },
+    "retailers": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "brand_count": {
+            "description": "Number of brands that currently authorize this retailer on authorized.by.",
+            "type": "integer"
+          },
+          "certificate_url": {
+            "description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "certificate_url_de": {
+            "description": "Same certificate page in German; null when there is no active authorization.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "details": {
+            "additionalProperties": false,
+            "description": "Extended profile details.",
+            "properties": {
+              "address": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "categories": {
+                "description": "Product categories.",
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "de": {
+                      "description": "German text, or null.",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "en": {
+                      "description": "English text, or null.",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "de",
+                    "en"
+                  ],
+                  "type": "object"
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "description": {
+                "additionalProperties": false,
+                "description": "Description text in German (de) and English (en); each may be null.",
+                "properties": {
+                  "de": {
+                    "description": "German text, or null.",
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "en": {
+                    "description": "English text, or null.",
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "de",
+                  "en"
+                ],
+                "type": [
+                  "object",
+                  "null"
+                ]
+              },
+              "email": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "opening_hours": {
+                "description": "Weekly opening hours of the physical store; empty or null when unknown.",
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "closing_hour": {
+                      "description": "Closing time.",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "day_of_week": {
+                      "description": "Day of the week.",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "opening_hour": {
+                      "description": "Opening time.",
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "day_of_week",
+                    "opening_hour",
+                    "closing_hour"
+                  ],
+                  "type": "object"
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "payment_methods": {
+                "description": "Accepted payment methods; null when unknown.",
+                "items": {
+                  "type": "string"
+                },
+                "type": [
+                  "array",
+                  "null"
+                ]
+              },
+              "phone": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "registration_date": {
+                "description": "Date (YYYY-MM-DD) the company registered on authorized.by.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "social": {
+                "additionalProperties": false,
+                "description": "Social media profile URLs; each may be null.",
+                "properties": {
+                  "facebook": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "instagram": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "linkedin": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "youtube": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "instagram",
+                  "facebook",
+                  "linkedin",
+                  "youtube"
+                ],
+                "type": [
+                  "object",
+                  "null"
+                ]
+              },
+              "trustami": {
+                "additionalProperties": false,
+                "description": "Customer rating from Trustami; fields are null when no rating exists.",
+                "properties": {
+                  "profile_url": {
+                    "description": "URL of the rating profile, or null.",
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "rating": {
+                    "description": "Average customer rating, or null.",
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "review_count": {
+                    "description": "Number of customer reviews, or null.",
+                    "type": [
+                      "integer",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "rating",
+                  "review_count",
+                  "profile_url"
+                ],
+                "type": [
+                  "object",
+                  "null"
+                ]
+              },
+              "tuv_certification_date": {
+                "description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "address",
+              "phone",
+              "email",
+              "opening_hours",
+              "payment_methods",
+              "description",
+              "categories",
+              "tuv_certification_date",
+              "registration_date",
+              "trustami",
+              "social"
+            ],
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "id": {
+            "description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.",
+            "type": "integer"
+          },
+          "logo": {
+            "description": "Logo image URL, or null.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "name": {
+            "description": "Display name.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "official_shop": {
+            "description": "Whether this shop is the brand's own official shop.",
+            "type": "boolean"
+          },
+          "partnership_date": {
+            "description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "plan": {
+            "description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "product_count": {
+            "description": "Number of products registered on authorized.by; null when unknown.",
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "seal_implemented": {
+            "description": "Whether the authorized.by seal is live on the retailer's shop.",
+            "type": "boolean"
+          },
+          "shop_url": {
+            "description": "Retailer online-shop URL, or null.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "slug": {
+            "description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "sponsored": {
+            "description": "Whether the brand sponsors (highlights) this retailer.",
+            "type": "boolean"
+          },
+          "tuv_certified": {
+            "description": "Whether the retailer holds a TÜV certification via authorized.by.",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "slug",
+          "shop_url",
+          "logo",
+          "plan",
+          "tuv_certified",
+          "seal_implemented",
+          "official_shop",
+          "sponsored",
+          "certificate_url",
+          "certificate_url_de",
+          "brand_count",
+          "product_count",
+          "partnership_date",
+          "details"
+        ],
+        "type": "object"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "total": {
+      "description": "Number of entries in the list.",
+      "type": "integer"
+    },
+    "tuv_certified_count": {
+      "description": "Number of listed retailers with a TÜV certification.",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "brand_id",
+    "total",
+    "premium_count",
+    "tuv_certified_count",
+    "retailers"
+  ],
+  "type": "object"
+}

First observedJun 25, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well past the annotations (readOnly, idempotent, openWorld) by disclosing caching and refresh lag, the active-only filter definition (both parties confirmed, public profiles, brand approved), and the exclusion of revoked/pending partnerships. It also supplies an error taxonomy ('Brand not found' / 'Tool execution failed') that changes how results should be interpreted.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well front-loaded: purpose, routing, then behavioral details, then caveats. Every section is useful, but the field-by-field enumeration (shop_url, seal_implemented, certificate_url...) is somewhat verbose given an output schema exists, and the sort-order and data-scope passages could be tighter.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given an output schema is present, the description more than covers what the schema cannot: authorization scope on authorized.by, active-only semantics, cache staleness, and outcome disambiguation. Nothing an agent needs to call and interpret this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the single parameter already documents 'Brand numeric ID, slug or alias', so the description adds little syntax-level detail beyond repeating the id/alias concept in its error section. Baseline 3 is appropriate when the schema carries the parameter burden.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb+resource ('List all retailers (shops) currently authorized by a brand on authorized.by') with an explicit contrast against the sibling verify_retailer_authorization. An agent can distinguish this from get_retailer_brands or get_retailers without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

States the use case ('list a brand's authorized shops') and names the alternative plus the condition that selects it ('to check one shop by its domain or URL, use verify_retailer_authorization'). It also defines when an empty list versus an error result applies, giving the agent explicit interpretation rules.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All brands tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?