Ausdata AI Model Context Protocol (MCP)

The MCP service provides private, authenticated access to Australian address search and structured address details.

01 / Overview

Australian address data.

Ausdata AI (Ausdata Science Pty Ltd) provides the service through an Ausvector address index derived from Open G-NAF Core data. It returns compact search candidates and detailed structured address records.

02 / Endpoint

Private beta MCP endpoint.

https://mcp.ausvector.ai/mcp

Transport: HTTP POST
Authentication: Bearer API key
Protocol: 2026-07-28

Usage notice. Access requires an approved API key with the align:address scope and is subject to the Terms of Use and Privacy Policy. Information and outputs are for general research and analytics only, and do not constitute investment, financial, legal, or professional advice.

Access is provided through a private beta. To request a testing key, complete the access request form below with your name, intended use, and preferred integration.

Private beta access

Request a testing key.

Tell us who you are, what you are building, and whether you prefer the API or MCP.

03 / HTTP API v1

Use the API directly.

The HTTP API provides the same Australian address search and detail workflow for invited applications that prefer REST over MCP.

https://api.ausvector.ai/api/v1

Version: 1.0
Authentication: x-matrix-auth API key header
Required scope: align:address

API access is provided through a private beta and requires an approved testing key.

Private beta access

Request a testing key.

Tell us who you are, what you are building, and whether you prefer the API or MCP.

Suggest or search

GET /api/v1/address/suggest accepts q and an optional limit from 1 to 50. Use mode=search, cache=off, or suburb, state, and postcode when needed.

curl "https://api.ausvector.ai/api/v1/address/suggest?q=100%20Queen%20Street%2C%20Melbourne%20VIC%203000&limit=10" \
  -H "x-matrix-auth: <your-api-key>"

Get address detail

GET /api/v1/address/detail requires the selected address identifier as pid. The response includes the address record and normalized au_pid, uuid, and gnaf_pid identifiers.

curl "https://api.ausvector.ai/api/v1/address/detail?pid=GAVIC412716430" \
  -H "x-matrix-auth: <your-api-key>"

Response flow. Search results include structured components and stable identifiers. Pass the chosen identifier to the detail endpoint when the application needs the complete address record.

04 / Quickstart

Two-step address lookup.

  1. 01
    Search.

    Call search_address with an address query to receive compact candidates.

  2. 02
    Select.

    Choose the accepted candidate and keep its returned id.

  3. 03
    Get details.

    Call get_address_detail with the candidate id.

05 / Protocol

Simple, read-only tools.

The service supports the Model Context Protocol over HTTP and exposes two read-only tools: search_address and get_address_detail.

POST /mcp HTTP/1.1
Host: mcp.ausvector.ai
Authorization: Bearer &lt;your-api-key&gt;
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}

Keep API keys private. See the data policy, terms, and privacy pages before integrating the service.

06 / Roadmap

More Australian data capabilities.

Ausdata AI (Ausdata Science Pty Ltd) is progressively integrating additional Australian open datasets and expanding its API and MCP capabilities. Further releases will be announced as they become available.