RFC 9727 Compliant API Catalog

AEObility Public API & Agent Interface

Welcome to the official developer and AI agent interface directory for AEObility. All public endpoints support automated discovery via RFC 9727 linksets, strict CORS headers, and machine-readable OpenAPI specifications.

Format: application/linkset+json•OpenAPI 3.1.0•MCP v1.0.0 Enabled•Public Read Access (No Auth Required)

RFC 9727 Catalog

/.well-known/api-catalog

Machine-readable linkset mapping API anchors, specs, and status indicators.

OpenAPI Specification

Full OpenAPI 3.1.0 schema definitions and parameters for all public endpoints.

Operational Status

Real-time operational status, availability verification, and uptime heartbeats.

Public Endpoint Catalog

5 Active Services

POST/api/diagnostic

Telemetry

AI Visibility Diagnostic Scan

Executes a multi-stage telemetry scan checking entity salience, structured schema coverage, vector proximity, and AI search readiness.

Request Example

{
  "intent": "AEO consultant Perth",
  "url": "https://example.com.au"
}

Response Example (200 OK)

{
  "readinessScore": 84,
  "salienceRatio": 0.92,
  "status": "completed",
  "provenanceVerified": true
}

GET/api/brand-facts

Consensus

Brand Facts & Knowledge Lattice

Retrieves canonical consensus facts, business identity triples, fixed-scope pricing catalogs, and verified provenance lineage.

Request Example

curl -s https://aeobility.com.au/api/brand-facts

Response Example (200 OK)

{
  "account": "AEObility CBKL Domain Engine",
  "payload": {
    "identity": { "legalName": "AEObility", "abn": "39 635 245 422" },
    "commercialManifest": { "currency": "AUD", "taxStatus": "Excluding GST" }
  }
}

GET/api/mcp

Agent Protocol

Model Context Protocol (MCP) Tools

Exposes MCP v1.0.0 tools and schema definitions for autonomous AI agents, including entity retrieval and knowledge hub queries.

Request Example

curl -s https://aeobility.com.au/api/mcp

Response Example (200 OK)

{
  "mcpVersion": "1.0.0",
  "tools": [
    { "name": "get_organization_entity", "description": "Retrieves canonical consensus facts" },
    { "name": "query_knowledge_hub_node", "description": "Searches semantic lattice links" }
  ]
}

GET / POST/api/search

Retrieval

Grounded Vector Knowledge Retrieval

Performs hybrid semantic and lexical retrieval across AEObility articles, guides, and Atomic Answer Blocks.

Request Example

curl -s "https://aeobility.com.au/api/search?q=what+is+aeo"

Response Example (200 OK)

{
  "answer": "Answer Engine Optimisation (AEO) structures first-party business facts...",
  "similarityScore": 0.94,
  "topMatch": { "title": "What is AEO", "url": "/services/aeo/definition" }
}

GET/api/health

Operations

API Health & Status

Returns operational availability, server timestamp, and automated catalog links for monitoring.

Request Example

curl -s https://aeobility.com.au/api/health

Response Example (200 OK)

{
  "status": "ok",
  "service": "AEObility API Platform",
  "system": "operational",
  "catalog": "https://aeobility.com.au/.well-known/api-catalog"
}

Autonomous Agent Guidelines

AI bots, crawlers, and retrieval systems can discover AEObility services automatically without manual configuration. All responses are served with permissive cross-origin headers (Access-Control-Allow-Origin: *). For grounding specifications and brand facts provenance, refer to our public AGENTS.md specification and llms.txt.