BRX Public API & Agent Endpoints

Machine-readable discovery files, agent tools, and integration resources for brx.sa

↓ OpenAPI 3.1 Spec (JSON)

Agent Discovery Endpoints

GET/.well-known/api-catalog

RFC 9727 API Catalog. Machine-readable application/linkset+json index of all public BRX endpoints. AI agents use this to auto-discover available APIs.

RFC 9727application/linkset+json
↗ View Live

GET/.well-known/agent-skills/index.json

Agent Skills RFC v0.2 index. Lists 4 structured skills: get_services, get_pricing, get_contact, and request_consultation. Each includes an input schema and SHA-256 integrity hash.

Agent Skills RFC v0.2application/json
↗ View Live

GET/.well-known/mcp/server-card.json

MCP Server Card (SEP-1649). Describes BRX as an MCP-compatible service with resource listings. Used by MCP clients to understand available capabilities.

SEP-1649application/json
↗ View Live

Content & LLM Endpoints

GET/llms.txt

LLMs.txt (llmstxt.org standard). Plain-text summary of BRX for LLM ingestion — company info, services, pricing, contact, and key page links in a structured, token-efficient format.

llmstxt.orgtext/plain
↗ View Live

GET/openapi.json

OpenAPI 3.1 specification describing all public BRX endpoints with schemas, descriptions, and response formats. Use for code generation, Postman imports, or agent integration.

OpenAPI 3.1application/json
↗ View Live

GET/ (with Accept: text/markdown)

Markdown content negotiation. Send Accept: text/markdown to receive the homepage as clean Markdown — ideal for LLM context injection without HTML parsing overhead.

Cloudflare Markdown for Agentstext/markdown
curl -H "Accept: text/markdown" https://brx.sa/

WebMCP Browser Tools

navigator.modelContext — 5 registered tools

BRX registers 5 in-browser agent tools via the WebMCP API (navigator.modelContext.provideContext()):

brx_get_services brx_get_pricing brx_get_contact brx_request_consultation brx_navigate

See agent-skills/index.json for full schemas.

Security & Trust

GET/.well-known/security.txt

Security disclosure file (RFC 9116). Contact info for responsible security disclosure, expiry date, and canonical URL.

RFC 9116text/plain
↗ View Live

Response Headers (All Pages)

Link Headers (RFC 8288)

Every response from brx.sa includes Link: headers for agent discovery:

Link: </.well-known/api-catalog>; rel="api-catalog"
Link: </.well-known/agent-skills/index.json>; rel="agent-skills"
Link: </.well-known/mcp/server-card.json>; rel="mcp-server-card"
Link: </llms.txt>; rel="describedby"; type="text/plain"
Link: </openapi.json>; rel="service-desc"; type="application/json"
Vary: Accept
↓ Download OpenAPI 3.1 Spec    Contact Us