Skip to content

Advanced: programmatic access

Connecting MarketBuddy to n8n, Make, custom scripts, or your own apps.

The interactive sign-in flow used by Claude, ChatGPT, and Cursor is convenient but it requires a browser. If you want to call MarketBuddy from automated workflows or your own code, you can authenticate with a MarketBuddy API token instead.

Same data, different auth

Both authentication methods give access to the same MarketBuddy MCP tools and data. The only difference is how you sign in.

Get an API token

API tokens aren't yet self-serve. To request one, contact our team via the Support Portal and tell us roughly what you're building (n8n flow, internal script, etc.) so we can issue a token for your account.

Tokens start with pdj_ - treat them like a password. They don't expire by default, but we can revoke or time-limit a token on request.

Server details

  • MCP endpoint: https://mcp.marketbuddy.com.au/mcp
  • Transport: Streamable HTTP
  • Auth header: Authorization: Bearer pdj_<your-token>

Connect from n8n or Make

In an MCP-aware node:

  • Server URL: https://mcp.marketbuddy.com.au/mcp
  • Authentication: Bearer token
  • Token: your pdj_… value

No OAuth flow is required - the bearer token is checked on every request.

Connect from a custom client

Any MCP client that supports streamable HTTP and a custom Authorization header can connect. The MarketBuddy server exposes three tools:

Search listings by suburb or postcode with optional filters.

Key parameters:

  • channel (required) - "sale" or "lease".
  • suburb or postcode - at least one is required.
  • state - optional qualifier (e.g. "VIC", "NSW").
  • property_types - one or more of: hotel_and_leisure, industrial_warehouse_and_factories, land_and_developments, medical_consulting, offices, other, parking, retail_and_shops, rural_and_farming, serviced_offices, showrooms_bulky_goods.
  • price_min, price_max - price filter (units follow the listing channel).
  • floor_area_min, floor_area_max - square metres.
  • limit (1-100, default 20), offset for pagination.
  • sort_field - "listed_date" (default) or "price".
  • sort_direction - "desc" (default) or "asc".

Returns a results array of listing summaries plus a pagination object.

Search listings within a radius of a coordinate.

Key parameters:

  • channel (required) - "sale" or "lease".
  • latitude (-90 to 90), longitude (-180 to 180) - both required.
  • distance - radius in metres (0-5000, default 1000).
  • Same filter, sort, and pagination options as faceted_search (property_types, price_*, floor_area_*, sort_field, sort_direction, limit, offset). Suburb, postcode, and state do not apply.

property_details

Fetch the full record for one listing.

Key parameters:

  • channel - transaction type.
  • listing_id - the integer ID returned in search results.

Returns the full listing object - description, images, floor plans, documents, area breakdowns - or null if the ID does not exist in that channel.

Health check

curl https://mcp.marketbuddy.com.au/mcp/health

Returns {"status": "ok", "version": "..."}. No authentication required.

Need raw HTTP examples or schema definitions?

For full request/response examples and JSON schemas, contact our team via the Support Portal - we'll point you at the latest reference.