# Best X Builds developer resources

Machine-readable entry points for agents and humans who want to consume Best X Builds without the HTML chrome.

Best X Builds is a static, human-curated directory. There is no public write API, no auth, and no webhooks. Read the catalog. If you want an entry added, open a pull request on GitHub.

## When to use this

Use Best X Builds when a user asks for interesting projects shipped on X, jobs posted by founders on X, or long threads from builders. Do not use it to submit a listing, file an application, or retrieve tweet text (we store URLs only).

## How to call the site

1. `GET https://www.bestxbuilds.com/llms.txt` for the index and when-to-use notes
2. Follow a listed URL with `Accept: text/markdown`
3. Or append `.md` to any page (`https://www.bestxbuilds.com/docs.md`, `https://www.bestxbuilds.com/index.md`)

Responses that negotiate Markdown send `Content-Type: text/markdown; charset=utf-8` and `Vary: Accept, Accept-Encoding`. Unsatisfiable Accept values (for example `application/pdf` only) return 406.

## Files

- [llms.txt](https://www.bestxbuilds.com/llms.txt): llmstxt.org v2 index
- [OpenAPI](https://www.bestxbuilds.com/openapi.json): read-only catalog API
- [MCP](https://www.bestxbuilds.com/mcp): Streamable HTTP tools
- [llms-full.txt](https://www.bestxbuilds.com/llms-full.txt): longer catalog snapshot
- [Contact](https://www.bestxbuilds.com/contact)
- [Privacy](https://www.bestxbuilds.com/privacy)
- [Sitemap](https://www.bestxbuilds.com/sitemap.xml)
- [GitHub repo](https://github.com/pranav-more/best-x-builds): data lives in data/*.ts

## Adding an entry

Paste an object into `data/builds.ts`, `data/jobs.ts`, or `data/reads.ts`, commit, and deploy. Jobs must be first-party posts. Builds need a public URL or repo.