h2ejctu avatar

audioknihy.cz Catalog

h2ejctu/audioknihy-cz

Connects Claude, ChatGPT, Cursor, and other MCP clients to a live catalog of 12,000+ Czech audiobooks with real-time price comparison across five retail partners. Exposes nine read-only tools including full-text search, genre browsing, narrator lookups, and multi-facet filtering by price, year, and category. The compare_all_offers and find_cheapest_offer tools let agents build price tables and recommend the lowest-cost retailer without scraping HTML. Rate-limited to 60 requests per minute on the anonymous tier. Useful if you're building Czech-language AI assistants that need to recommend or compare audiobook purchases with current affiliate data instead of stale training corpus results.

tools
13
transport
HTTP
last updated
Jul 2, 2026

Install

From registry metadata
$ npx add-mcp https://audioknihy.cz/api/mcp --name catalog

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http catalog https://audioknihy.cz/api/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 13 tools

Verified live against the running server on Nov 6, 2026.

search_audiobooksFull-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.2 params

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* required
limitinteger
Maximum number of results to return. 1–50, default 10.default: 10
query*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.
get_audiobookFull audiobook detail by author + work slug — title, description, cover, runtime, ISBN, genres, narrator, publisher, and the full table of active offers across retail partners.2 params

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* required
author_slug*string
Author slug (lowercase, hyphenated). Example: "stephen-king". Discoverable via search_audiobooks results.
work_slug*string
Work slug (lowercase, hyphenated). Example: "to". Combined with author_slug forms the canonical work URL.
find_cheapest_offerLowest-price active offer for an audiobook across all affiliate partners. USP — only Czech site that compares audiobook prices across all major retail partners.2 params

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* required
author_slug*string
Author slug (lowercase, hyphenated). Example: "stephen-king".
work_slug*string
Work slug (lowercase, hyphenated). Example: "to".
compare_all_offersFull price comparison table across every active retail partner for one audiobook. Returns price + format + last-seen timestamp per partner — agents can rank or filter.2 params

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* required
author_slug*string
Author slug (lowercase, hyphenated). Example: "stephen-king".
work_slug*string
Work slug (lowercase, hyphenated). Example: "to".
browse_genresList all 35 Czech audiobook genres with audiobook counts. Discovery entry point — agents enumerate genres before drilling into a specific one.

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

No parameters. Call it with no arguments.

search_by_filtersMulti-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.7 params

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* required
genre_slugstring
Genre slug to anchor the search. Discoverable via browse_genres. Example: "detektivky".
limitinteger
Maximum number of results to return. 1–50, default 20.default: 20
narrator_slugvalue
Narrator slug to anchor the search. Example: "lukas-hlavica".
partner_slugvalue
Reserved for V2 — partner-side filtering is not yet implemented and will throw if set.
price_max_czknumber
Maximum price in CZK applied as a post-filter on each result row.
year_maxinteger
Latest publication year (inclusive). V1 accepts but skips this filter.
year_mininteger
Earliest publication year (inclusive). V1 accepts but skips this filter.
get_authorAuthor 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.1 params

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* required
slug*string
Author slug (lowercase, hyphenated). Discoverable via search_audiobooks results. Example: "stephen-king".
get_narratorNarrator profile + audiobooks they have read. Czech audiobook listeners often choose by narrator (performance quality often matters more than the underlying text).1 params

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

Parameters* required
slug*string
Narrator slug (lowercase, hyphenated). Example: "lukas-hlavica". Discoverable via search_audiobooks results or work detail offer.narrator references.
list_partnersList 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).

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).

No parameters. Call it with no arguments.

get_audiobook_rankingsCatalog-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.2 params

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* required
limitinteger
Maximum number of ranked audiobooks. 1–50, default 10.default: 10
ranking*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...one of cheapest · best-rated · biggest-drops · price-floor
get_price_trendPrice 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 wi...3 params

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 wi...

Parameters* required
author_slug*string
Author slug (lowercase, hyphenated). Example: "jo-nesbo".
window_daysinteger
Look-back window in days. 1–365, default 90.default: 90
work_slug*string
Work slug (lowercase, hyphenated). Example: "netopyr".
get_publisherPublisher (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.2 params

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* required
limitinteger
Maximum number of works to return. 1–50, default 50.default: 50
slug*string
Publisher slug (lowercase, hyphenated). Example: "tympanum". Discoverable via the /nakladatelstvi index page.
get_price_indexCross-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.

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.

No parameters. Call it with no arguments.

Sponsors

Readme

Details

Repository
github.com/h2ejctu/audioknihy-cz
Website
audioknihy.cz/mcp
Category
Search & Web Crawling
Transport
HTTP
Registry
MCP registry, active
Tools verified
Nov 6, 2026

Related Search & Web Crawling MCP servers

View all
1dalecb avatarObsidian Semantic Searchdalecb/obsidian-semantic-mcpRead-only semantic search MCP server for Obsidian vaults using local Ollama embeddings.0stars
2defibabylon avatardefi-inteldefibabylon/defi-intelOperator-grade DeFi intelligence MCP. - 10 tools vs DefiLlama's basic 4, - adds governance proposals, - RWA attestation scores, - live X/Twitter narrative. - No0stars
3echojobsio avatarJobDataLakeechojobsio/jdl-mcp-serverSearch 1M+ enriched job listings. Filter by skills, salary, location, and more. Free.0stars
4city24 avatarCity24.ee - Real Estate marketplaceee.city24/real-estateLive Estonia real estate listings with search, geo filters, and property metadata.0stars
5formester avatarMcpformester/mcpGive AI agents access to form submissions — read, search, update, and process file attachments.0stars
6francofuji avatarUnCorreoTemporalfrancofuji/uncorreotemporal-mcp-serverTemporary email for AI agents: create inboxes, wait for emails, extract OTPs, verify signups.0stars