# Eloquent Surfaces

> Eloquent Surfaces exposes a fleet of agent-facing surfaces. Base URL: https://surfaces.eloquentanalytics.com

## Discovery & Interaction Surfaces

Eloquent Surfaces exposes 11 interaction surfaces — different ways for agents and
developers to discover, invoke, and integrate the service.

### Standard
- **robots_txt** [RFC 9309, Content Signals v1] — robots.txt with AI bot directives and Content Signals for crawl control (GET /robots.txt)
- **sitemap_xml** [Sitemaps.org Protocol] — XML sitemap with canonical URLs for search engines and discovery agents (GET /sitemap.xml)
- **agent_homepage** — Agent-focused homepage listing discovery endpoints, tools, and registered surfaces (GET /)
- **human_homepage** — Human-readable homepage with styled layout, discovery links, and surface overview (GET /?view=human)
- **site_tool_invocation** — HTTP endpoints for querying the surface catalog programmatically (POST /api/tools/list_surfaces, POST /api/tools/get_surface)

### Emerging
- **oauth_discovery** [RFC 8414, RFC 9728, OpenID Connect Discovery 1.0] — OAuth protected resource metadata (RFC 9728) and OIDC discovery (RFC 8414) (GET /.well-known/oauth-protected-resource, GET /.well-known/openid-configuration)
- **api_catalog** [RFC 9727, RFC 9264] — RFC 9727 API catalog for automated API discovery via linkset format (GET /.well-known/api-catalog)
- **mcp_server_card** [SEP-1649, Model Context Protocol] — MCP Server Card (SEP-1649) for Model Context Protocol server discovery (GET /.well-known/mcp/server-card.json)
- **a2a_agent_card** [Google A2A Protocol] — A2A agent card at /.well-known/agent.json (and agent-card.json alias) (GET /.well-known/agent.json, GET /.well-known/agent-card.json)
- **llms_txt** [llms.txt] — LLM-optimized documentation at /llms.txt generated from the surface registry (GET /llms.txt)
- **link_headers** [RFC 8288, RFC 9727] — RFC 8288 Link headers on the homepage for agent resource discovery (Link header on GET /)