Copy page

Documentation

MCP Usage Guide

This MCP server exposes the Tungaloy Catalog Search API as tools for AI clients.

Tool Priority

Use the tools in this order:

1. smart_search_catalog
2. search_catalog
3. get_catalog_item
4. get_catalog_metadata

smart_search_catalog

Use this first for normal natural-language catalog questions.

Good use cases:

• Product names
• Family or series names
• Dimensions mixed with product wording
• Insert model prefixes
• Compatibility questions
• Ambiguous catalog wording

Tool arguments:

Code
{
  "body": {
    "query": "Find 1 mm end mills",
    "limit": 10,
    "language": "en"
  }
}

search_catalog

Use this when the search is already structured or when raw search-control fields are needed.

Use this for:

• nextSuggestedFilters
• columnDefinitions
• responseDefinitions
• hasMore
• nextOffset
• controlled retries
• pagination

Tool arguments:

Code
{
  "body": {
    "search_mode": "dimension",
    "main_application": "Milling",
    "filters": [
      {
        "field": "cutter_diameter",
        "op": "eq",
        "value": 1
      }
    ],
    "limit": 10,
    "include_definitions": true
  }
}

get_catalog_item

Use this only when the user gives one exact item number.

Code
{
  "pathParams": {
    "item_number": "6780273"
  }
}

get_catalog_metadata

Use this to discover valid options or field definitions.

Code
{
  "queryParams": {
    "metadata_type": "filterable_columns",
    "main_application": "Milling",
    "sub_application": "Slot Milling"
  }
}

Important Search Rules

• For normal user questions, call smart_search_catalog first.
• Use search_catalog after that only when raw fields, suggested filters, pagination, or a controlled structured retry is needed.
• Product family names usually belong in series.
• Concrete model text usually belongs in description.
• Dimensional conditions belong in filters.
• For insert item searches, use description=<insert model prefix> and ITEMTYPE=I.
• For compatible-tool searches, use compatible_insert=<insert model> and do not add ITEMTYPE=I.
• Tool results are the source of truth. Do not invent item numbers, dimensions, compatibility, URLs, or product descriptions.