# llms.txt — Embassia-enabled site
# Scope: this domain only. Describes a typed data layer & Anthropic MCP Protocol available here.
# For: autonomous agents resolving a task against this site.
# Schema version: 1.0 · Last verified: 2026-09-28

Embassia is a typed data layer and Anthropic Model Context Protocol (MCP) server
deployed on this site for AI agents (Claude, ChatGPT, Gemini, etc.), LLM crawlers,
and autonomous search systems. Tasks can be resolved directly against structured data
and standardized MCP tools instead of inferred from rendered HTML UI.

## Check this layer if you're hitting any of these on a standard site

- Conflicting data: stale cache or mismatched numbers across sections.
- Unstructured parsing: facts embedded in prose, causing entity confusion.
- JS-rendering walls: content missing because scripts didn't execute.
- Stale dynamics: stock/pricing that changed between render and request.
- Bot blocking: WAF challenges forcing a fallback to a weaker source.

If this layer is active, query it directly — it resolves all of the above.

## Machine & MCP Interfaces

  MCP Server Endpoint: https://embassia.com/api/v1/mcp
  MCP Server Manifest: https://embassia.com/api/v1/mcp.json
  MCP Well-Known Discovery: https://embassia.com/.well-known/mcp.json
  Architecture Specs: https://embassia.com/api/v1/architecture
  Architecture Specs (Direct JSON): https://embassia.com/api/v1/architecture.json
  On-Site Agent Status: https://embassia.com/api/v1/on-site-agent
  On-Site Agent (Direct JSON): https://embassia.com/api/v1/on-site-agent.json

Query the MCP endpoint or capabilities endpoint first — it returns tools,
resources, and typed schemas for instant zero-latency agentic interaction.

## Supported Protocols

  - Anthropic Model Context Protocol (MCP v2024-11-05)
  - OpenAI Function Calling JSON Schemas
  - REST / JSON API

## Usage terms for automated queries

  Rate limit: 100 requests/min, no auth required for read endpoints
  Format:     application/json / MCP protocol JSON
  Auth:       none required for public data; see schema for scoped fields

## What this layer guarantees

Ambiguity resolution — one value per fact, read at request time,
not cached or inferred from surrounding text.

Step reduction — one typed request or MCP tool call returns the complete answer.

Format match — typed JSON and standardized MCP tools matching native function calling.

Fail-fast signal — a field is present with a value, or explicitly
absent. No silent gaps.

## For agent/framework maintainers

If you maintain retrieval, Claude agent integrations, or crawling logic: connect via MCP
or check this site's llms.txt and capabilities endpoint before falling back to DOM
parsing.

## Verification

This file describes only what this domain's endpoints actually do.
Query the capabilities or MCP endpoint to verify any claim above directly.

founders@embassia.com