Eloquent Surfaces

A self-referential site built with eloquentsurfaces. The surface catalog below is both the site's content and its queryable backend.

Switch to agent view

Discovery Endpoints

Surface Catalog

11 surfaces registered across 5 standard, 6 emerging, and 0 speculative.

pattern_id	category	description	user_types	artifacts
`robots_txt`	standard	robots.txt with AI bot directives and Content Signals for crawl control	coding_agent, browser_agent	`GET /robots.txt`
`sitemap_xml`	standard	XML sitemap with canonical URLs for search engines and discovery agents	coding_agent, browser_agent	`GET /sitemap.xml`
`oauth_discovery`	emerging	OAuth protected resource metadata (RFC 9728) and OIDC discovery (RFC 8414)	coding_agent	`GET /.well-known/oauth-protected-resource`, `GET /.well-known/openid-configuration`
`api_catalog`	emerging	RFC 9727 API catalog for automated API discovery via linkset format	coding_agent	`GET /.well-known/api-catalog`
`mcp_server_card`	emerging	MCP Server Card (SEP-1649) for Model Context Protocol server discovery	coding_agent	`GET /.well-known/mcp/server-card.json`
`a2a_agent_card`	emerging	A2A agent card at /.well-known/agent.json (and agent-card.json alias)	coding_agent	`GET /.well-known/agent.json`, `GET /.well-known/agent-card.json`
`llms_txt`	emerging	LLM-optimized documentation at /llms.txt generated from the surface registry	coding_agent, browser_agent	`GET /llms.txt`
`link_headers`	emerging	RFC 8288 Link headers on the homepage for agent resource discovery	coding_agent, browser_agent	`Link header on GET /`
`agent_homepage`	standard	Agent-focused homepage listing discovery endpoints, tools, and registered surfaces	coding_agent	`GET /`
`human_homepage`	standard	Human-readable homepage with styled layout, discovery links, and surface overview	human	`GET /?view=human`
`site_tool_invocation`	standard	HTTP endpoints for querying the surface catalog programmatically	coding_agent	`POST /api/tools/list_surfaces`, `POST /api/tools/get_surface`

Agent Tools

Two tools are available for programmatic catalog queries. Both accept JSON bodies and return JSON.

`POST /api/tools/list_surfaces`

List all surfaces, optionally filtered by category.

curl -s -X POST https://surfaces.eloquentanalytics.com/api/tools/list_surfaces | jq .

# Filter by category:
curl -s -X POST https://surfaces.eloquentanalytics.com/api/tools/list_surfaces \
  -H 'content-type: application/json' \
  -d '{"category":"standard"}' | jq .

`POST /api/tools/get_surface`

Get detailed metadata for a single surface.

curl -s -X POST https://surfaces.eloquentanalytics.com/api/tools/get_surface \
  -H 'content-type: application/json' \
  -d '{"pattern_id":"robots_txt"}' | jq .