---
title: "Structured agent metadata"
method: GET
path: "/.well-known/agent.json"
---

# Structured agent metadata

`GET /.well-known/agent.json`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/.well-known/agent.json`
- Auth: none declared

Machine-readable JSON describing Oracle identity, skills, MCP tools, REST endpoints, auth requirements, payment and trust anchors. Includes spec_version (YYYY-MM-DD) for staleness detection.

## Response `200`

Agent metadata

- object
  - `schema_version` string
  - `spec_version` string: YYYY-MM-DD — compare against cached value to detect stale metadata.
  - `name` string
  - `homepage` string, uri: The website. It is not an endpoint; the endpoints are listed in interfaces.
  - `interfaces` object[]: The machine interfaces that exist: MCP (streamable-http) and OpenAPI.
    - `type` 'mcp' | 'openapi'
    - `transport` string
    - `url` string, uri
  - `mcp` object
  - `rest_api` object
  - `trust` object
  - `safety` object

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)