Compare Auckland Builds MCP
A read-only MCP server providing a directory of 2143 Auckland builders, including company-register status, credentials, ratings, and open public leads. It allows agents to search by suburb, trade, or project type and compare builders side-by-side.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.compare-auckland-newbuilds-renovations.org/mcpWhat its tools do
11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to compare-auckland-newbuilds-renovations.org ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for Auckland builders by suburb and project type
- Compare multiple builders side-by-side
- Check company-register status and credentials
- Find open public building leads
Source and maintenance
Protocol and capabilities
- Server
- compare-auckland-builders 1.1.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 11 advertised
- Resources
- 4 advertised
- Resource templates
- 0 advertised
- Prompts
- 3 advertised
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
11 advertised
search_builders — Search Auckland builders
Search the Compare Auckland Builds directory of Auckland new-build and renovation builders (about 300 listings, each checked against its own website and public registers). Filter by suburb, project type, credential, register status and minimum rating. Returns organic results plus, always first and clearly labelled, any paid 'Sponsored' featured listings for the suburb (these cannot be filtered out or limited away). Free use returns at most 5 organic results per call.
{
"type": "object",
"properties": {
"sort": {
"enum": [
"relevance",
"name",
"rating"
],
"type": "string",
"description": "Order of organic results (default relevance with a query, otherwise name). Sponsored listings are always first."
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Organic results wanted (free tier max 5, paid max 25). Does not affect sponsored listings."
},
"query": {
"type": "string",
"description": "Free text: trade, project, builder name or suburb, e.g. 'bathroom renovation Ponsonby'."
},
"trade": {
"type": "string",
"description": "Trade slug or name from list_trades (default 'builders'; 'any' searches every trade). Sponsored placement is per trade."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Paid keys only: skip this many organic results."
},
"status": {
"enum": [
"any",
"registered",
"not_matched",
"in_removal",
"removed",
"liquidation",
"receivership",
"administration",
"closed",
"not_checked"
],
"type": "string",
"description": "Filter by company-register status badge (default any)."
},
"suburb": {
"type": "string",
"description": "Auckland suburb name or slug, e.g. 'Mt Eden', 'howick'. Use list_suburbs to see covered suburbs."
},
"credential": {
"type": "string",
"description": "Credential or membership the builder's website lists, e.g. 'Master Builders', 'Certified Builders', 'Site Safe', 'Halo', 'LBP'."
},
"min_rating": {
"type": "number",
"maximum": 5,
"minimum": 0,
"description": "Minimum rating as shown on the listing source; unrated listings are excluded when set."
},
"project_type": {
"type": "string",
"description": "e.g. 'Bathrooms', 'Kitchens', 'New builds', 'Extensions & additions', 'Decks & outdoor', 'Recladding & weathertightness'. Use list_project_types."
}
},
"additionalProperties": true
}{
"title": "Search Auckland builders",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_businesses — Search businesses of any trade
Same as search_builders, but the default is ANY trade on a new build or renovation (builders, plumbers, electricians, landscapers, architects ... see list_trades). Pass trade to narrow to one. Sponsored (featured) listings come first for the trade searched, labelled, and cannot be filtered away. Trades other than builders may have no listings yet.
{
"type": "object",
"properties": {
"sort": {
"enum": [
"relevance",
"name",
"rating"
],
"type": "string",
"description": "Order of organic results (default relevance with a query, otherwise name). Sponsored listings are always first."
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Organic results wanted (free tier max 5, paid max 25). Does not affect sponsored listings."
},
"query": {
"type": "string",
"description": "Free text: trade, project, builder name or suburb, e.g. 'bathroom renovation Ponsonby'."
},
"trade": {
"type": "string",
"description": "Trade slug or name from list_trades (default 'builders'; 'any' searches every trade). Sponsored placement is per trade."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Paid keys only: skip this many organic results."
},
"status": {
"enum": [
"any",
"registered",
"not_matched",
"in_removal",
"removed",
"liquidation",
"receivership",
"administration",
"closed",
"not_checked"
],
"type": "string",
"description": "Filter by company-register status badge (default any)."
},
"suburb": {
"type": "string",
"description": "Auckland suburb name or slug, e.g. 'Mt Eden', 'howick'. Use list_suburbs to see covered suburbs."
},
"credential": {
"type": "string",
"description": "Credential or membership the builder's website lists, e.g. 'Master Builders', 'Certified Builders', 'Site Safe', 'Halo', 'LBP'."
},
"min_rating": {
"type": "number",
"maximum": 5,
"minimum": 0,
"description": "Minimum rating as shown on the listing source; unrated listings are excluded when set."
},
"project_type": {
"type": "string",
"description": "e.g. 'Bathrooms', 'Kitchens', 'New builds', 'Extensions & additions', 'Decks & outdoor', 'Recladding & weathertightness'. Use list_project_types."
}
},
"additionalProperties": true
}{
"title": "Search businesses of any trade",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_trades — List trades
The 42 trades involved in New Builds and Renovations in three groups (Building trades, Siteworks trades, Professional services), each with a plain-English description, the NZ licensing or registration body to check, the page URL and the number of directory listings. No credits.
{
"type": "object",
"properties": {
"group": {
"enum": [
"building",
"siteworks",
"professional"
],
"type": "string",
"description": "Optional group filter."
},
"with_listings": {
"type": "boolean",
"description": "Only trades that have at least one listing."
}
},
"additionalProperties": true
}{
"title": "List trades",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_builder — Get one builder
Full public profile for one directory listing (any trade): where they work, project types, credentials, register details, rating, status badge with date, published contact details, and provenance (source and date checked). Pass a slug (from search_builders) or the builder's name. detail=full costs 2 credits for paid keys; free use returns the summary.
{
"type": "object",
"required": [
"builder"
],
"properties": {
"detail": {
"enum": [
"summary",
"full"
],
"type": "string",
"description": "Default full for paid keys, summary for free use."
},
"builder": {
"type": "string",
"description": "Builder slug (e.g. '3c-homes'), profile URL, or name."
}
},
"additionalProperties": true
}{
"title": "Get one builder",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_suburbs — List covered suburbs
Auckland suburbs and areas covered by the directory, with region and profile page link. No credits.
{
"type": "object",
"properties": {
"region": {
"type": "string",
"description": "Optional region filter, e.g. 'North Shore', 'South Auckland'."
}
},
"additionalProperties": true
}{
"title": "List covered suburbs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_project_types — List project types
Project types used by the directory (new builds, kitchens, bathrooms ...) with the number of listings for each, plus the most common credentials. No credits.
{
"type": "object",
"properties": {},
"additionalProperties": true
}{
"title": "List project types",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_open_leads — Open public leads
Recent public job leads in Auckland (from third-party marketplaces) that builders can respond to, by suburb and/or trade. Links go to the original posting; no personal details are included. 1 credit per lead for paid keys; free use max 5 per call.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"trade": {
"type": "string",
"description": "e.g. 'builder', 'carpenter', 'plumber', 'bathroom'."
},
"suburb": {
"type": "string",
"description": "Suburb or region name."
}
},
"additionalProperties": true
}{
"title": "Open public leads",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}compare_builders — Compare builders side by side
Side-by-side comparison of 2 to 20 listings of any trade (slugs or names; the trade is shown for each): status badge, base, project types, credentials, rating, register details. Paid keys: 2 credits per builder with the richer fields; free use gets the summary comparison.
{
"type": "object",
"required": [
"builders"
],
"properties": {
"builders": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 2,
"description": "2-20 business slugs or names (any trade)."
}
},
"additionalProperties": true
}{
"title": "Compare builders side by side",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}builder_checks — Official records search
Neutral lookup of sourced public records (LBP Board disciplinary decisions, Gazette liquidation notices, Official Assignee notices, MBIE prosecutions) the website has collected. With no query: an overview with counts, dates checked and sources. With a query (name or company): name matches only, each with its source link. A name match is not proof of identity and a record is not a quality rating. No credits.
{
"type": "object",
"properties": {
"type": {
"enum": [
"all",
"lbp",
"liquidation",
"assignee",
"prosecution"
],
"type": "string"
},
"query": {
"type": "string",
"description": "Person or company name (at least 3 characters). Omit for the overview."
}
},
"additionalProperties": true
}{
"title": "Official records search",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}how_to_get_quotes — How to get quotes
Links and a short checklist for getting and comparing quotes: the website's project brief and shortlist tools. Contains no personal data and this server never receives a user's name, phone or email. Optionally pass a suburb to include its page and any Sponsored featured builders there.
{
"type": "object",
"properties": {
"suburb": {
"type": "string"
},
"project_type": {
"type": "string"
}
},
"additionalProperties": true
}{
"title": "How to get quotes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}my_usage — Plan, balance and usage
Shows how many free calls are left this hour/day, or for a paid key the credit balance, expiry dates and recent usage. No credits.
{
"type": "object",
"properties": {},
"additionalProperties": true
}{
"title": "Plan, balance and usage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
3 advertised
find_builder — Find a builder
Shortlist Auckland builders for a project.
- project
- e.g. bathroom renovation (required)
- suburb
- e.g. Mt Eden
vet_builder — Check a builder
Review one builder's profile and public-record checks.
- builder
- Name or slug (required)
compare_shortlist — Compare a shortlist
Compare 2-20 businesses (any trade) side by side.
- builders
- Comma-separated names or slugs (required)
Resources
4 advertised
about — About this directory and its rules
Coverage, neutrality, sponsored-placement rules, privacy.
directory://aboutstatus-key — Meaning of the status badges
What each company-register status badge means.
directory://status-keysuburbs — Covered suburbs
Suburb slugs, names, regions.
directory://suburbspricing — Plans, limits and burn rates
Free limits, credit burn rates and pack prices.
directory://pricing90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
- 2026-11-09: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 285 ms
- 95th percentile latency
- 285 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 285 ms · metadata changed · 11 tool(s), 4 resource(s), 0 resource template(s), 3 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http compare-auckland-builds-mcp https://mcp.compare-auckland-newbuilds-renovations.org/mcpCodex
codex mcp add compare-auckland-builds-mcp --url https://mcp.compare-auckland-newbuilds-renovations.org/mcpCursor
{
"mcpServers": {
"compare-auckland-builds-mcp": {
"url": "https://mcp.compare-auckland-newbuilds-renovations.org/mcp"
}
}
}Cline
{
"mcpServers": {
"compare-auckland-builds-mcp": {
"type": "streamableHttp",
"url": "https://mcp.compare-auckland-newbuilds-renovations.org/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"compare-auckland-builds-mcp": {
"type": "http",
"url": "https://mcp.compare-auckland-newbuilds-renovations.org/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http compare-auckland-builds-mcp https://mcp.compare-auckland-newbuilds-renovations.org/mcpClaude Desktop
https://mcp.compare-auckland-newbuilds-renovations.org/mcpWindsurf
{
"mcpServers": {
"compare-auckland-builds-mcp": {
"serverUrl": "https://mcp.compare-auckland-newbuilds-renovations.org/mcp"
}
}
}Let your agent find its tools
Find servers like Compare Auckland Builds MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run Compare Auckland Builds MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.