authorized.by MCP
This MCP server provides AI agents with read-only access to the official authorized.by brand distribution directory. It allows agents to verify if a retailer is authorized by a specific brand, search for brands and retailers, and retrieve detailed profiles including certificate links and TÜV ShopIdent status, supporting trust certification and partner management.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://app.authorized.by/api/public/mcpWhat its tools do
7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to authorized.by ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Verify if a specific online shop is an authorized retailer for a given brand
- Search for brands by name, alias, or website domain
- Retrieve a list of all retailers currently authorized by a specific brand
- Get detailed retailer profiles including contact info and TÜV status
Source and maintenance
Protocol and capabilities
- Server
- authorized-by-brands 1.4.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 7 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
get_brands — Search brands
Search brands (manufacturers) registered on authorized.by, or list them all. Read-only. 'search' matches the brand name, alias or website domain (partial match). Returns for each brand: id, name, slug, logo and the number of retailers it has authorized. Omit 'search' to retrieve the full index; use 'page' and 'size' to paginate. 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.
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Zero-based page number (default 0)."
},
"size": {
"type": "integer",
"description": "Page size (default 500)."
},
"search": {
"type": "string",
"description": "Filter by brand name, alias or website domain/URL, e.g. 'deuter' or 'deuter.com'. Optional."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"brands",
"meta",
"pagination"
],
"properties": {
"meta": {
"type": [
"object",
"null"
],
"required": [
"total_brands",
"total_retailers",
"total_connections",
"generated_at"
],
"properties": {
"generated_at": {
"type": [
"string",
"null"
],
"description": "Timestamp (ISO 8601) the index was generated."
},
"total_brands": {
"type": "integer",
"description": "Total number of public brands on authorized.by."
},
"total_retailers": {
"type": "integer",
"description": "Total number of public retailers on authorized.by."
},
"total_connections": {
"type": "integer",
"description": "Total number of active brand-retailer authorizations on authorized.by."
}
},
"description": "Network-wide totals.",
"additionalProperties": false
},
"brands": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"id",
"name",
"slug",
"logo",
"retailer_count"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"retailer_count": {
"type": "integer",
"description": "Number of retailers currently authorized by this brand on authorized.by."
}
},
"additionalProperties": false
}
},
"pagination": {
"type": [
"object",
"null"
],
"required": [
"page",
"size",
"total_items",
"total_pages"
],
"properties": {
"page": {
"type": "integer",
"description": "Zero-based page number of this response."
},
"size": {
"type": "integer",
"description": "Page size used for this response."
},
"total_items": {
"type": "integer",
"description": "Total number of matching entries across all pages."
},
"total_pages": {
"type": "integer",
"description": "Total number of pages."
}
},
"description": "Pagination of this response.",
"additionalProperties": false
}
},
"description": "A page of brands plus network-wide totals and pagination.",
"additionalProperties": false
}{
"title": "Search brands",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_brand — Get brand profile
Get the public profile of one brand (manufacturer) on authorized.by. Read-only. Returns categories, website, headquarters country, description, registration date and the number of authorized retailers. Use get_brands first if you only know an approximate name. 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.
{
"type": "object",
"required": [
"id_or_alias"
],
"properties": {
"id_or_alias": {
"type": "string",
"description": "Brand numeric ID, slug or alias, e.g. 'deuter' or '16709'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"id",
"name",
"slug",
"website_url",
"logo",
"categories",
"retailer_count",
"product_count",
"details"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"details": {
"type": [
"object",
"null"
],
"required": [
"description",
"hq_country",
"registration_date",
"social"
],
"properties": {
"social": {
"type": [
"object",
"null"
],
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"properties": {
"youtube": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
}
},
"description": "Social media profile URLs; each may be null.",
"additionalProperties": false
},
"hq_country": {
"type": [
"string",
"null"
],
"description": "Headquarters country code, or null."
},
"description": {
"type": [
"object",
"null"
],
"required": [
"de",
"en"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"description": "Description text in German (de) and English (en); each may be null.",
"additionalProperties": false
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
}
},
"description": "Extended profile details.",
"additionalProperties": false
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"id",
"name_de",
"name_en"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name_de": {
"type": [
"string",
"null"
],
"description": "German category name."
},
"name_en": {
"type": [
"string",
"null"
],
"description": "English category name."
}
},
"additionalProperties": false
},
"description": "Product categories."
},
"website_url": {
"type": [
"string",
"null"
],
"description": "Brand website URL, or null."
},
"product_count": {
"type": "integer",
"description": "Number of products registered on authorized.by; null when unknown."
},
"retailer_count": {
"type": "integer",
"description": "Number of retailers currently authorized by this brand on authorized.by."
}
},
"description": "The public profile of one brand.",
"additionalProperties": false
}{
"title": "Get brand profile",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_brand_retailers — List a brand's authorized retailers
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.
{
"type": "object",
"required": [
"id_or_alias"
],
"properties": {
"id_or_alias": {
"type": "string",
"description": "Brand numeric ID, slug or alias."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"brand_id",
"total",
"premium_count",
"tuv_certified_count",
"retailers"
],
"properties": {
"total": {
"type": "integer",
"description": "Number of entries in the list."
},
"brand_id": {
"type": "integer",
"description": "Numeric ID of the brand the list belongs to."
},
"retailers": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"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"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"plan": {
"type": [
"string",
"null"
],
"description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"details": {
"type": [
"object",
"null"
],
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"social": {
"type": [
"object",
"null"
],
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"properties": {
"youtube": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
}
},
"description": "Social media profile URLs; each may be null.",
"additionalProperties": false
},
"address": {
"type": [
"string",
"null"
]
},
"trustami": {
"type": [
"object",
"null"
],
"required": [
"rating",
"review_count",
"profile_url"
],
"properties": {
"rating": {
"type": [
"number",
"null"
],
"description": "Average customer rating, or null."
},
"profile_url": {
"type": [
"string",
"null"
],
"description": "URL of the rating profile, or null."
},
"review_count": {
"type": [
"integer",
"null"
],
"description": "Number of customer reviews, or null."
}
},
"description": "Customer rating from Trustami; fields are null when no rating exists.",
"additionalProperties": false
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"de",
"en"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"additionalProperties": false
},
"description": "Product categories."
},
"description": {
"type": [
"object",
"null"
],
"required": [
"de",
"en"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"description": "Description text in German (de) and English (en); each may be null.",
"additionalProperties": false
},
"opening_hours": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"properties": {
"day_of_week": {
"type": [
"string",
"null"
],
"description": "Day of the week."
},
"closing_hour": {
"type": [
"string",
"null"
],
"description": "Closing time."
},
"opening_hour": {
"type": [
"string",
"null"
],
"description": "Opening time."
}
},
"additionalProperties": false
},
"description": "Weekly opening hours of the physical store; empty or null when unknown."
},
"payment_methods": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Accepted payment methods; null when unknown."
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
},
"tuv_certification_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified."
}
},
"description": "Extended profile details.",
"additionalProperties": false
},
"shop_url": {
"type": [
"string",
"null"
],
"description": "Retailer online-shop URL, or null."
},
"sponsored": {
"type": "boolean",
"description": "Whether the brand sponsors (highlights) this retailer."
},
"brand_count": {
"type": "integer",
"description": "Number of brands that currently authorize this retailer on authorized.by."
},
"official_shop": {
"type": "boolean",
"description": "Whether this shop is the brand's own official shop."
},
"product_count": {
"type": [
"integer",
"null"
],
"description": "Number of products registered on authorized.by; null when unknown."
},
"tuv_certified": {
"type": "boolean",
"description": "Whether the retailer holds a TÜV certification via authorized.by."
},
"certificate_url": {
"type": [
"string",
"null"
],
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."
},
"partnership_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response."
},
"seal_implemented": {
"type": "boolean",
"description": "Whether the authorized.by seal is live on the retailer's shop."
},
"certificate_url_de": {
"type": [
"string",
"null"
],
"description": "Same certificate page in German; null when there is no active authorization."
}
},
"additionalProperties": false
}
},
"premium_count": {
"type": "integer",
"description": "Number of listed retailers on the PREMIUM plan."
},
"tuv_certified_count": {
"type": "integer",
"description": "Number of listed retailers with a TÜV certification."
}
},
"description": "All retailers currently authorized by the brand, with per-retailer certificate links.",
"additionalProperties": false
}{
"title": "List a brand's authorized retailers",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_retailers — Search retailers
Search retailers (shops) registered on authorized.by, or list them all. Read-only. 'search' matches the company name, alias or shop domain (partial match): a URL is reduced to its domain, except on marketplace hosts such as amazon.de or ebay.de, where the store path is kept and the bare host lists every seller. A partial match can find other shops (shop.de also finds myshop.de), so compare shop_url with the domain you are checking; to verify one shop against a brand, use verify_retailer_authorization. Returns for each retailer: id, name, slug, shop URL, logo, the number of brands that authorized it, and seal_implemented (whether the authorized.by seal is live on their shop). Omit 'search' to retrieve the full index; use 'page' and 'size' to paginate. 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.
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Zero-based page number (default 0)."
},
"size": {
"type": "integer",
"description": "Page size (default 500)."
},
"search": {
"type": "string",
"description": "Filter by retailer company name, alias or shop domain/URL, e.g. 'best-shop' or 'best-shop.de'. Optional."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"retailers",
"meta",
"pagination"
],
"properties": {
"meta": {
"type": [
"object",
"null"
],
"required": [
"total_brands",
"total_retailers",
"total_connections",
"generated_at"
],
"properties": {
"generated_at": {
"type": [
"string",
"null"
],
"description": "Timestamp (ISO 8601) the index was generated."
},
"total_brands": {
"type": "integer",
"description": "Total number of public brands on authorized.by."
},
"total_retailers": {
"type": "integer",
"description": "Total number of public retailers on authorized.by."
},
"total_connections": {
"type": "integer",
"description": "Total number of active brand-retailer authorizations on authorized.by."
}
},
"description": "Network-wide totals.",
"additionalProperties": false
},
"retailers": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"id",
"name",
"slug",
"shop_url",
"logo",
"seal_implemented",
"brand_count",
"details"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"details": {
"type": [
"object",
"null"
],
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"social": {
"type": [
"object",
"null"
],
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"properties": {
"youtube": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
}
},
"description": "Social media profile URLs; each may be null.",
"additionalProperties": false
},
"address": {
"type": [
"string",
"null"
]
},
"trustami": {
"type": [
"object",
"null"
],
"required": [
"rating",
"review_count",
"profile_url"
],
"properties": {
"rating": {
"type": [
"number",
"null"
],
"description": "Average customer rating, or null."
},
"profile_url": {
"type": [
"string",
"null"
],
"description": "URL of the rating profile, or null."
},
"review_count": {
"type": [
"integer",
"null"
],
"description": "Number of customer reviews, or null."
}
},
"description": "Customer rating from Trustami; fields are null when no rating exists.",
"additionalProperties": false
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"de",
"en"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"additionalProperties": false
},
"description": "Product categories."
},
"description": {
"type": [
"object",
"null"
],
"required": [
"de",
"en"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"description": "Description text in German (de) and English (en); each may be null.",
"additionalProperties": false
},
"opening_hours": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"properties": {
"day_of_week": {
"type": [
"string",
"null"
],
"description": "Day of the week."
},
"closing_hour": {
"type": [
"string",
"null"
],
"description": "Closing time."
},
"opening_hour": {
"type": [
"string",
"null"
],
"description": "Opening time."
}
},
"additionalProperties": false
},
"description": "Weekly opening hours of the physical store; empty or null when unknown."
},
"payment_methods": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Accepted payment methods; null when unknown."
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
},
"tuv_certification_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified."
}
},
"description": "Extended profile details.",
"additionalProperties": false
},
"shop_url": {
"type": [
"string",
"null"
],
"description": "Retailer online-shop URL, or null."
},
"brand_count": {
"type": "integer",
"description": "Number of brands that currently authorize this retailer on authorized.by."
},
"seal_implemented": {
"type": "boolean",
"description": "Whether the authorized.by seal is live on the retailer's shop."
}
},
"additionalProperties": false
}
},
"pagination": {
"type": [
"object",
"null"
],
"required": [
"page",
"size",
"total_items",
"total_pages"
],
"properties": {
"page": {
"type": "integer",
"description": "Zero-based page number of this response."
},
"size": {
"type": "integer",
"description": "Page size used for this response."
},
"total_items": {
"type": "integer",
"description": "Total number of matching entries across all pages."
},
"total_pages": {
"type": "integer",
"description": "Total number of pages."
}
},
"description": "Pagination of this response.",
"additionalProperties": false
}
},
"description": "A page of retailers plus network-wide totals and pagination.",
"additionalProperties": false
}{
"title": "Search retailers",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_retailer — Get retailer profile
Get the public profile of one retailer (shop) on authorized.by. Read-only. Returns address, contact details, opening hours, categories, subscription plan, TÜV certification, customer rating, registration date, seal_implemented (whether the authorized.by seal is live on their shop), 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.
{
"type": "object",
"required": [
"id_or_alias"
],
"properties": {
"id_or_alias": {
"type": "string",
"description": "Retailer numeric ID, slug or alias."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"id",
"name",
"slug",
"shop_url",
"logo",
"certificate_url",
"certificate_url_de",
"plan",
"tuv_certified",
"seal_implemented",
"brand_count",
"details"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"plan": {
"type": [
"string",
"null"
],
"description": "authorized.by subscription plan of the retailer: PREMIUM, START or FREE."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"details": {
"type": [
"object",
"null"
],
"required": [
"address",
"phone",
"email",
"opening_hours",
"payment_methods",
"description",
"categories",
"tuv_certification_date",
"registration_date",
"trustami",
"social"
],
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"social": {
"type": [
"object",
"null"
],
"required": [
"instagram",
"facebook",
"linkedin",
"youtube"
],
"properties": {
"youtube": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
}
},
"description": "Social media profile URLs; each may be null.",
"additionalProperties": false
},
"address": {
"type": [
"string",
"null"
]
},
"trustami": {
"type": [
"object",
"null"
],
"required": [
"rating",
"review_count",
"profile_url"
],
"properties": {
"rating": {
"type": [
"number",
"null"
],
"description": "Average customer rating, or null."
},
"profile_url": {
"type": [
"string",
"null"
],
"description": "URL of the rating profile, or null."
},
"review_count": {
"type": [
"integer",
"null"
],
"description": "Number of customer reviews, or null."
}
},
"description": "Customer rating from Trustami; fields are null when no rating exists.",
"additionalProperties": false
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"de",
"en"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"additionalProperties": false
},
"description": "Product categories."
},
"description": {
"type": [
"object",
"null"
],
"required": [
"de",
"en"
],
"properties": {
"de": {
"type": [
"string",
"null"
],
"description": "German text, or null."
},
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null."
}
},
"description": "Description text in German (de) and English (en); each may be null.",
"additionalProperties": false
},
"opening_hours": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"day_of_week",
"opening_hour",
"closing_hour"
],
"properties": {
"day_of_week": {
"type": [
"string",
"null"
],
"description": "Day of the week."
},
"closing_hour": {
"type": [
"string",
"null"
],
"description": "Closing time."
},
"opening_hour": {
"type": [
"string",
"null"
],
"description": "Opening time."
}
},
"additionalProperties": false
},
"description": "Weekly opening hours of the physical store; empty or null when unknown."
},
"payment_methods": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Accepted payment methods; null when unknown."
},
"registration_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the company registered on authorized.by."
},
"tuv_certification_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the TÜV certification was granted; null when not certified."
}
},
"description": "Extended profile details.",
"additionalProperties": false
},
"shop_url": {
"type": [
"string",
"null"
],
"description": "Retailer online-shop URL, or null."
},
"brand_count": {
"type": "integer",
"description": "Number of brands that currently authorize this retailer on authorized.by."
},
"tuv_certified": {
"type": "boolean",
"description": "Whether the retailer holds a TÜV certification via authorized.by."
},
"certificate_url": {
"type": [
"string",
"null"
],
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."
},
"seal_implemented": {
"type": "boolean",
"description": "Whether the authorized.by seal is live on the retailer's shop."
},
"certificate_url_de": {
"type": [
"string",
"null"
],
"description": "Same certificate page in German; null when there is no active authorization."
}
},
"description": "The public profile of one retailer.",
"additionalProperties": false
}{
"title": "Get retailer profile",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_retailer_brands — List a retailer's authorized brands
List all brands a retailer (shop) is currently authorized to sell, according to authorized.by. Read-only. Use this to answer 'which brands has shop X been authorized for?'. Sorted by brand name. Each entry includes 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.
{
"type": "object",
"required": [
"id_or_alias"
],
"properties": {
"id_or_alias": {
"type": "string",
"description": "Retailer numeric ID, slug or alias."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"retailer_id",
"total",
"brands"
],
"properties": {
"total": {
"type": "integer",
"description": "Number of entries in the list."
},
"brands": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"id",
"name",
"slug",
"website_url",
"logo",
"official_shop",
"certificate_url",
"certificate_url_de",
"partnership_date"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo image URL, or null."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"website_url": {
"type": [
"string",
"null"
],
"description": "Brand website URL, or null."
},
"official_shop": {
"type": "boolean",
"description": "Whether this shop is the brand's own official shop."
},
"certificate_url": {
"type": [
"string",
"null"
],
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."
},
"partnership_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response."
},
"certificate_url_de": {
"type": [
"string",
"null"
],
"description": "Same certificate page in German; null when there is no active authorization."
}
},
"additionalProperties": false
}
},
"retailer_id": {
"type": "integer",
"description": "Numeric ID of the retailer the list belongs to."
}
},
"description": "All brands that currently authorize the retailer, with per-brand certificate links.",
"additionalProperties": false
}{
"title": "List a retailer's authorized brands",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}verify_retailer_authorization — Verify a retailer's authorization
Check whether a shop is an authorized retailer of a brand, from the shop's domain or URL plus the brand or one of its products' GTIN (EAN). Read-only. Use this when you know the seller's domain, e.g. from a shopping or UCP catalog result. Pass exactly one of 'brand' or 'gtin'; a GTIN resolves the product's brand and the check stays brand-level. status: AUTHORIZED = authorization active: the brand has confirmed this shop on authorized.by; official_shop, partnership_date and certificate_url / certificate_url_de prove it, share the certificate link when a user needs proof. NO_RECORD_FOR_BRAND = the shop and the brand are on authorized.by, but this brand has not confirmed this shop there (also when a GTIN belongs to several brands and not exactly one confirmed it; brand is then null). RETAILER_NOT_REGISTERED = no public shop on authorized.by at this domain. BRAND_NOT_REGISTERED = no public brand or product matches 'brand' or 'gtin'. None of these statuses means that the shop is unauthorized. Domains match exactly, never a parent domain or another subdomain (www. and m. count as the same shop); marketplace hosts such as amazon.de or ebay.de only match the exact store URL. The answer is computed live, never cached. 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.
{
"type": "object",
"required": [
"retailer_domain"
],
"properties": {
"gtin": {
"type": "string",
"description": "GTIN / EAN of a product of the brand, 8 to 14 or 18 digits. Omit when passing 'brand'."
},
"brand": {
"type": "string",
"description": "Brand numeric ID, slug, alias or website domain, e.g. 'deuter' or 'deuter.com'. Use get_brands to find the slug from a name. Omit when passing 'gtin'."
},
"retailer_domain": {
"type": "string",
"description": "Shop domain or URL, e.g. 'best-shop.de' or 'https://www.best-shop.de/de/grills'."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"status",
"retailer_domain",
"gtin",
"retailer",
"brand",
"official_shop",
"partnership_date",
"certificate_url",
"certificate_url_de",
"checked_at"
],
"properties": {
"gtin": {
"type": [
"string",
"null"
],
"description": "The checked GTIN, normalized to 14 digits (18 for GTIN-18); null when checked by brand."
},
"brand": {
"type": [
"object",
"null"
],
"required": [
"id",
"name",
"slug",
"website_url"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"website_url": {
"type": [
"string",
"null"
],
"description": "Brand website URL, or null."
}
},
"description": "The checked brand; null when the shop or the brand is not registered, or when a GTIN matches several brands and not exactly one of them confirmed the shop.",
"additionalProperties": false
},
"status": {
"enum": [
"AUTHORIZED",
"NO_RECORD_FOR_BRAND",
"RETAILER_NOT_REGISTERED",
"BRAND_NOT_REGISTERED",
null
],
"type": [
"string",
"null"
],
"description": "Outcome of the check: AUTHORIZED (authorization active), NO_RECORD_FOR_BRAND, RETAILER_NOT_REGISTERED or BRAND_NOT_REGISTERED. None of them means that the shop is unauthorized."
},
"retailer": {
"type": [
"object",
"null"
],
"required": [
"id",
"name",
"slug",
"shop_url"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric authorized.by ID. Accepted by the id_or_alias argument of the detail tools."
},
"name": {
"type": [
"string",
"null"
],
"description": "Display name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "URL-safe identifier. Accepted by the id_or_alias argument of the detail tools."
},
"shop_url": {
"type": [
"string",
"null"
],
"description": "Retailer online-shop URL, or null."
}
},
"description": "The authorized.by shop registered at this domain; null when there is none.",
"additionalProperties": false
},
"checked_at": {
"type": [
"string",
"null"
],
"description": "Timestamp (ISO 8601) the check was made; answers are never cached."
},
"official_shop": {
"type": [
"boolean",
"null"
],
"description": "Whether this shop is the brand's own official shop."
},
"certificate_url": {
"type": [
"string",
"null"
],
"description": "Public authorized.by certificate page (English) that proves the authorization; null when there is no active authorization."
},
"retailer_domain": {
"type": [
"string",
"null"
],
"description": "The checked shop domain and path, as parsed from the request."
},
"partnership_date": {
"type": [
"string",
"null"
],
"description": "Date (YYYY-MM-DD) the authorization STARTED. Not a last-verified date: every listed partnership is active as of the response."
},
"certificate_url_de": {
"type": [
"string",
"null"
],
"description": "Same certificate page in German; null when there is no active authorization."
}
},
"description": "Outcome of the authorization check, with certificate links when AUTHORIZED.",
"additionalProperties": false
}{
"title": "Verify a retailer's authorization",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1006 ms
- 95th percentile latency
- 1006 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1006 ms · metadata changed · 7 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http authorized-by-mcp https://app.authorized.by/api/public/mcpCodex
codex mcp add authorized-by-mcp --url https://app.authorized.by/api/public/mcpCursor
{
"mcpServers": {
"authorized-by-mcp": {
"url": "https://app.authorized.by/api/public/mcp"
}
}
}Cline
{
"mcpServers": {
"authorized-by-mcp": {
"type": "streamableHttp",
"url": "https://app.authorized.by/api/public/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"authorized-by-mcp": {
"type": "http",
"url": "https://app.authorized.by/api/public/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http authorized-by-mcp https://app.authorized.by/api/public/mcpClaude Desktop
https://app.authorized.by/api/public/mcpWindsurf
{
"mcpServers": {
"authorized-by-mcp": {
"serverUrl": "https://app.authorized.by/api/public/mcp"
}
}
}Let your agent find its tools
Find servers like authorized.by MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run authorized.by MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.