ai.unulu/unulu

Official4 tools

by unulu-ai

unulu

AI agent website builder. Create and publish link-in-bio sites via MCP or REST API.

Create and publish link-in-bio websites for AI agents via MCP or REST API.

Captured live from the server via tools/list.

unulu_create_site

Create a link-in-bio site with a name, bio, and links. Returns a live URL on unu.lu that expires in 1 hour unless claimed. Do NOT call until you have at least a name and one link from the user — gather real content first, never create with placeholder or empty content. If the user provides a handle (e.g. '_guy.a' for Instagram), construct the full URL yourself — do not ask them to paste it. When feasible, offer to find all public links for the person. Before calling: tell the user they can choose a skin on the preview page for the overall aesthetic; ask permission before adding emoji leading_icons to decorate links (for not-well-known social URLs). The response includes an assistant_message with the site URL and claim details — present these to the user. Persist claim_token and claim_code_short for subsequent updates — never ask the user for them back in the same conversation. Never create a duplicate site; always update the existing one. After creation: tell the user they can pick a custom handle when they claim; share the preview URL in a copy-paste block; offer to refine bio, links, or ordering. Keep iteration fast — apply changes immediately, don't re-confirm minor edits.

Parameters (4)

namestringrequired
Display name / heading for the site
biostring
Short bio in first person, 1–3 sentences, capturing what's distinctive — no filler phrases like 'passionate about' or 'dedicated to'. If you lack context, write something short and honest rather than generic. Supports markdown.
linksarray
Link-in-bio links. Order matters — place the most important link first. Well-known social links display branded icons automatically — omit leading_icon for these.
skin_idstring
Optional theme skin. When omitted, the live site includes a visual theme chooser — prefer omitting so the user can pick their own.

unulu_get_state

Returns the current state of a site including its name, bio, links, and URL. No authentication required. If expires_at is absent, the site has been claimed and is permanent. Accepts a site ID, a full URL (e.g. https://abc123.unu.lu), or a bare hostname (e.g. abc123.unu.lu).

Parameters (1)

site_idstringrequired
Site ID, full URL (e.g. https://abc123.unu.lu), or bare hostname (e.g. abc123.unu.lu)

unulu_update_site

Update an existing site. All fields are optional — only provided fields are changed. Links replace the entire array (omit to keep existing). Before updating, always call unulu_get_state first to read the current links and their ids — do not guess link ids. Authorization depends on site lifecycle: X-Claim-Token header for ephemeral (pre-claim) sites, X-Edit-Token header for claimed (post-claim) sites. If neither token is available and the site is claimed, use requestEditAccess to obtain an edit_token. If you created the site in this conversation, you already have the claim_token — use it directly. Returns the full updated site state. Keep iteration fast — apply changes immediately without re-confirming minor edits unless ambiguous. Accepts a site ID, a full URL (e.g. https://abc123.unu.lu), or a bare hostname (e.g. abc123.unu.lu).

Parameters (8)

site_idstringrequired
Site ID, full URL (e.g. https://abc123.unu.lu), or bare hostname (e.g. abc123.unu.lu)
claim_tokenstring
HMAC token for ephemeral sites (alternative to X-Claim-Token header)
claim_urlstring
Legacy parameter — accepts a full Claim URL from older create-site responses. The server extracts the claim_token automatically. Prefer claim_token directly.
edit_tokenstring
JWT token for claimed sites (alternative to X-Edit-Token header)
namestring
Display name / heading for the site
biostring
Short bio in first person, 1–3 sentences, capturing what's distinctive — no filler phrases like 'passionate about' or 'dedicated to'. If you lack context, write something short and honest rather than generic. Supports markdown.
linksarray
Replaces all links — omit to keep existing links unchanged. Order matters — place the most important link first. Well-known social links display branded icons automatically — omit leading_icon for these.
skin_idstring
Optional theme skin. When omitted, the live site includes a visual theme chooser — prefer omitting so the user can pick their own.

unulu_check_handle

Check whether a handle is available on unu.lu (not other platforms like Instagram, TikTok, etc.). For example, checking 'joe' tells you if joe.unu.lu is available for claiming. Use this to help users choose a handle before they visit the claim page.

Parameters (1)

handlestringrequired
The handle to check (3-30 chars, alphanumeric + hyphens)

README.md3 KBView on GitHub

unulu

AI agent website builder, starting with link-in-bio sites. Create and publish via MCP server or REST API.

v1.0 — Stable API.

What is unulu?

unulu is a website builder designed for AI agents. You describe a site in conversation with an AI assistant — Claude, ChatGPT, Gemini, Cursor, or any MCP-compatible tool — and it builds and publishes the site instantly.

Starting with link-in-bio sites: a single page with your name, bio, and links, live at yourhandle.unu.lu. No signup, no templates, no manual work.

What AI agents can do

Create a link-in-bio site with a name, bio, links, and theme
Read the current state of any site
Update content — display name, bio, links, theme, link badges
Check handle availability before claiming
17 built-in themes including minimal, gradient, brutalist, glass, and more

Sites are published instantly and expire after 1 hour unless claimed with an email address.

Quick start (MCP)

Add unulu to your MCP client config:

json

{
  "mcpServers": {
    "unulu": {
      "type": "streamable-http",
      "url": "https://mcp.unulu.ai"
    }
  }
}

No authentication required. Then ask your AI agent: "Build a link-in-bio site for me on unulu."

REST API

Base URL: https://api.unulu.ai

Method	Path	Description
POST	`/api/sites`	Create a link-in-bio site
GET	`/api/sites/{site_id}`	Get site state
PATCH	`/api/sites/{site_id}`	Update a site
GET	`/api/claims/check-handle`	Check handle availability

No authentication required. Rate limited. Full spec: openapi.json

Example

See a live site at unulu.unu.lu.

Docs

API & MCP docs — human-readable documentation
llms.txt — agent-friendly docs
OpenAPI spec — REST API reference
MCP discovery — MCP server metadata
Website

Platform guides

Step-by-step setup for each AI platform:

Claude · ChatGPT · Gemini · Cursor · Copilot · Grok · Windsurf · Other

Roadmap

See open issues labeled enhancement for planned features. Suggestions welcome — open an issue.

Idempotency keys
Typed TypeScript client
Portfolios and personal sites
Custom domain support

Install

claude_desktop_config.json

{
  "mcpServers": {
    "unulu": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.unulu.ai"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.