Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OZDISAN_LANGNoLanguage for category and property names (`tr` or `en`).tr
OZDISAN_CURRENCYNoDefault currency (`TRY`, `USD`, or `EUR`).TRY
OZDISAN_CACHE_DIRNoDisk cache directory for the category tree.~/.cache/ozdisan-mcp
OZDISAN_DISK_CACHENoSet to `0` to disable the disk cache.açık
OZDISAN_TIMEOUT_MSNoRequest timeout in milliseconds.30000
OZDISAN_DOWNLOAD_DIRNoDirectory where datasheet PDFs are downloaded.~/Downloads/ozdisan-datasheets
OZDISAN_MAX_CONCURRENCYNoMaximum number of concurrent requests.2
OZDISAN_MAX_DOWNLOAD_MBNoMaximum downloadable file size in megabytes.50
OZDISAN_MIN_INTERVAL_MSNoMinimum interval between two requests in milliseconds.250

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Özdisan Elektronik (ozdisan.com) — Türkiye'nin en büyük elektronik komponent distribütörü — için salt-okunur katalog erişimi. ~1 milyon ürün, binlerce kategori, kategoriye özel parametrik filtreler, stok, fiyat kırılımları (KDV hariç) ve datasheet'ler.

Recommended workflows:

  • Known part number → get_product (or search_products for partial numbers).

  • Component selection by requirements → search_categories → get_category_filters → filter_products (in_stock=true, sort by price) → get_product → read_datasheet.

  • Out of stock / EOL part → get_alternatives.

  • Choosing between candidates → compare_products.

  • Final BOM cost & availability → check_bom. The 'product' field in results is Özdisan's product code; pass it to other tools. Category and property names are Turkish by default (language='en' for English).

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_productsA

Keyword / part-number search across all ~1M Özdisan products (e.g. 'STM32F103', 'LM317', 'NE555', '10uF 0805', 'ESP32'). Returns how many matches each category has, the best matching products with stock, starting price (VAT excluded) and key specs, and quick matches from other categories. Pass 'category' to search only inside one category. For parametric selection (e.g. 'LDO 3.3V 500mA SOT-23') prefer search_categories → get_category_filters → filter_products.

filter_productsA

Parametric product search inside a category, like the filter panel on ozdisan.com. Combine property filters (exact option values from get_category_filters), numeric ranges with units, manufacturers, stock/RoHS/datasheet flags, keyword, sorting and pagination. Returns products with stock, MOQ, the price break(s) relevant to 'quantity' (VAT excluded; get_product returns the full price table) and specs. Multiple values for the same property are OR'ed; different properties are AND'ed.

get_productA

Full details of one product: manufacturer, part number, description, lifecycle status, RoHS, category path, all technical specs, stock, incoming stock, lead time, MOQ / order multiple / MPQ, quantity price breaks (VAT excluded), datasheet URL, image and product page URL. Optionally includes substitutes / similar products / accessories.

get_alternativesA

Find replacement options for a product: 'substitute' (drop-in equivalents / muadil), 'similar' (benzer), 'accessory' (complementary products), and 'parametric' (other products in the same category with the same key specs). Useful when a part is out of stock, end-of-life or too expensive.

compare_productsA

Compare 2-10 products side by side: specs aligned by property (with the properties that differ highlighted), stock, MOQ, lead time and price at a given quantity.

check_bomA

Check a bill of materials against Özdisan: for each line resolves the part, applies MOQ / order multiple, picks the price break for the quantity, checks stock (and lead time when stock is short), flags end-of-life or price-on-request parts and returns line totals plus the BOM total (VAT excluded). Up to 60 lines per call (about 1 s per line); split larger BOMs into several calls.

search_categoriesA

Find Özdisan product categories by name or by what they contain. Matches Turkish and English category names (e.g. 'mosfet', 'lineer regülatör', 'linear voltage regulator', 'MLCC', 'mikrodenetleyici'), and also lists the categories whose products match the text. Use the returned 'category' slug with get_category_filters and filter_products. Prefer the most specific (deepest) category for parametric filtering.

browse_categoriesA

Browse the Özdisan category tree (5 main groups → thousands of sub-categories, ~1M products). Without 'category' returns the top-level groups; with 'category' returns that category's sub-categories. Every node includes its product count and a 'category' slug usable in other tools.

get_category_filtersA

List the parametric filters of a category: every technical property (e.g. package, voltage, current, capacitance, tolerance), its type (numeric/text), units and selectable option values, plus manufacturers and stock/RoHS/document flags. Use it before filter_products to pick exact option values. Pass 'property' to see all options of one property, 'value_query' to search inside options, and optionally the current filters to see only the options still available.

download_datasheetA

Download a product's datasheet PDF to the local disk and return the file path. Default folder: ~/Downloads/ozdisan-datasheets (configurable with OZDISAN_DOWNLOAD_DIR or the 'directory' argument). Already downloaded files are reused unless overwrite=true. To read the content use read_datasheet.

read_datasheetA

Extract text from a product's datasheet PDF so you can read pinouts, absolute maximum ratings, electrical characteristics, typical application circuits, package dimensions, etc. Use 'search' to find the relevant pages first (e.g. 'pin configuration', 'absolute maximum', 'typical application', 'thermal'), then 'pages' to read them. Tables are returned as plain text; figures/diagrams are not included.

Prompts

Interactive templates invoked by user choice

NameDescription
komponent_secBir devre ihtiyacına uygun, Özdisan'da stokta olan komponentleri adım adım seçtirir.
bom_kontrolBir malzeme listesini (parça numarası + adet) Özdisan stok ve fiyatlarına göre kontrol ettirir.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 11 tools

Disambiguation4/5

Each tool has a clearly stated role, and the descriptions explicitly sequence them (search_categories → get_category_filters → filter_products) so an agent knows which to pick. The only soft overlaps are search_products vs filter_products (both return product lists) and get_alternatives' 'parametric' mode vs filter_products, but the descriptive guidance resolves these in practice.

Naming Consistency5/5

All eleven tools use snake_case with a leading verb and a clear noun object (get_, search_, filter_, browse_, compare_, check_, download_, read_). The pattern is fully predictable across the set.

Tool Count5/5

Eleven tools is well within the sweet spot and each one covers a distinct step in the part-selection workflow (discovery, filtering, detail, comparison, alternatives, BOM, datasheets). No tool looks like padding or a duplicate of another.

Completeness4/5

The surface covers the full research workflow from category browsing through parametric filtering, product detail, alternatives, comparison, BOM pricing and datasheet reading, with no dead ends for read-only sourcing. Minor gaps exist around commercial actions (cart/quote/order submission) and manufacturer-centric listing, which agents would have to work around.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues