Duyet Developer Resources
Everything on duyet.net is readable by machines, not just people. This page collects what's available for developers and AI agents: a public stats API, an MCP server your assistant can connect to, and machine-readable indexes that describe the rest of the site.
Stats & metrics API
The public API serves site metrics and insights. It is available at https://api.duyet.net (primary), with a same-origin mirror at https://duyet.net/api. All GET endpoints below are public and need no authentication.
| Method | Endpoint | Description |
|---|---|---|
| GET | /health | Service health check. |
| GET | /api/ai/percentage/current | How much of duyet.net is AI-written, right now. |
| GET | /api/ai/percentage/history?days=N | AI-percentage time series for the last N days. |
| GET | /api/ai/percentage/available | Days with AI-percentage data available. |
| GET | /api/insights/overview | Aggregated development insights from this site. |
| POST | /api/llm/generate | LLM generation (card descriptions). Requires a bearer token. |
Public GET endpoints need no auth. POST /api/llm/generate uses Authorization: Bearer <token> — request access by email me@duyet.net. OAuth scopes read:profile and chat are declared in /.well-known/oauth-protected-resource.
Responses carry RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers. Exceeding the limit returns 429 with a Retry-After header — back off and retry after that many seconds.
Connect AI assistants
The MCP server exposes Duyet's CV, blog posts, GitHub activity, and contact tools over Streamable HTTP. Point any MCP-compatible client (Claude, Cursor, and others) at https://mcp.duyet.net/mcp:
claude mcp add --transport http duyet https://mcp.duyet.net/mcpMachine-readable files
- /openapi.jsonOpenAPI 3.1 spec for the public API.
- /llms.txtLLM-friendly index of the whole site.
- /sitemap.xmlEvery indexable page.
- /.well-known/api-catalogLink-set catalog of available APIs.
- /.well-known/oauth-protected-resourceOAuth protected-resource metadata.
- /.well-known/mcp/server-card.jsonMCP server card.
Try it in 30 seconds
curl https://api.duyet.net/healthcurl https://api.duyet.net/api/ai/percentage/currentcurl https://api.duyet.net/api/insights/overview