gildrb.com developer resources

Everything on gildrb.com is built to be readable by agents as well as humans. There is no API key, sandbox, or registration: all surfaces are public and read-only, and no Authorization header is required (see auth.md).

REST API (v1)

• GET https://gildrb.com/api/v1/profile - canonical JSON-LD identity and portfolio graph (alias: /api/profile)
• GET https://gildrb.com/api/v1/status - liveness probe (alias: /api/status)
• GET https://gildrb.com/api/v1 - machine-readable index of every endpoint
• Errors use RFC 9457 application/problem+json with a stable title and a detail resolution hint.
• Rate limits are 60 requests per 60 seconds, advertised via RateLimit-Limit and RateLimit-Policy headers; a 429 also carries Retry-After.

OpenAPI

Machine-readable OpenAPI 3.1 description: openapi.json. Human-readable docs: api-docs.md. API catalog (linkset): /.well-known/api-catalog.

MCP server

A stateless MCP Streamable HTTP server is available at POST https://gildrb.com/mcp with two read-only tools: list_portfolio_pages and get_portfolio_page. Connection metadata: /.well-known/mcp (manifest) or /.well-known/mcp/server-card.json (server card).

Agent discovery

• llms.txt - canonical LLM reference with when-to-use guidance
• llms-full.txt - the complete public site text in one request
• sitemap.xml and robots.txt - crawl policy (all search and AI crawlers allowed)
• Every HTML page negotiates Markdown via Accept: text/markdown
• ai-catalog.json and agent-skills - structured agent discovery

Site source

The entire site, including these endpoints' source, is open at github.com/gildrb/web. There is no CLI tool; script interactions should use the REST API or MCP server above.

Home · About · Contact · Privacy