Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@aukro-mcp find active Aukro auctions for a used iPhone 13 under 8000 CZK"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
aukro-mcp)
An unofficial Model Context Protocol (MCP) server for Aukro.cz — the largest Czech online auction and marketplace platform.
aukro-mcp works out-of-the-box without credentials for marketplace discovery, historical sold-price research, category exploration, offer inspection, bidding history analysis, and seller due diligence—while seamlessly upgrading to full buyer & seller account automation when authenticated via browser session cookies, OAuth2 Bearer/refresh tokens, or interactive browser login.
Non-Commercial License & Disclaimer: This project is released under the CC BY-NC 4.0 license for personal, educational, and non-commercial research use only. It is an independent community project and is not affiliated with or endorsed by Aukro s.r.o.
Zero-Config Anonymous Mode — Search active and completed/archived (finished: true) auctions, inspect category trees and filter attributes, batch-fetch up to 20 full offer details concurrently, poll up to 50 live auction prices in a single request, view complete bid histories, and audit seller profiles (including IČO/DIČ company registration and negative feedback breakdowns) without logging in.
Full Buyer & Seller Account Capabilities — Manage watchlists (Sledované nabídky), favorite sellers, saved searches, Buy Now shopping carts (Košík), proxy auction bids (příhoz with dryRun pre-checks), price proposals (Nabídnout cenu), seller inventory (offers-v2), listing templates, and buyer/seller messaging (Moje zprávy).
Cloudflare Turnstile–Friendly Authentication — Supports runtime credential switching (aukro_set_credentials), automatic OAuth2 token refresh, and a native interactive browser login (aukro_login_interactive) that launches your local Chrome/Brave/Edge/Chromium without DOM automation hooks so Cloudflare Turnstile passes cleanly.
Token-Efficient Responses — Strips HATEOAS noise, normalizes HTML descriptions into clean text, computes domestic shipping summaries (totalPriceWithCheapestShipping), and supports multi-query parallel deduplication (queries) in a single tool call.
Dual Transport Support — Runs over stdio (for Cursor, Claude Desktop, Windsurf, VS Code, etc.) or Streamable HTTP (--http --port 3000).
Related MCP server: Bazos-MCP
Node.js 20+ (node --version)
npm (included with Node.js)
git clone https://github.com/mich41v4294/aukro-mcp.git
cd aukro-mcp
npm install
npm run build~/.cursor/mcp.json) / Claude Desktop (claude_desktop_config.json)Add the following entry to your MCP client configuration file (replace /absolute/path/to/aukro-mcp with your local checkout path):
{
"mcpServers": {
"aukro": {
"command": "node",
"args": ["/absolute/path/to/aukro-mcp/dist/index.js"],
"env": {
"AUKRO_CURRENCY": "CZK",
"AUKRO_LANGUAGE": "cs-CZ"
}
}
}
}To run aukro-mcp as a standalone HTTP server instead of stdio:
node dist/index.js --http --port 3000MCP Endpoint: http://127.0.0.1:3000/mcp
Health Check: http://127.0.0.1:3000/health
All 10 public discovery, search, offer, category, and seller inspection tools work anonymously with zero configuration.
To unlock buyer and seller account tools (watchlist, bidding, cart, messages, selling), you can authenticate in any of three ways:
aukro_login_interactive)Ask your AI assistant to run aukro_login_interactive. The server will:
Launch a local Chrome, Brave, Edge, or Chromium window at https://aukro.cz/prihlaseni using an isolated profile directory (~/.config/aukro-mcp/chrome-login-profile) without Playwright/webdriver instrumentation so Cloudflare Turnstile passes without error 600010.
Poll browser cookies once you log in, verify the session against /users/actualStatistics, and automatically save your session to ~/.config/aukro-mcp/credentials.json (permissions 0600).
aukro_set_credentials)Copy your SESSION cookie (or full Cookie request header) from browser DevTools on https://aukro.cz and pass it to aukro_set_credentials:
{
"sessionCookie": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"persist": true
}Or pass an OAuth2 accessToken and refreshToken (automatically refreshed before expiration).
Pass credentials via the env block in your MCP config or a local environment setup (see .env.example):
Variable | Default | Description |
| — | Full |
| — | Value of the |
| — | Optional |
| (auto UUID) | Optional |
| — | OAuth2 Bearer JWT |
| — | OAuth2 |
|
| Marketplace currency ( |
|
| Marketplace locale header ( |
|
| Subbrand scope ( |
|
| Path where runtime credentials are persisted ( |
| (auto-detected) | Optional custom path to Chrome/Brave/Edge/Chromium binary for |
Tool | Description |
| Search active or completed/archived ( |
| Instant search suggestions for items, categories, and landing pages ( |
| Browse all 22 root categories with live active item counts, inspect a specific |
| Retrieve filterable/exposable parameters and allowed option keys for a |
| Fetch complete details for a single offer ( |
| Lightweight batch poll for up to 50 offer IDs ( |
| Complete public bidding history (active + canceled bids, timestamps, amounts, anonymized bidder ratings) plus optional similar offers ( |
| Resolve any seller/user by |
| Paginated feedback comments filtered by direction ( |
| Top sellers rankings ( |
Tool | Description |
| Check current auth mode ( |
| Supply or update |
| Launch a local browser window to log in on |
| Clear stored credentials from memory and disk, returning the server to anonymous mode. |
Tool | Description |
| Fetch the authenticated user's profile statistics, personal/company settings, addresses, 2FA status, and billing account balance. |
| List ( |
| List, add, or remove favorite sellers ( |
| Inspect active auctions you are bidding on ( |
| Place a maximum proxy bid ( |
| Check bargaining eligibility/constraints ( |
| View Buy Now shopping cart ( |
Tool | Description |
| List your seller listings ( |
| Manage listings via the v2 Offers API: prepare edit payload ( |
| List ( |
| Manage |
aukro://categories/root — Top-level Aukro.cz marketplace categories with IDs, SEO slugs, and active item counts.
aukro://registry/shipping — Dictionary of Aukro.cz prepaid and cash-on-delivery shipping methods, carrier services, and item quantity units.
aukro://registry/conditions — Mapping of item condition codes (NEW, UNPACKED, LIKE_NEW, USED, REPAIRED, REFURBISHED, DAMAGED, FOR_PARTS) to Attribute ID 48 (Stav zboží).
aukro_estimate_market_price (itemQuery, optional condition) — Guides the assistant through comparing recently completed/archived auctions (finished: true) against current active listings to determine fair market value.
aukro_seller_due_diligence (username) — Audits a seller's registration age, positive feedback percentage, 4-criteria star ratings, negative feedback comments and seller replies, IČO/DIČ company identifiers, and return/warranty policies.
aukro-mcp/
├── src/
│ ├── index.ts # CLI entrypoint (stdio & Streamable HTTP transports)
│ ├── server.ts # McpServer factory & capability registration
│ ├── config.ts # Environment & runtime configuration loader
│ ├── client/
│ │ ├── auth.ts # Cookie, OAuth2 PKCE refresh & interactive browser login manager
│ │ ├── cache.ts # Bounded in-memory TTL cache
│ │ └── http.ts # Aukro API HTTP client with retry & anonymous token init
│ ├── resources/
│ │ └── index.ts # MCP resources & guided workflow prompts
│ ├── tools/
│ │ ├── search.ts # Offer search (active/archived) & autocomplete
│ │ ├── categories.ts # Category hierarchy, search & filterable attributes
│ │ ├── offers.ts # Single/batch offer detail, live status poll & bid history
│ │ ├── users.ts # Seller profile, ratings, feedback & leaderboard
│ │ ├── auth.ts # Auth status, runtime credentials, interactive login & logout
│ │ ├── buyer.ts # Account info, watchlist, favourites & bids/purchases
│ │ ├── bidding-cart.ts # Auction bidding (with dryRun), bargaining & Buy Now cart
│ │ └── seller.ts # Seller inventory, offers-v2 management, templates & messages
│ └── utils/
│ └── formatters.ts # Token-compact response formatters & HTML stripping
├── tests/
│ └── aukro.test.ts # Unit & live public API integration test suite
├── .env.example # Example environment configuration
├── LICENSE # CC BY-NC 4.0 Non-Commercial License
├── package.json
└── tsconfig.json# Run in development mode (via tsx)
npm run dev
# Type-check without emitting files
npm run typecheck
# Compile TypeScript to dist/
npm run build
# Run unit and integration tests (Vitest)
npm testCopyright © 2026 mich41v4294.
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0).
Permitted: Personal use, educational use, academic/price research, and non-commercial open-source contributions (with attribution).
Prohibited without prior written permission: Commercial use, paid/monetized hosting (SaaS/API), or commercial arbitrage/scraping operations.
See the LICENSE file for the full license text and terms.
Check whether the MCP server is currently running in anonymous mode, cookie session mode, or OAuth2 Bearer token mode, and verify against Aukro.cz's /users/actualStatistics endpoint whether the session is actively logged in.
Inputs: no named parameters.
Get instant search suggestions on Aukro.cz for items, categories, and landing pages (mode: 'ALL'), autocomplete seller usernames (mode: 'USERS'), or list trending popular searches (mode: 'POPULAR'). Works anonymously.
Inputs: mode, text, subbrand, categoryId.
Check constraints for making a price offer on a listing with 'Nabídnout cenu' enabled (action: 'CHECK'), or submit a price proposal to the seller (action: 'PROPOSE'). Requires authentication.
Inputs: offerId (required), action, currency, quantity, +1 more.
View your Aukro Buy Now shopping cart (action: 'VIEW'), add an item to the cart (action: 'ADD'), update item quantity (action: 'UPDATE_QUANTITY'), remove a cart item (action: 'REMOVE'), or preview available checkout shipping and payment options (action: 'CHECKOUT_OPTIONS'). Requires authentication.
Inputs: action, offerId, quantity, cartItemId, +1 more.
List, add, or remove favorite sellers (LIST_SELLERS, ADD_SELLER, REMOVE_SELLERS) and saved searches (LIST_SEARCHES, REMOVE_SEARCHES). Requires authentication.
Inputs: page, action, pageSize, sellerId, +2 more.
Browse Aukro.cz marketplace categories. If categoryId is omitted, returns all 22 root categories with live active item counts. If categoryId is provided, returns category details, ancestor breadcrumbs, and direct subcategories with live item counts. Can also search category names across the entire recursive category tree using searchQuery.
Inputs: categoryId, maxResults, searchQuery, fullTreeScan.
Retrieve all filterable/exposable attributes (e.g. Condition / Stav zboží, Brand, Storage, Material) and their allowed option keys for a given categoryId. Use the returned attributeId and allowedValues[].key values in aukro_search_offers's attributeFilters parameter.
Inputs: categoryId (required), searchQuery, onlyImportant.
Fetch the complete public bidding history (both active and canceled bids, timestamps, amounts, and anonymized bidder ratings) for an auction offer, and optionally fetch similar active offers or other offers from the same seller.
Inputs: offerId (required), includeSimilarOffers, includeSellerCategoryOffers.
Fetch complete details for one (offerId) or multiple (offerIds, up to 20 fetched concurrently) Aukro.cz offers (works for both active and ended/archived offers). Returns unified price, next minimum bid, Buy Now price, shippingSummary (canShipToCz, cheapestShipping, totalPriceWithCheapestShipping, personalPickupAvailable), plain-text description, attributes, image URLs, shipping options, payment methods, buyer protection fees, and seller profile summary.
Inputs: offerId, currency, offerIds, maxDescriptionLength, +2 more.
Quickly poll live status (state, price, nextBidMinAmount, biddersCount, highestBidderAnonymizedLogin, endingTime) for up to 50 offer IDs in a single lightweight request.
Inputs: offerIds (required), currency.
Fetch Aukro.cz seller rankings (https://aukro.cz/zebricky), sorted either by all-time favorite count (favourite_count:DESC) or monthly popularity growth (popularity_growth:DESC), optionally scoped to a root categoryId or subbrand.
Inputs: page, sortBy, pageSize, subbrand, +1 more.
Retrieve paginated feedback comments and ratings for an Aukro user (by userId or username). Supports filtering by feedback direction (ALL_RECEIVED, FROM_BUYERS, FROM_SELLERS, SENT) and sentiment (ALL, POS, NEU, NEG).
Inputs: tab, page, userId, pageSize, +2 more.
Inspect an Aukro.cz seller or user by username or numeric userId. Returns registration date, last login, rating score, positive feedback percentage, 4-criteria star averages, detailed negative feedback reason counts, vacation/absence status, free shipping threshold, and (for sellers) company registration details (IČO, DIČ, contact info, warranty/complaint rules, and return policy).
Inputs: userId, username, includeSellerTerms, includeFullLegalText, +1 more.
Launch a visible browser window to Aukro.cz's login page so you can pass Cloudflare Turnstile (or 2FA / social login), optionally pre-filling username and password. Automatically captures and saves the authenticated SESSION cookie once login succeeds.
Inputs: password, username, timeoutSeconds.
Clear all stored Aukro session cookies and OAuth2 tokens from memory and disk, returning the MCP server to anonymous mode.
Inputs: removeDiskFile.
Manage your seller listings on Aukro.cz using the v2 Offers API: prepare edit payload from an existing offer (PREPARE_EDIT), validate an offer form (VALIDATE), calculate listing fees (FEE_PREVIEW), create a new offer (CREATE), modify an active offer (MODIFY), terminate an offer early (TERMINATE), or re-expose ended offers (REEXPOSE). Requires authentication.
Inputs: action (required), offerId, offerIds, offerPayload, +1 more.
Manage buyer/seller conversations on Aukro.cz: list message threads and unread count (LIST), search conversations (SEARCH), read message history in a thread (READ_THREAD), reply to a thread (REPLY), or ask a seller a question about an offer (ASK_ITEM_QUESTION). Requires authentication.
Inputs: page, extId, action, offerId, +3 more.
Retrieve the currently authenticated user's profile statistics, personal/company settings, addresses, and billing account balance. Requires authentication.
Inputs: includeBilling, includePersonalData.
Inspect your buyer activity on Aukro.cz: active auctions you are bidding on with WINNING/LOOSING status (view: 'ACTIVE_BIDS'), lost auctions (view: 'LOST_AUCTIONS'), won auctions & Buy Now purchases (view: 'PURCHASED'), or purchase transactions/orders with payment and shipment tracking (view: 'TRANSACTIONS'). Requires authentication.
Inputs: page, view, itemName, pageSize, +2 more.
Inspect your seller inventory and orders on Aukro.cz: active listings (view: 'ACTIVE'), sold offers (view: 'SOLD'), ended unsold offers (view: 'NOT_SOLD'), scheduled offers (view: 'SCHEDULED'), or active sale transactions/orders (view: 'TRANSACTIONS'). Requires authentication.
Inputs: page, sort, view, query, +2 more.
List your saved seller offer templates (action: 'LIST') or inspect a specific template by templateId (action: 'GET'). Requires authentication.
Inputs: page, action, pageSize, templateId.
Place a maximum proxy bid (příhoz) on an Aukro.cz auction (POST /offers/{offerId}/bid?fastBid=false), or run a safe pre-check (dryRun: true) to verify current price, minimum next bid, and whether your account has any bidder restrictions on the item. Requires authentication.
Inputs: amount (required), offerId (required), dryRun, tfvCode, +1 more.
Search active or completed/archived (finished: true) marketplace offers on Aukro.cz. Supports keyword search, category ID/SEO URL, price bounds, offer format (auction vs buy-now vs hot auction), item condition (NEW, USED, etc.), seller username/ID, shipping/payment filters, geolocation (postCode + distanceKm), dynamic category attribute filters, and curated feeds (ENDING_SOON, FROM_1_CZK, UP_TO_300_CZK, NEW_OFFERS, POPULAR, PRICE_HITS, CHARITY, OUTLET). Works anonymously without login.
Inputs: page, sort, query, queries, +28 more.
Supply or update Aukro.cz authentication credentials at runtime without restarting the MCP server. Supports: (1) full cookieHeader copied from browser DevTools, (2) individual sessionCookie (SESSION cookie value from aukro.cz), (3) OAuth2 accessToken and/or refreshToken, and (4) optional username/password for interactive login pre-filling. Immediately verifies the credentials against Aukro.cz.
Inputs: persist, password, username, xsrfToken, +5 more.
List watched offers (action: 'LIST'), add an offer to your watchlist (action: 'ADD'), or remove one or more offers from your watchlist (action: 'REMOVE'). Requires authentication.
Inputs: page, action, offerId, offerIds, +4 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 25 tools
Most tools have clearly distinct purposes (search vs autocomplete, offer detail vs status batch vs bids, watchlist vs favourites, buyer vs seller views). A few pairs like get_offer_detail/get_offers_status_batch and my_bids_and_purchases/my_sales could be momentarily confused, but descriptions clarify the boundaries.
All tools use the aukro_ prefix and snake_case, with mostly verb_noun patterns (search_offers, get_categories, place_bid, manage_offer). A handful of noun-only multi-action tools (watchlist, cart, messages, my_account, offer_templates) deviate slightly but follow a coherent convention.
25 tools is heavy and sits at the upper boundary of the rubric's 'borderline' range. While each tool covers a distinct function across a full marketplace domain, the surface feels large and could likely be consolidated.
The set covers a broad marketplace lifecycle: browsing/search, offer detail, bidding, cart, seller offer management, messaging, and user info. Notable gaps remain (no checkout/order finalization, no feedback submission, no way to save a new search despite listing/removing saved searches), but core workflows are usable.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
An MCP server that provides tools to discover and retrieve podcast episodes transcripts.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
