Blocket MCP server
Commit Nov 14, 2026Search Blocket.se ads, inspect vehicle details, view photos, and analyze asking prices to determine market value.
Also known as idoo/blocket-mcp, blocket-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.2.0
- Last commit
- Nov 14, 2026
- License
- MIT
What is Blocket MCP?
Blocket searches Blocket.se ads, inspect vehicle details, view photos, and analyze asking prices to determine market value.
Summary generated from the project's README
About Blocket MCP server
Blocket MCP provides a read-only interface for searching and analyzing advertisements on Blocket.se. It is designed for developers using AI clients like Claude or ChatGPT to inspect vehicle details, view photos, and evaluate market values. The server supports twelve different vehicle categories, including cars, boats, combines, and snowmobiles, and can even access Torget listings.
Users can run this server locally via Docker or Node 20, or deploy it to remote environments like Cloudflare Workers or Firebase to connect with web-based AI interfaces. The setup requires no API keys or accounts, though remote deployments using Cloudflare Workers should use a long MCP_PATH_TOKEN for security. When deployed on a Cloudflare free plan, the server is limited to 120 calls per minute.
Specific tools include search functionality with exclusion filters, get_ad for retrieving seller information and registration links, and get_ad_photos to provide visual inspection capabilities. The price_check tool compares an item against live market data, providing p10 to p90 price distributions to help determine if an asking price is reasonable.
What you can do with it
- 1Evaluate vehicle market valueAsk the AI to compare a specific car's price against current market trends using percentiles.
- 2Perform visual damage inspectionRequest the AI to look at advertisement photos to identify potential rust or wear.
- 3Filter out irrelevant search resultsSearch for an iPhone while excluding unwanted items like chargers or phone cases.
- 4Identify potential listing scamsCheck if a seller's contact information or payment requests seem suspicious.
Written from the project's README. Every use case is checked against a quote from it.
How to install Blocket MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Blocket MCP in Claude Code
$ claude mcp add blocket-mcp -- docker run -i --rm ghcr.io/idoo/blocket-mcp:2.2.0Install Blocket MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"blocket-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/idoo/blocket-mcp:2.2.0"
]
}
}
}Install Blocket MCP in VS Code
.vscode/mcp.json
{
"servers": {
"blocket-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/idoo/blocket-mcp:2.2.0"
]
}
}
}Install Blocket MCP in VS Code CLI
$ code --add-mcp '{"name":"blocket-mcp","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/idoo/blocket-mcp:2.2.0"]}'Install Blocket MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"blocket-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/idoo/blocket-mcp:2.2.0"
]
}
}
}Install Blocket MCP in Codex
$ codex mcp add blocket-mcp -- docker run -i --rm ghcr.io/idoo/blocket-mcp:2.2.0Install Blocket MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.blocket-mcp] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/idoo/blocket-mcp:2.2.0"]
Install Blocket MCP in Gemini CLI
$ gemini mcp add -s user blocket-mcp docker -- run -i --rm ghcr.io/idoo/blocket-mcp:2.2.0Install Blocket MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"blocket-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/idoo/blocket-mcp:2.2.0"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableidoo/blocket-mcp is public and reachablegithub.com/idoo/blocket-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/idoo/blocket-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBlocket MCP
MCP server that lets ChatGPT, Claude and other clients search Blocket.se, open ads and check whether an asking price makes sense. It knows Torget and all twelve vehicle sections, from cars and boats to combines and snowmobiles.
Read-only. No account or API key.
Tools
searchtakes filters in plain words likeVolvo V70,SegelbåtorStockholmand looks up Blocket's ids itself. A misspelled make comes back with suggestions.exclude: ["skal", "laddare", "köpes"]clears phone cases, chargers and wanted ads out of an iPhone search, anddealsrates every ad against the median price of the same search.get_adopens up to five ads in full, seller included. If the text wants Swish up front, moves you to WhatsApp or has a foreign number in it, you'll hear about it. Vehicles with a visible reg number get car.info and biluppgifter links. Several ads come back side by side.get_ad_photoshands the model up to 8 photos of an ad. If it can see, it can spot the rust the seller forgot to mention.price_checkpulls live ads for the same make and model, close in year and mileage, or boats of about the same length. You get p10 to p90 and the spot where your ad lands. Give itnew_price(from Billigast, say) and it also shows what share of the shop price people ask. Blocket hides sold prices, so these are asking prices.list_filterslists a section's filters with live counts.
ChatGPT shows the results as cards with photos.
Local
For Claude Desktop there's a .mcpb file under Releases. Double-click it and it installs.
Anything else can run it in Docker:
claude mcp add blocket -- docker run -i --rm ghcr.io/idoo/blocket-mcp
Without Docker, Node 20 or newer works too:
npm ci && npm run build:stdio
node dist/blocket-mcp.js
ChatGPT, claude.ai
ChatGPT and claude.ai won't talk to your laptop. I host mine on a Cloudflare Worker, free plan:
npm ci && npx wrangler deploy
npx wrangler secret put MCP_PATH_TOKEN # openssl rand -hex 24
Paste https://<your worker>.workers.dev/mcp/<token> as the URL. The token is the only lock, so make it long. Other paths return 404, and wrangler.jsonc caps calls at 120 a minute. ChatGPT: Plugins, Add custom MCP server, no auth. claude.ai: Settings, Connectors.
Firebase works as well if you're on the Blaze plan:
npm ci && npm --prefix functions ci
firebase login && firebase use --add
firebase functions:secrets:set MCP_PATH_TOKEN
firebase deploy --only functions
Your URL is https://europe-north1-<project-id>.cloudfunctions.net/mcp/<token>. Firebase has no rate limiter, so the function stops at 3 instances. Region and limits are at the top of functions/src/index.ts.
Caveats
Blocket has no public API. The server calls the JSON endpoints blocket.se's own pages load, so when Blocket changes them this breaks until someone patches it. Filters are matched against Blocket's live lists, and a make that appeared last week already works.
The endpoint notes in dunderrrrrr/blocket_api got me started. Not affiliated with Blocket AB. MIT.
Blocket MCP questions
How do I add Blocket MCP to Claude Code?
Run claude mcp add blocket-mcp -- docker run -i --rm ghcr.io/idoo/blocket-mcp:2.2.0 in your terminal. Add --scope user to make it available in every project.
How do I add Blocket MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this server require an account or API key?
No, the server is read-only and does not require an account or an API key.
Can the server help identify potential scams in ads?
Yes, it can detect if an ad requests Swish upfront, directs you to WhatsApp, or contains foreign phone numbers.
How does the price check feature work?
It pulls live ads for similar makes, models, years, and mileage to provide a price range from p10 to p90.
Can the AI see the condition of an item?
Yes, the server provides up to 8 photos per ad, allowing the model to inspect details like rust.