Irish classifieds toolkit (Daft + Adverts)

Bun monorepo: unofficial HTTP clients and MCP servers for two Irish sites —

Not affiliated with Distilled Media, Daft, or Adverts. Protocols and shapes come from the Android apps.

Disclaimer

This repository was written entirely by AI coding agents under human direction. Experiment / personal tooling — not a supported product.

• No warranty — correctness and API compatibility are not guaranteed; upstream apps change.

• Tests are minimal — do not treat a green test run as production-ready.

• Use at your own risk. Respect ToS and rate limits; do not scrape, spam, or abuse accounts.

Related MCP server: Bazos-MCP

Packages

packages/
  daft-api/       @daft-ie/api          HTTP client → gateway.daft.ie / auth.daft.ie
  daft-mcp/       @daft-ie/mcp          MCP tools (stdio) over daft-api
  adverts-api/    @adverts-ie/api       HTTP client → new.api + api.adverts.ie
  adverts-mcp/    @adverts-ie/mcp       MCP tools (stdio) over adverts-api
  mcp-host/       @daft-ie/mcp-host     one Fastify process: both MCPs over HTTP (+ Docker)

Layering:

  Cursor / OpenCode / Hermes / your code
            │
            ├─ stdio ──► daft-mcp ──► daft-api ──► Daft
            ├─ stdio ──► adverts-mcp ──► adverts-api ──► Adverts
            └─ HTTP  ──► mcp-host ──► both MCP servers (shared process)

Quick start

bun install
cp .env.example .env   # fill DAFT_* and/or ADVERTS_* as needed

Library use

import { DaftApi } from "@daft-ie/api";
import { AdvertsApi } from "@adverts-ie/api";

const daft = new DaftApi({ platform: "android", appVersion: "9.8.1" });
const adverts = new AdvertsApi();

MCP over HTTP (both tools, one process) — preferred for multi-client setups:

bun packages/mcp-host/src/index.ts
# http://127.0.0.1:3100/mcp/daft
# http://127.0.0.1:3100/mcp/adverts

Docker: see packages/mcp-host.

MCP stdio (single server per process)

bun packages/daft-mcp/src/index.ts
bun packages/adverts-mcp/src/index.ts

Wire-up for Cursor CLI, OpenCode, and Hermes is documented in packages/mcp-host/README.md.

Environment

Shared root .env (gitignored). Rough split:

Token files after login: .daft-tokens.json, .adverts-tokens.json (override with *_TOKEN_FILE).

You can run only Daft, only Adverts, or both — unused keys are simply unused.

Tests

Per package (bun test in that folder). Coverage is intentionally thin; see disclaimer.

License

MIT (unless a package says otherwise).