authorized.by MCP Server

What can you ask?

Once connected, you can ask questions such as:

• “Is santosgrills.de an authorized Napoleon retailer?”
• “I found the product with GTIN 00629162151315 at santosgrills.de – is the shop authorized to sell it?”
• “Show me five authorized Deuter retailers and their shop domains.”
• “Which brands is this retailer authorized to sell? Include the certificate links.”
• “Show me the profile and opening hours of the retailer santosgrills.de.”

Results reflect the data returned at the time of your query and may change.

Check an authorization directly

For the question “Is shop X authorized by brand Y?” a single call is enough: verify_retailer_authorization. The tool takes the shop domain plus either the brand or the product number.

When the direct check does not apply

For broader discovery, or when the domain is unclear, use the two-step lookup:

1. Search for the retailer by company name or alias using get_retailers.
2. Compare the returned shop_url with the domain being checked.
3. Use the returned retailer ID or slug with get_retailer_brands.
4. Report only the brand relationships actually returned, each with its certificate link.

Similarly named shops are not necessarily the same business. In the other direction, get_brand_retailers returns all retailers currently authorized by a brand.

Connect your client

Any client that supports remote MCP servers over Streamable HTTP can use the endpoint above. Select no authentication and follow your client’s documentation for the exact configuration format.

claude mcp add --transport http authorized-by https://app.authorized.by/api/public/mcp

{
  "mcpServers": {
    "authorized-by": {
      "url": "https://app.authorized.by/api/public/mcp"
    }
  }
}

{
  "servers": {
    "authorized-by": {
      "type": "http",
      "url": "https://app.authorized.by/api/public/mcp"
    }
  }
}

Use authorized.by to check whether santosgrills.de is an authorized Napoleon retailer. Report the returned status, the start date and the certificate link.

Available tools

Seven tools: one for checking an authorization directly, six for exploring the network in both directions – from brands to their authorized retailers and from retailers to their authorizing brands.

Search pagination starts at 0; the documented default page size is 500. Search filters also match domains and URLs. Pagination indicates whether more results are available. Profile fields may be empty when information is unavailable.

Understanding the results

Retailer lists returned by get_brand_retailers are sorted by subscription plan – PREMIUM, START, FREE – and then by the number of brand connections. This ordering is not a ranking of retailer quality.

Technical details

API examples for developers

These requests use JSON-RPC 2.0 over HTTP POST. Responses include both content and structuredContent.

curl -s https://app.authorized.by/api/public/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

curl -s https://app.authorized.by/api/public/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_brand","arguments":{"id_or_alias":"deuter"}}}'

These examples follow the calls documented in the Markdown. Clients using protocol 2026-07-28 must additionally supply the corresponding _meta fields and headers.

Usage guidelines

The public data is intended for discovering and verifying authorized brand–retailer relationships. Respect the rate limit and, when caching, record the retrieval time.