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/mcpWhat 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.
| Tool | What it does | Paid burn |
|---|---|---|
search_builders | Search by query, suburb, project type, credential, status, rating | 1 credit per organic record |
get_builder | Full profile, register details, provenance | 2 (full) / 1 (summary) |
compare_builders | 2 to 4 builders side by side | 2 per builder |
get_open_leads | Recent public job leads by suburb or trade | 1 per lead |
builder_checks | Sourced LBP, liquidation and prosecution records by name | free |
list_suburbs, list_project_types, how_to_get_quotes, my_usage | Reference data, quote checklist and links, your balance | free |
Try these prompts
- "Find Auckland builders for a bathroom renovation in Mt Eden. Show their company-register status and when it was checked."
- "Compare 3C Homes and two other builders who list Master Builders membership, for a new build on the North Shore."
- "Are there any official records (LBP decisions, liquidations) with this company name: <name>?"
- "What open building leads are there in Howick this week?"
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
- Open Settings → Apps & Connectors (older name: Connectors). Under Advanced settings turn on Developer mode.
- Click Create (custom connector or app). Name:
Auckland Builders. MCP server URL:https://mcp.compare-auckland-newbuilds-renovations.org/mcp. Authentication: No authentication. - 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
- Open Settings → Connectors and choose Add custom connector.
- Name
Auckland Builders, URLhttps://mcp.compare-auckland-newbuilds-renovations.org/mcp, then Add. Leave any OAuth fields empty. - 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/mcpGrok (grok.com and apps) custom connector
- Go to grok.com/connectors, click New Connector and choose Custom.
- Paste
https://mcp.compare-auckland-newbuilds-renovations.org/mcpand 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