setya.id
For Developers and AI Agents
Public, read-only endpoints so apps and AI agents can search, read and use the setya.id calculators. No authentication.
Every Page as Markdown
Add .md to any page URL (home page: /index.md), or request the normal URL with an Accept: text/markdown header.
Search Index
GET /search.json returns every note, template, tool, topic and glossary term. The schema is in /openapi.json.
MCP Server
Endpoint https://setya.id/mcp (Streamable HTTP, JSON-RPC, read-only). Tools:
search_site: Search notes, templates, tools, topics and glossary terms on setya.id (IT management, infrastructure, ITSM). Returns titles, summaries and URLs, including a Markdown URL for each page.ipv4_subnet: Network, broadcast, host range, usable host count, netmask and wildcard for an IPv4 address and prefix.sla_downtime: Allowed downtime per day, week, month, quarter and year for an availability percentage such as 99.9.raid_capacity: Usable capacity, efficiency and fault tolerance for RAID 0, 1, 5, 6 or 10.transfer_time: How long it takes to copy a given amount of data over a link of a given speed.
curl -s https://setya.id/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"sla_downtime","arguments":{"availability":99.9}}}' Discovery
- API catalog (RFC 9727)
/.well-known/api-catalog - OpenAPI 3.1
/openapi.json - MCP server card
/.well-known/mcp/server-card.json - Agent Skills index
/.well-known/agent-skills/index.json - AI catalog (ARD)
/.well-known/ai-catalog.json - Status
/status.json - Sitemap
/sitemap-index.xml
Use
Content may be used for search, AI answers and model training (see Content-Signal in robots.txt). Please link to the source page.
Problems? Email setyadn@gmail.com.