Flare Builders developer resources

This page lists the public, machine-readable interfaces for Flare Builders so developers and AI agents can discover the Flare and Songbird directory without scraping HTML. No API key is required for these read-only resources. Flare Builders does not currently offer OAuth, webhooks, or authenticated write APIs.

Start with the OpenAPI description at /openapi.json for HTTP JSON feeds (directory listings, ticker, TVL, rich-list lookup, FTSO epoch, and reliability scores). Listing records are also published as /listings.json. Site guidance for language models is at /llms.txt and /llms-full.txt.

The same URLs that serve HTML to browsers can serve Markdown to agents: send Accept: text/markdown (see acceptmarkdown.com). Responses include Vary: Accept so caches keep HTML and Markdown variants separate. Missing paths return HTTP 404 with a short Markdown map of where to go next.

Agents that speak Model Context Protocol can call the Flare Builders MCP server over Streamable HTTP at /mcp. Discovery metadata lives at /.well-known/mcp. Tools expose directory search and documentation URLs. For human-readable context see /about, /contact, and /privacy.