MCP server · AI plugin

Add the Auckland builders directory to your AI assistant

Ask ChatGPT, Claude, Grok, Gemini or your own agent for Auckland builders by suburb, project type, credential or company-register status, and get sourced answers with the date each fact was checked. Free to use, no sign-up.

https://mcp.compare-auckland-newbuilds-renovations.org/mcp

What you get

A read-only directory of 301 Auckland builders from compare-auckland-newbuilds-renovations.org, with the status badge from the public Companies Office register (and the date), credentials listed on the builder's own website, ratings as shown at the source, open public leads, and links to official records. Every record carries its source and the date it was checked.

ToolWhat it doesPaid burn
search_buildersSearch by query, suburb, project type, credential, status, rating1 credit per organic record
get_builderFull profile, register details, provenance2 (full) / 1 (summary)
compare_builders2 to 4 builders side by side2 per builder
get_open_leadsRecent public job leads by suburb or trade1 per lead
builder_checksSourced LBP, liquidation and prosecution records by namefree
list_suburbs, list_project_types, how_to_get_quotes, my_usageReference data, quote checklist and links, your balancefree

Try these prompts

Install in your app

Server URL (Streamable HTTP, no authentication needed for free use): https://mcp.compare-auckland-newbuilds-renovations.org/mcp. App menus change often, so where a step is not what you see, check your app's connector or MCP settings.

ChatGPT remote MCP
  1. Open Settings → Apps & Connectors (older name: Connectors). Under Advanced settings turn on Developer mode.
  2. Click Create (custom connector or app). Name: Auckland Builders. MCP server URL: https://mcp.compare-auckland-newbuilds-renovations.org/mcp. Authentication: No authentication.
  3. Tick the trust box and Create. In a new chat choose it from the + menu (More → Developer mode) and ask your question.

Custom connectors depend on your plan and region; on Business or Enterprise an admin may need to allow them. ChatGPT cannot send custom headers, so with a paid key use the key-in-URL form shown under "Using a paid key".

Claude: claude.ai and Claude Desktop remote MCP
  1. Open Settings → Connectors and choose Add custom connector.
  2. Name Auckland Builders, URL https://mcp.compare-auckland-newbuilds-renovations.org/mcp, then Add. Leave any OAuth fields empty.
  3. In a chat, open the tools menu and enable the connector.

Available on paid Claude plans (Free is limited); on Team and Enterprise an Owner adds it under Organization settings → Connectors. Claude Desktop uses the same Connectors screen; its JSON config file only runs local servers, so use the mcp-remote recipe if you prefer a file.

Claude Code (terminal)

claude mcp add --transport http auckland-builders https://mcp.compare-auckland-newbuilds-renovations.org/mcp
Grok (grok.com and apps) custom connector
  1. Go to grok.com/connectors, click New Connector and choose Custom.
  2. Paste https://mcp.compare-auckland-newbuilds-renovations.org/mcp and complete the form (no authentication for free use).

Grok Business and Enterprise: a team admin must provision the connector first. xAI API (developers): add {"type":"mcp","server_url":"https://mcp.compare-auckland-newbuilds-renovations.org/mcp","server_label":"auckland_builders"} to tools in a /v1/responses request; add "authorization": "Bearer cab_YOUR_KEY" for a paid key.

Grok Bot custom MCP server

Tell your bot: "Add this MCP server: https://mcp.compare-auckland-newbuilds-renovations.org/mcp", or add it yourself under the bot's connectors settings (add a custom MCP server by URL). For a paid key put Authorization: Bearer cab_YOUR_KEY in the server's headers field. Check your app's connector settings if the menu names differ.

Gemini limited availability

Gemini app (web and mobile): on gemini.google.com go to Settings → Connected Apps → Add a custom app and paste https://mcp.compare-auckland-newbuilds-renovations.org/mcp. Google currently limits custom apps to eligible personal accounts (18+, US, English, Keep Activity on), so you may not see the option.

Gemini CLI

gemini mcp add --transport http auckland-builders https://mcp.compare-auckland-newbuilds-renovations.org/mcp

For a paid key add --header "Authorization: Bearer cab_YOUR_KEY". Developers can also attach remote MCP servers through the Gemini API and Google's ADK.

Meta AI not supported yet

We could not find a way to add your own MCP server to the Meta AI app: Meta runs a developer-preview connector programme for service providers, not a "paste a URL" setting. Honest options:

  • Paste this into the chat: "Use https://mcp.compare-auckland-newbuilds-renovations.org/llms.txt and https://compare-auckland-newbuilds-renovations.org/directory/ to find Auckland builders for ...". The web route works without MCP but has no live status checks or rate-limited API.
  • Developers using the Llama API or Llama Stack can connect any remote MCP server by URL: https://mcp.compare-auckland-newbuilds-renovations.org/mcp.
Hermes Agent remote MCP

Add to ~/.hermes/config.yaml, then run /reload-mcp:

mcp_servers:
  auckland_builders:
    url: "https://mcp.compare-auckland-newbuilds-renovations.org/mcp"
    # paid key (optional):
    # headers:
    #   Authorization: "Bearer cab_YOUR_KEY"
Cursor remote MCP

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), or use Settings → MCP → Add:

{
  "mcpServers": {
    "auckland-builders": {
      "url": "https://mcp.compare-auckland-newbuilds-renovations.org/mcp"
    }
  }
}

Paid key: add "headers": {"Authorization": "Bearer cab_YOUR_KEY"} inside the server object.

VS Code and GitHub Copilot remote MCP

Run MCP: Add Server from the Command Palette and choose HTTP, or create .vscode/mcp.json:

{
  "servers": {
    "auckland-builders": {
      "type": "http",
      "url": "https://mcp.compare-auckland-newbuilds-renovations.org/mcp"
    }
  }
}

Paid key: add "headers": {"Authorization": "Bearer cab_YOUR_KEY"}. Use Copilot Chat in Agent mode.

Windsurf remote MCP

Open the Cascade MCP panel (or edit ~/.codeium/windsurf/mcp_config.json; newer installs may use ~/.config/devin/mcp_config.json):

{
  "mcpServers": {
    "auckland-builders": {
      "serverUrl": "https://mcp.compare-auckland-newbuilds-renovations.org/mcp"
    }
  }
}
Any other client, or older clients that only run local commands (mcp-remote)

Clients that accept a remote server URL: use https://mcp.compare-auckland-newbuilds-renovations.org/mcp (Streamable HTTP). For clients that can only launch a local command, bridge with mcp-remote (needs Node.js):

{
  "mcpServers": {
    "auckland-builders": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.compare-auckland-newbuilds-renovations.org/mcp", "--transport", "http-only"]
    }
  }
}

Paid key with mcp-remote: append "--header", "Authorization: Bearer cab_YOUR_KEY" to args. Quick test from a terminal:

curl -s https://mcp.compare-auckland-newbuilds-renovations.org/mcp -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_builders","arguments":{"query":"kitchen","suburb":"Howick"}}}'

OpenAI API: tools: [{"type":"mcp","server_label":"auckland_builders","server_url":"https://mcp.compare-auckland-newbuilds-renovations.org/mcp","require_approval":"never"}]. This server speaks MCP 2025-03-26 to 2025-11-25 and the stateless 2026-07-28 revision. It does not offer the legacy /sse transport.

Using a paid key

After a purchase you get a key starting cab_ on the welcome page. Send it as a Bearer token where your app allows custom headers (Claude Code, Cursor, VS Code, Windsurf, Hermes, Gemini CLI, mcp-remote, APIs). Apps that only take a URL (ChatGPT, claude.ai, Grok, Gemini app) can use the key-in-URL form, which you should treat like a password:

https://mcp.compare-auckland-newbuilds-renovations.org/k/cab_YOUR_KEY/mcp

Check your balance any time on the account page or by asking your assistant to run my_usage.

Plans and limits

Free

No key. 5 organic results per call, 30 calls per hour and 200 per day per client. Sponsored featured listings are always shown on top and do not count against your results.

Prepaid credits

From NZ$15 for 500 credits. Up to 25 results per call, paging, full profiles. Credits last 90 days. See plans.

Neutrality, privacy and data

  • Sponsored placements: builders can buy a featured spot for a suburb. Those listings always come first, are labelled "Sponsored", and cannot be filtered out by any parameter. They do not change how organic results are ordered and are not an endorsement.
  • Status badges show what the public Companies Office register says on a stated date, not quality of work.
  • Privacy: addresses are suburb-level only; emails appear only where the builder publishes one on its own website. This server never asks for or stores your name, phone or email. Free-tier limits use a salted hash of your IP address, not the address. Paid keys store only a hash of the key and a usage log (deleted after 12 months).
  • Sources: each record shows where it came from and when. Methodology: compare-auckland-newbuilds-renovations.org/about.

Other formats

/llms.txt (for crawlers and assistants without MCP) · /pricing.json · /pricing · /account · main site llms.txt