Koskamo

Puhy.cz MCP

This MCP server allows AI agents to programmatically search the Puhy.cz electronics and tools catalog, retrieve product details and availability, and obtain shipping information. It enables read-only access to pricing, stock levels, and delivery times, returning a pre-filled cart link for human completion of purchases.

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.

Puhy.cz MCP logo, by puhy.czVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-07Operated by puhy.cz
MCP endpoint (Streamable HTTP)
https://www.puhy.cz/mcp
Vendor documentation

What its tools do

4 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

4 of 4 have a description · 4 of 4 declare behavior hints · 0 of 3 with parameters document them all

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 puhy.cz ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search for electronic components and tools by name or EAN
  • Retrieve detailed product information and packaging rules
  • Check real-time price, stock availability, and delivery deadlines
  • Obtain shipping and payment options for specific items

Source and maintenance

Vendor evidenceRegistry 1.0.0

Protocol and capabilities

Server
puhy-cz-catalog 1.0.2
MCP protocol negotiated in check
2025-11-25
Tools
4 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

puhy.cz is a Czech B2B/B2C distributor of electronic components, tools and measuring equipment. All prices are in CZK; the catalog is in Czech. Typical flow: search_products → get_product (optional) → check_availability with the chosen items and quantities → give the user the cart_url to finish the order on puhy.cz. Quantities may be rounded up to package size; always show the user orderable_quantity and delivery time. For a BOM / parts list: search each line by part number, value + package or EAN (multiply quantities by the number of sets), list lines you could not match separately and mark any suggested substitute as such for the user to verify, then check_availability for all matched lines (50 per call) and give the cart_url(s). This server cannot place orders or take payments.

Tools

4 advertised

search_products — Search products
Advertised by the server during the last successful anonymous check.
Advertised read-only

Full-text search in the puhy.cz catalog (Czech distributor of electronic components, tools, measuring instruments, cables and accessories for professionals; items from our own stock and partner warehouses). Product names are in Czech; matching works best with Czech terms, part numbers or EAN. Returns price in CZK incl. and excl. VAT, availability, delivery time and product URL.

search_products input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search phrase, part number or EAN (Czech preferred, e.g. \"rezistor 10k 0207\", \"pájka 0,5 mm\")"
    },
    "in_stock_only": {
      "type": "boolean",
      "default": false,
      "description": "Only items physically in our warehouse (ships today)"
    },
    "max_price_czk": {
      "type": "number",
      "description": "Max unit price in CZK incl. VAT"
    },
    "min_price_czk": {
      "type": "number",
      "description": "Min unit price in CZK incl. VAT"
    }
  }
}
search_products annotations
{
  "title": "Search products",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_product — Product detail
Advertised by the server during the last successful anonymous check.
Advertised read-only

Product detail by product_id or EAN: description, price, stock, delivery time, minimum order / package rules. With quantity it returns the orderable quantity (rounded to package size) and line total.

get_product input schema
{
  "type": "object",
  "properties": {
    "ean": {
      "type": "string"
    },
    "quantity": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "product_id": {
      "type": "integer"
    }
  }
}
get_product annotations
{
  "title": "Product detail",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
check_availability — Check availability & prepare cart
Advertised by the server during the last successful anonymous check.
Advertised read-only

Check a list of items with quantities: orderable quantity per item, price, stock, delivery time, goods total, shipping options for that total, and a cart_url. The cart_url opens the puhy.cz cart with these items pre-filled in the user's browser, where the user completes checkout and payment. Suited to BOMs / parts lists: up to 50 lines per call; each cart_url adds its items to the same cart.

check_availability input schema
{
  "type": "object",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "product_id",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "minimum": 1
          },
          "product_id": {
            "type": "integer"
          }
        }
      },
      "maxItems": 50
    }
  }
}
check_availability annotations
{
  "title": "Check availability & prepare cart",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_shipping_and_payment — Shipping & payment
Advertised by the server during the last successful anonymous check.
Advertised read-only

Shipping carriers and prices (CZ, SK), free-shipping threshold, payment methods, cash-on-delivery fee, B2B invoicing (EU reverse charge), links to terms and contact.

get_shipping_and_payment input schema
{
  "type": "object",
  "properties": {}
}
get_shipping_and_payment annotations
{
  "title": "Shipping & payment",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

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.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 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
1501 ms
95th percentile latency
1501 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1501 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http puhy-cz-mcp https://www.puhy.cz/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add puhy-cz-mcp --url https://www.puhy.cz/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable puhy-cz-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "puhy-cz-mcp": {
      "url": "https://www.puhy.cz/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "puhy-cz-mcp": {
      "type": "streamableHttp",
      "url": "https://www.puhy.cz/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start puhy-cz-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "puhy-cz-mcp": {
      "type": "http",
      "url": "https://www.puhy.cz/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http puhy-cz-mcp https://www.puhy.cz/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://www.puhy.cz/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "puhy-cz-mcp": {
      "serverUrl": "https://www.puhy.cz/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Puhy.cz MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run Puhy.cz 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.

Claim this listing