Eloquent Surfaces
This is the eloquentsurfaces catalog site — a self-referential deployment where the surface catalog is both the content and the queryable backend. 11 surfaces are registered and 2 tool(s) are available for programmatic queries.
Switch to human-readable view
Discovery Endpoints
GET https://surfaces.eloquentanalytics.com/robots.txt — Robots exclusion protocol
GET https://surfaces.eloquentanalytics.com/sitemap.xml — XML sitemap
GET https://surfaces.eloquentanalytics.com/.well-known/agent.json — A2A agent card
GET https://surfaces.eloquentanalytics.com/.well-known/mcp.json — MCP server card
GET https://surfaces.eloquentanalytics.com/api/surfaces — Surface catalog (JSON)
GET https://surfaces.eloquentanalytics.com/api/openapi — OpenAPI specification
GET https://surfaces.eloquentanalytics.com/llms.txt — LLM-readable description
Tool Invocation
Tools accept JSON POST bodies and return JSON. Use these to query the catalog programmatically.
### list_surfaces
List all registered interaction surfaces. Optionally filter by category.
```
POST https://surfaces.eloquentanalytics.com/api/tools/list_surfaces
Content-Type: application/json
{
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"standard",
"emerging",
"speculative"
],
"description": "Filter surfaces by category."
}
}
}
```
### get_surface
Get detailed metadata for a single surface by its pattern_id.
```
POST https://surfaces.eloquentanalytics.com/api/tools/get_surface
Content-Type: application/json
{
"type": "object",
"properties": {
"pattern_id": {
"type": "string",
"description": "The pattern_id of the surface to retrieve."
}
},
"required": [
"pattern_id"
]
}
```
Registered Surfaces (11)
- **robots_txt** (standard) — robots.txt with AI bot directives and Content Signals for crawl control
Artifacts: GET /robots.txt
- **sitemap_xml** (standard) — XML sitemap with canonical URLs for search engines and discovery agents
Artifacts: GET /sitemap.xml
- **oauth_discovery** (emerging) — OAuth protected resource metadata (RFC 9728) and OIDC discovery (RFC 8414)
Artifacts: 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
Artifacts: GET /.well-known/api-catalog
- **mcp_server_card** (emerging) — MCP Server Card (SEP-1649) for Model Context Protocol server discovery
Artifacts: GET /.well-known/mcp/server-card.json
- **a2a_agent_card** (emerging) — A2A agent card at /.well-known/agent.json (and agent-card.json alias)
Artifacts: 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
Artifacts: GET /llms.txt
- **link_headers** (emerging) — RFC 8288 Link headers on the homepage for agent resource discovery
Artifacts: Link header on GET /
- **agent_homepage** (standard) — Agent-focused homepage listing discovery endpoints, tools, and registered surfaces
Artifacts: GET /
- **human_homepage** (standard) — Human-readable homepage with styled layout, discovery links, and surface overview
Artifacts: GET /?view=human
- **site_tool_invocation** (standard) — HTTP endpoints for querying the surface catalog programmatically
Artifacts: POST /api/tools/list_surfaces, POST /api/tools/get_surface