Search classified listings on Malinica, a Serbian free serbian classifieds marketplace.
MCP Server: rs.malinica/classifieds
This Model Context Protocol (MCP) server enables search of classified listings on Malinica, a Serbian free classifieds marketplace. It provides tooling for querying listings related to the Malinica platform, based on the server’s catalog entry metadata.
🛠️ Key Features
Searches classified listings on Malinica
Serbian free classifieds marketplace coverage
6 tools exposed by the server
🚀 Use Cases
Find listings on Malinica for specific categories or terms
Retrieve search results for Serbian classifieds content
⚡ Developer Benefits
Standard MCP tool integration for Malinica classifieds search
Clear scope: listing search on the Malinica marketplace
⚠️ Limitations
Limited details provided in the catalog data (no specific tools, parameters, or response schema described)
Captured live from the server via tools/list.
get_categories
List every active listing category as a flat catalog. Each entry has a numeric id, a dot-separated path encoding its place in the hierarchy (for example vozila.automobili is a child of vozila), and a human-readable title in Serbian. Call this first to translate what a user is looking for into a category id, then call get_category to learn which attributes that category supports.
Describe one category and the attributes listings in it can be filtered by. Each attribute has a name (the key to use when filtering), a label, and a type giving the JSON value a filter must supply: string, number, boolean or date (ISO 8601). An attribute may also carry options, which are the only accepted values for it; value_type with min and max, bounding what numbers are accepted; or a picklist_path, whose accepted values are not listed here and must be fetched with get_picklist_values. A picklist_depends_on names another attribute whose value narrows this one.
Parameters1
categoryId
integer
required
Numeric category id, as returned by get_categories
Raw schema
{
"type": "object",
"properties": {
"categoryId": {
"type": "integer",
"format": "int64",
"description": "Numeric category id, as returned by get_categories"
}
},
"required": [
"categoryId"
]
}
get_listing
Fetch one published listing by id, including its full description, price, location, category and stored attribute values. Attribute keys match the names reported by get_category for that listing's category, and attributes holds the raw stored values. Under the same key, attribute_labels gives that attribute's display label, plus a value label where the value comes from a fixed set such as a picklist or enum — use the labels when describing the listing to a user, and the raw values when filtering. Only public listings can be fetched.
Parameters1
listingId
integer
required
Numeric listing id, as returned by search_listings
Raw schema
{
"type": "object",
"properties": {
"listingId": {
"type": "integer",
"format": "int64",
"description": "Numeric listing id, as returned by search_listings"
}
},
"required": [
"listingId"
]
}
search_locations
Find Serbian locations by name and return their numeric ids, which is how listings are filtered by place. Matching is fuzzy and tolerates missing diacritics. Results carry a level (COUNTRY, MUNICIPALITY, CITY, CITY_MUNICIPALITY, SETTLEMENT, NEIGHBOURHOOD) and a path showing where the place sits in the hierarchy; use both to pick between same-named places, and prefer asking the user rather than guessing when several look plausible.
Parameters2
query
string
required
Place name to search for, for example 'Novi Sad'
limit
integer
optional
Maximum results to return (1-25, default 10)
Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Place name to search for, for example 'Novi Sad'"
},
"limit": {
"type": "integer",
"format": "int32",
"description": "Maximum results to return (1-25, default 10)"
}
},
"required": [
"query"
]
}
get_picklist_values
List the accepted values for an attribute whose get_category entry carries a picklist_path. These value sets are hierarchical and too large to inline, so they are fetched one level at a time. A picklist_path may contain a placeholder in braces naming another attribute, as in 'vehicles.car.{make}'; replace the placeholder with that attribute's chosen value before calling, so picking make 'toyota' means requesting 'vehicles.car.toyota' to get the models for it.
Parameters1
path
string
required
Fully resolved dot-separated picklist path, with any placeholder already substituted
Search published listings by free text, category and location. Every argument is optional but at least one must be given; supplying several narrows the result the way a user ticking filters would.
category_id and location_id are hierarchical and match the whole subtree beneath them, so the category 'Mobilni telefoni i oprema' also returns listings filed under its child categories, and Beograd also returns listings in Novi Beograd, Zemun and every other place under it. Filter at the broadest level the user actually meant, and only narrow when they named a specific place or category. Get ids from get_categories and search_locations.
q is an ordinary keyword search, not semantic or vector search: it matches words the listing actually contains, so synonyms and paraphrases will not find anything. It matches broadly across titles, descriptions, attribute values and the listing's category and location names, but ranks titles and descriptions highest. Prefer q for what an item is, and the id filters for where it is and what it is filed under — 'stan Beograd' works, but a location_id for Beograd works better.
Only the first few best matches are returned and there is no way to page past them. If the result looks too broad, narrow the search and call again rather than asking for more.
Parameters4
q
string
optional
Keywords to match, for example 'iphone 15 pro'
categoryId
integer
optional
Numeric category id from get_categories; matches this category and everything under it
locationId
integer
optional
Numeric location id from search_locations; matches this place and everything under it
limit
integer
optional
Maximum results to return (1-10, default 10)
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keywords to match, for example 'iphone 15 pro'"
},
"categoryId": {
"type": "integer",
"format": "int64",
"description": "Numeric category id from get_categories; matches this category and everything under it"
},
"locationId": {
"type": "integer",
"format": "int64",
"description": "Numeric location id from search_locations; matches this place and everything under it"
},
"limit": {
"type": "integer",
"format": "int32",
"description": "Maximum results to return (1-10, default 10)"
}
},
"required": []
}