# sitey.my

> Free subdomains with the DNS behind them: claim a name, point it at an address with an A or CNAME record, and add the TXT record a host asks for. Over REST or MCP, with or without an account.

No account is needed to create one. A caller with no API key is identified by its
IP address and owns what that address created; an API key from the dashboard puts the
records under an account instead.

The name comes first: a record whose target is not serving yet is created all the same,
with `reachable: false` in the response saying so. Claim the address, then deploy to it.

## Calling it

- [OpenAPI 3.1 spec](https://sitey.my/openapi.json): every REST operation, every error code.
- [MCP endpoint](https://sitey.my/mcp): Streamable HTTP, stateless — one POST per JSON-RPC
  message. Nine tools, the same nine operations as the REST API.
- [MCP manifest](https://sitey.my/.well-known/mcp.json): what to hand an agent runtime.

Claiming a name is one request:

```
curl -X POST https://sitey.my/api/v1/subdomains \
  -H 'content-type: application/json' \
  -d '{"subdomain":"demo","domain":"sitey.my","type":"A","value":"203.0.113.10"}'
```

The roots you may create under are sitey.my, officials.my, officials.one, sitey.one. Ask https://sitey.my/api/v1/domains
rather than copying that list: which roots are on offer is a table, not a constant.

## Limits

- An account may hold 5 subdomains and is refused the next one.
- A caller with no API key is identified by its IP address and owns what that address created; there the 5 is enforced.
- A name is lent, not given: 3 months for a record owned by an account, 1 month for one created without one. Every response carries expires_at, and renewal opens 14 days before it.
- Nothing is removed on that date yet — deletion is switched off — but the date is real and renewing already works.
- Nothing can be bought while the payment route is off: a caller who is refused is refused, not offered a price.

## Pages

- [Docs](https://sitey.my/docs): the same ground for a person, with the Vercel setup written out.
- [Blog](https://sitey.my/blog): notes on running the service.