sitey.one

Free subdomain service for developers. Get a subdomain in seconds — no credit card, no hassle.

Features

• Instant DNS — A, CNAME, and TXT records, live in seconds
• Google sign-in — No passwords to manage
• REST API — Programmatic access via /api/v1/
• Auto-cleanup — Unreachable subdomains are removed after two warnings
• Free — No cost, no catch

Quick Start

1. Visit sitey.one
2. Sign in with Google
3. Type a subdomain + IP address → done

REST API

Programmatic access for developers and AI agents.

Base URL: https://sitey.one/api/v1

Authentication

Mode	Auth	Limit
Anonymous	None (IP-based)	3 subdomains
API key	Authorization: Bearer styo_xxx	Unlimited

Get an API key: sign in at sitey.one → Dashboard → API Keys.

Endpoints

Method	Path	Description
GET	/domains	List available root domains
GET	/check/:subdomain/:domain	Check availability
POST	/subdomains	Create A or CNAME record
GET	/subdomains	List your subdomains
PATCH	/subdomains/:sub/:domain	Update record value
DELETE	/subdomains/:sub/:domain	Delete subdomain
POST	/subdomains/:sub/:domain/txt	Create/update TXT record
DELETE	/subdomains/:sub/:domain/txt/:prefix	Delete TXT record

Example

# Check availability
curl https://sitey.one/api/v1/check/demo/sitey.one

# Create subdomain
curl -X POST https://sitey.one/api/v1/subdomains \
  -H "Content-Type: application/json" \
  -d '{"subdomain":"demo","domain":"sitey.one","type":"A","value":"1.2.3.4"}'

For AI Agents (MCP)

AI agents can use free-domain-mcp — an MCP server that wraps this REST API.

claude mcp add --transport http sitey https://your-mcp-server/mcp

Tech Stack

• Runtime: Node.js + Fastify
• DNS: Self-hosted BIND9 (authoritative nameserver)
• Database: MySQL
• Auth: Google OAuth2 + JWT

How It Works

1. User (or API call) requests a subdomain
2. Server validates input + checks availability
3. A/CNAME/TXT record is appended to the BIND9 zone file
4. named-checkzone validates → systemctl reload named applies
5. DNS is live within seconds

We run our own authoritative nameservers (ns1.sitey.one, ns2.sitey.one) — no third-party DNS provider.

Use Cases

• Deploy a side project to myapp.sitey.one
• Give hackathon demos a real URL
• Automate domain setup via REST API or MCP
• Share staging environments with teammates

Support

• ☕ Buy me a coffee
• 💬 Telegram community

License

ISC