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., "@blocket-mcp Find used Volvo V70 under 150000 SEK"
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.
MCP server wrapping BlocketAPI — search Sweden's Blocket marketplace from Cursor (or any MCP client).
No API key required. Rate limit: 5 requests/second.
Tool | Description |
| General keyword search ( |
| Used cars with vehicle filters |
| Used boats |
| Used motorcycles |
| Full listing details by id + type |
| Static enum lists (locations, categories, models, …) |
Related MCP server: Airbnb MCP Server
npm install
npm run buildAdd to your MCP settings (e.g. ~/.cursor/mcp.json):
{
"mcpServers": {
"blocket": {
"command": "node",
"args": ["/absolute/path/to/blocket-mcp/build/index.js"]
}
}
}For local development without building:
{
"mcpServers": {
"blocket": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/blocket-mcp/src/index.ts"]
}
}
}Runs against the live API (needs network):
npm run smoke-testAsk the agent:
“Search Blocket for iPhone 15 in Stockholm under 5000 SEK”
“Find Volvo cars from 2018+ under 200000 SEK”
“Get details for ad id 12345678 (recommerce)”
Not affiliated with Blocket AB.
Get full details for a specific Blocket listing by ID and ad type. Use an id from search results. Match type to the search that found it (recommerce for general search, car/boat/mc for vehicle searches).
Inputs: id (required), type (required).
Return static enum lists for BlocketAPI filters (locations, categories, car models, boat types, etc.). Use this when you need valid enum values without guessing.
Inputs: group.
Search Blocket for general listings (electronics, furniture, clothing, etc.). Returns JSON with a docs array of matching ads. locations filters by Swedish län (county), not city.
Inputs: query (required), page, category, locations, +2 more.
Search used boats on Blocket with boat-specific filters (type, length, price).
Inputs: page, query, types, org_id, +6 more.
Search used cars on Blocket with vehicle-specific filters (make, year, mileage, transmission, color, horsepower). Note: mileage params are spelled milage_from / milage_to to match the API.
Inputs: page, query, colors, models, +13 more.
Search used motorcycles on Blocket with MC-specific filters (make, type, engine volume, price).
Inputs: page, query, types, models, +7 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool has a clearly distinct purpose: general search, car search, boat search, motorcycle search, ad details, and filter options. Even the three vehicle searches are distinguishable by vehicle type and specialized filters.
All tool names follow a consistent lowercase underscore pattern with verbs like list, search, and get. The specialized searches (search_cars, search_boats, search_motorcycles) fit the same pattern as the base search.
Six tools is well-scoped for a marketplace search server. It covers general listings, vehicle-specific filters, ad details, and filter enums without unnecessary bloat.
The surface covers the core read-only workflow: discover filter options, search across categories, and fetch full ad details. No obvious gaps for the stated domain.
Search and browse global classifieds across 80 markets. No auth required for read-only access.
Search Facebook Marketplace, inspect listings and analyze deals. Paid Spottable Pro/Max required.
Google, Bing, DuckDuckGo and Google Maps search results, free without an API key.
Jobs, ads, SEO, keywords, YouTube and AliExpress data for AI agents. Runs on Apify.
