---
title: "For Developers and AI Agents | setya.id"
description: "Public, read-only endpoints so apps and AI agents can search, read and use the setya.id calculators. No authentication."
url: https://setya.id/developers
lang: en
---

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](https://setya.id/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)](https://setya.id/.well-known/api-catalog) `/.well-known/api-catalog`
- [OpenAPI 3.1](https://setya.id/openapi.json) `/openapi.json`
- [MCP server card](https://setya.id/.well-known/mcp/server-card.json) `/.well-known/mcp/server-card.json`
- [Agent Skills index](https://setya.id/.well-known/agent-skills/index.json) `/.well-known/agent-skills/index.json`
- [AI catalog (ARD)](https://setya.id/.well-known/ai-catalog.json) `/.well-known/ai-catalog.json`
- [Status](https://setya.id/status.json) `/status.json`
- [Sitemap](https://setya.id/sitemap-index.xml) `/sitemap-index.xml`

## Use

Content may be used for search, AI answers and model training (see `Content-Signal` in [robots.txt](https://setya.id/robots.txt)). Please link to the source page.

Problems? Email [setyadn@gmail.com](mailto:setyadn@gmail.com).
