Skip to main content
Glama

Get retailer profile

get_retailer
Read-onlyIdempotent

Get the public profile of one retailer (shop) on authorized.by. Read-only. Returns address, contact details, opening hours, categories, registration date, tuv_certified (shop identity verified in the TÜV Saarland ShopIdent procedure: an identity check, not a certification of the retailer's business), the number of brands that authorized it, and certificate_url / certificate_url_de: links to the retailer's public authorized.by certificate page (English / German) listing all brands that authorized it. These links are null when the retailer has no active authorization. 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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id_or_alias": "<id_or_alias>"
    },
    "name": "get_retailer"
  }
}

Input Schema

NameRequiredDescriptionDefault
id_or_aliasYesRetailer numeric ID, slug or alias.

Output Schema

NameRequiredDescriptionDefault
idYesNumeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools.
logoYesLogo image URL, or null.
nameYesDisplay name.
slugYesURL-safe identifier. Accepted by the id_or_alias argument of the detail tools.
detailsYesExtended profile details.
shop_urlYesRetailer online-shop URL, or null.
brand_countYesNumber of brands with a public, approved profile that currently authorize this retailer on authorized.by. Only authorizations confirmed by both the brand and the retailer count; pending requests and ended authorizations do not.
tuv_certifiedYesWhether the identity of the shop has been verified in the TÜV Saarland ShopIdent procedure, arranged through authorized.by. It is an identity check of the shop operator, not a certification of the retailer's business, service or products.
certificate_urlYesPublic authorized.by certificate page (English) that proves the authorization: of this brand and retailer where the entry is about both, otherwise the retailer's page listing all brands that authorize it. Null when there is no active authorization.
certificate_url_deYesSame certificate page in German; null when there is no active authorization.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • changedOutput schema / properties / brand_count / description
      Previous value: -"Number of brands that currently authorize this retailer on authorized.by."New value: +"Number of brands with a public, approved profile that currently authorize this retailer on authorized.by. Only authorizations confirmed by both the brand and the retailer count; pending requests and ended authorizations do not."
    • changedOutput schema / properties / certificate_url / description
      Previous value: -"Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."New value: +"Public authorized.by certificate page (English) that proves the authorization: of this brand and retailer where the entry is about both, otherwise the retailer's page listing all brands that authorize it. Null when there is no active authorization."
    • changedOutput schema / properties / details / properties / registration_date / description
      Previous value: -"Date (YYYY-MM-DD) the company registered on authorized.by."New value: +"Date (YYYY-MM-DD) the retailer registered on authorized.by."
    • removedOutput schema / properties / details / properties / trustami
      Removed value: -{
      -  "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"
      -  ]
      -}
    • changedOutput schema / properties / details / properties / tuv_certification_date / description
      Previous value: -"Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified."New value: +"Date (YYYY-MM-DD) the TÜV Saarland ShopIdent verification of the shop's identity was approved; null when there is none. It does not say how long the verification remains valid."
    • changedOutput schema / properties / details / required
      Previous value: -[
      -  "address",
      -  "phone",
      -  "email",
      -  "opening_hours",
      -  "payment_methods",
      -  "description",
      -  "categories",
      -  "tuv_certification_date",
      -  "registration_date",
      -  "trustami",
      -  "social"
      -]New value: +[
      +  "address",
      +  "phone",
      +  "email",
      +  "opening_hours",
      +  "payment_methods",
      +  "description",
      +  "categories",
      +  "tuv_certification_date",
      +  "registration_date",
      +  "social"
      +]
    • removedOutput schema / properties / plan
      Removed value: -{
      -  "description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / seal_implemented
      Removed value: -{
      -  "description": "Whether the authorized.by seal is live on the retailer's shop.",
      -  "type": "boolean"
      -}
    • changedOutput schema / properties / tuv_certified / description
      Previous value: -"Whether the retailer holds a TÜV certification via authorized.by."New value: +"Whether the identity of the shop has been verified in the TÜV Saarland ShopIdent procedure, arranged through authorized.by. It is an identity check of the shop operator, not a certification of the retailer's business, service or products."
    • changedOutput schema / required
      Previous value: -[
      -  "id",
      -  "name",
      -  "slug",
      -  "shop_url",
      -  "logo",
      -  "certificate_url",
      -  "certificate_url_de",
      -  "plan",
      -  "tuv_certified",
      -  "seal_implemented",
      -  "brand_count",
      -  "details"
      -]New value: +[
      +  "id",
      +  "name",
      +  "slug",
      +  "shop_url",
      +  "logo",
      +  "certificate_url",
      +  "certificate_url_de",
      +  "tuv_certified",
      +  "brand_count",
      +  "details"
      +]
  2. Changed3 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / id_or_alias / description
      Previous value: -"Retailer numeric ID or alias."New value: +"Retailer numeric ID, slug or alias."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "description": "The public profile of one retailer.",
      +  "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"
      +      ]
      +    },
      +    "plan": {
      +      "description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE.",
      +      "type": [
      +        "string",
      +        "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"
      +      ]
      +    },
      +    "tuv_certified": {
      +      "description": "Whether the retailer holds a TÜV certification via authorized.by.",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "id",
      +    "name",
      +    "slug",
      +    "shop_url",
      +    "logo",
      +    "certificate_url",
      +    "certificate_url_de",
      +    "plan",
      +    "tuv_certified",
      +    "seal_implemented",
      +    "brand_count",
      +    "details"
      +  ],
      +  "type": "object"
      +}
  3. Added

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive, yet the description adds substantial context beyond them: the meaning of tuv_certified (an identity check, not a business certification), when certificate URLs are null, the boundary of the data domain, and how to disambiguate empty vs. not-found vs. technical errors. That is exactly the behavioral detail the annotations cannot convey.

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?

Front-loaded with purpose, then returns, then scope, then outcome disambiguation — a sensible ordering with no filler sentences. It is dense but long; the error-text taxonomy is verbose, though each branch is actionable rather than redundant.

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?

For a one-parameter read tool with an output schema and full annotations, this covers the remaining gaps an agent would trip on: null certificate links, the carefully scoped meaning of tuv_certified, the limits of the data domain, and empty vs. not-found vs. failure. Nothing material is left to guess.

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

Parameters4/5

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

Schema coverage is 100% for the single parameter, so the baseline is 3; the description earns a small bump by echoing that the input is an 'id/alias' and tying an unknown id/alias to a specific error text, which clarifies what values are accepted in practice. It still adds no syntax or format detail for the slug/alias forms.

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?

Names a specific verb+resource ('Get the public profile of one retailer') and enumerates the returned fields, so the agent knows it is a single-entity fetch rather than a list. The certificate-link behavior and brand-count field distinguish it from siblings like get_retailer_brands or get_retailers without needing their schemas.

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

Usage Guidelines4/5

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

The guidance is clear: use it to read one shop's profile, read-only, with explicit data-scope caveats that the result cannot prove absence of authorization elsewhere. It does not explicitly route to a sibling (e.g. 'use get_retailer_brands to list brands'), so the alternative-selection rule is left implicit.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources