Blocket MCP

Blocket MCP

I got tired of scrolling Blocket, so now ChatGPT does it.

It can't log in, message sellers or post anything. It reads public ads and that's it.

[License: MIT] [MCP]

Tools

search knows all 13 sections: Torget plus cars, boats, motorcycles, caravans, motorhomes, trucks, tractors, combines, snowmobiles, ATVs, mopeds and buses. You write filters like a person would, Volvo V70, Segelbåt, Stockholm, and the server works out Blocket's ids. Typo in a make? It comes back under unmatched with suggestions and the model fixes it on the next call. Without that you'd quietly get every car in Sweden. There's radius search with distances, giveaways and wanted ads, items that ship, "what's new since this morning", one seller's whole stock, and value counts when you want a quick read on the market. Each search also returns its blocket.se URL. Save it in the Blocket app and you'll get pushes when new ads turn up.

Blocket's own search throws in a lot of junk. Looking for an iPhone 13? Pass exclude with skal, laddare and köpes, and the cases, chargers and wanted ads are gone. There's require too, and a titles-only switch. When that leaves a page half empty the server keeps reading, but stops at 200 ads. The usual Blocket operators still do their thing: -word, OR, "exact phrase", word*. Turn on deals and each result gets a label against the median price of the same search, from great to high. Titles with "defekt", "reservdelar", "startar inte" and the like get flagged either way.

get_ad takes up to five ad ids or links. Description, specs, equipment, every photo, whether it's still for sale, who's selling and how many people saved it. It points out the usual scam signs too: pay outside Blocket, "write me on WhatsApp", a foreign number. Cars and boats get horsepower, EVs their range and battery size, and dealer cars the price without VAT when the dealer shows it. Dealers with a Google rating get that as well. Cars from dealers come with links to their history. Give it several ads and you get a comparison.

get_ad_photos sends up to 8 photos of an ad as real images, so a model that can see judges the condition itself. Rust, cracks and missing parts show up there sooner than in the description.

price_check is for "is this price fair?". It finds comparable live ads by make, model, year, mileage or boat length and gives you p10 to p90 plus where your ad lands. With fewer than 8 comparables it loosens the match and says what it dropped. The numbers are asking prices, since Blocket doesn't show what anything sold for.

list_filters lists a section's filters and values with live counts.

On your own computer

Claude Desktop, Claude Code, Cursor and Codex can run the server locally over stdio. That needs no token and no hosting.

Claude Desktop users grab blocket-mcp-<version>.mcpb from Releases and double-click it. That's the whole install.

Other clients can start it with Docker. In Claude Code that looks like this:

claude mcp add blocket -- docker run -i --rm ghcr.io/idoo/blocket-mcp

Cursor and Codex take the same command and args in their MCP config. If you'd rather skip Docker, build it yourself with Node 20 or newer:

npm ci && npm run build:stdionode dist/blocket-mcp.js

Hosted, for ChatGPT and claude.ai

ChatGPT and claude.ai can't reach your laptop, so the server needs a public HTTPS address. I run mine on Cloudflare. Firebase works too.

There's no login. ChatGPT's custom connectors offer OAuth or nothing, and OAuth felt like overkill for public ads, so the endpoint hides behind a secret path, /mcp/<token>. Any other path gets a 404. Make up a long random token:

openssl rand -hex 24

Cloudflare Workers

The free plan does fine here.

git clone https://github.com/idoo/blocket-mcp && cd blocket-mcpnpm cinpx wrangler loginnpx wrangler deploynpx wrangler secret put MCP_PATH_TOKEN    # paste the token

Wrangler prints a workers.dev URL at the end. Stick /mcp/<token> on it. There's a limit of 120 calls a minute in wrangler.jsonc.

Local dev: MCP_PATH_TOKEN=dev in .dev.vars, npm run dev, then http://localhost:8787/mcp/dev.

Firebase

Cloud Functions need the Blaze plan, which means a card on file. A single person's traffic won't leave the free tier.

git clone https://github.com/idoo/blocket-mcp && cd blocket-mcpnpm ci && npm --prefix functions cifirebase loginfirebase use --add                              # pick your projectfirebase functions:secrets:set MCP_PATH_TOKEN   # paste the tokenfirebase deploy --only functions

The endpoint is https://europe-north1-<project-id>.cloudfunctions.net/mcp/<token>. There's no rate limiter on Firebase. The function stops at 3 instances, which keeps the bill small if someone finds your URL. Want another region or more room? Top of functions/src/index.ts.

To test without deploying, drop MCP_PATH_TOKEN=dev into functions/.secret.local and start firebase emulators:start --only functions. The URL is http://127.0.0.1:5001/<project-id>/europe-north1/mcp/dev.

Connect

ChatGPT on the web: Plugins, Add, "Add custom MCP server". Paste the endpoint, no authentication, done. Then @Blocket in any chat. It won't nag for permission on every call because all tools are marked read-only.

claude.ai: Settings → Connectors → Add custom connector.

Claude Code and Codex:

claude mcp add --transport http blocket https://…/mcp/<token>codex mcp add blocket --url https://…/mcp/<token>

How it works

Blocket has no public API. The server calls the JSON endpoints that blocket.se's own pages load, usually one request per tool call and a few for comparisons and price checks. Filter names are matched against Blocket's live filter lists, so a make that showed up last week already works. If Blocket changes those endpoints, this breaks until someone patches it. PRs welcome.

The endpoint notes in dunderrrrrr/blocket_api got me started. Not affiliated with Blocket AB.

License

MIT