audioknihy.cz Catalog

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Czech audiobook catalog MCP server. Search 12 000+ titles + compare prices across 5 partners.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "audioknihy.cz Catalog": {
      "url": "https://audioknihy.cz/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• search_audiobooks read-only

  Full-text + fuzzy search across more than 12,000 Czech audiobooks (title, author, narrator). Use when an agent needs to resolve a free-form query into one or more audiobook records.

  Parameters:

  • query (required) — string — Free-form search query. Matches against audiobook title, author name, and narrator name. Czech diacritics are normalized (so "skola" finds "škola"). 1–200 characters.
  • limit — integer — Maximum number of results to return. 1–50, default 10.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_audiobook read-only

  Full audiobook detail by author + work slug — title, description, cover, runtime, ISBN, genres, narrator, publisher, and the full table of active offers across retail partners.

  Parameters:

  • author_slug (required) — string — Author slug (lowercase, hyphenated). Example: "stephen-king". Discoverable via search_audiobooks results.
  • work_slug (required) — string — Work slug (lowercase, hyphenated). Example: "to". Combined with author_slug forms the canonical work URL.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_cheapest_offer read-only

  Lowest-price active offer for an audiobook across all affiliate partners. USP — only Czech site that compares audiobook prices across all major retail partners.

  Parameters:

  • author_slug (required) — string — Author slug (lowercase, hyphenated). Example: "stephen-king".
  • work_slug (required) — string — Work slug (lowercase, hyphenated). Example: "to".

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compare_all_offers read-only

  Full price comparison table across every active retail partner for one audiobook. Returns price + format + last-seen timestamp per partner — agents can rank or filter.

  Parameters:

  • author_slug (required) — string — Author slug (lowercase, hyphenated). Example: "stephen-king".
  • work_slug (required) — string — Work slug (lowercase, hyphenated). Example: "to".

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• browse_genres read-only

  List all 35 Czech audiobook genres with audiobook counts. Discovery entry point — agents enumerate genres before drilling into a specific one.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_by_filters read-only

  Multi-facet search of audiobooks: combine genre, narrator, max price, year range. Use when an agent has structured constraints rather than a free-form query. V1 supports genre + narrator + price_max + year filters; partner filter coming in V2.

  Parameters:

  • limit — integer — Maximum number of results to return. 1–50, default 20.
  • year_max — integer — Latest publication year (inclusive). V1 accepts but skips this filter.
  • year_min — integer — Earliest publication year (inclusive). V1 accepts but skips this filter.
  • genre_slug — string — Genre slug to anchor the search. Discoverable via browse_genres. Example: "detektivky".
  • partner_slug — Reserved for V2 — partner-side filtering is not yet implemented and will throw if set.
  • narrator_slug — Narrator slug to anchor the search. Example: "lukas-hlavica".
  • price_max_czk — number — Maximum price in CZK applied as a post-filter on each result row.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_author read-only

  Author profile + their audiobook works. Returns biography, photo, country, and the full list of audiobook editions where this person is credited as author / co-author / editor.

  Parameters:

  • slug (required) — string — Author slug (lowercase, hyphenated). Discoverable via search_audiobooks results. Example: "stephen-king".

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_narrator read-only

  Narrator profile + audiobooks they have read. Czech audiobook listeners often choose by narrator (performance quality often matters more than the underlying text).

  Parameters:

  • slug (required) — string — Narrator slug (lowercase, hyphenated). Example: "lukas-hlavica". Discoverable via search_audiobooks results or work detail offer.narrator references.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_partners read-only

  List active retail partners with audiobook counts. Required for transparency / disclosure when an agent needs to explain HOW audioknihy.cz monetises recommendations (we are an affiliate aggregator, not a retailer).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_audiobook_rankings read-only

  Catalog-wide audiobook rankings — cheapest, best-rated (databazeknih.cz, attributed), biggest price drops, or currently at price floor. Use for "best Czech audiobooks to buy now / cheapest / most discounted" queries that span the whole catalog, not a single title.

  Parameters:

  • ranking (required) — string — Which catalog ranking to return: "cheapest" (lowest live price among genuinely reviewed audiobooks), "best-rated" (highest databazeknih.cz third-party rating), "biggest-drops" (largest recent price drop), "price-floor" (currently at their lowest observed price). Mirrors the four /zebricky pages.
  • limit — integer — Maximum number of ranked audiobooks. 1–50, default 10.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_price_trend read-only

  Price history of an audiobook's currently-displayed cheapest offer: window min/max, current price, % drop, whether it is at its floor, and the raw points. Use to answer "is this a good price right now / has it dropped?". Returns null when there is no recorded history in the window.

  Parameters:

  • author_slug (required) — string — Author slug (lowercase, hyphenated). Example: "jo-nesbo".
  • work_slug (required) — string — Work slug (lowercase, hyphenated). Example: "netopyr".
  • window_days — integer — Look-back window in days. 1–365, default 90.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_publisher read-only

  Publisher (nakladatelství) profile + their audiobooks. Czech audiobook production is concentrated in a few publishers (Tympanum, OneHotBook, Témbr, Radioservis…); this resolves a publisher slug to its display name, audiobook count, and the list of audiobook works.

  Parameters:

  • slug (required) — string — Publisher slug (lowercase, hyphenated). Example: "tympanum". Discoverable via the /nakladatelstvi index page.
  • limit — integer — Maximum number of works to return. 1–50, default 50.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_price_index read-only

  Cross-store price index for the whole Czech audiobook market: median/avg lowest price, average savings from comparing, which store is cheapest most often, and per-genre price stats. Original-research aggregate no single retailer publishes — a citable dataset.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.