unulu

Official4 toolsLive

by unulu-ai

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

AI Unulu Unulu MCP Server (ai.unulu/unulu)

The ai.unulu/unulu MCP server provides an AI agent website builder that creates and publishes link-in-bio sites. Developers can generate site content by describing a desired website in conversation with an AI assistant, then build and publish it via the MCP server or a REST API. It supports a stable v1.0 API.

🛠️ Key Features

AI agent website builder for link-in-bio sites
Create and publish via MCP or REST API
Stable API (v1.0)
Tool count: 4

🚀 Use Cases

Building link-in-bio sites for AI agents
Using an MCP-compatible tool to generate and publish pages

⚡ Developer Benefits

Integrates with “any MCP-compatible tool” and common AI assistants
Supports REST API access in addition to MCP

⚠️ Limitations

Documentation excerpt only specifies starting with link-in-bio sites; broader site types are not described

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.

Parameters4

name	string	required	Display name / heading for the site
bio	string	optional	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.
links	array	optional	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_id	string	optional	Optional theme skin. When omitted, the live site includes a visual theme chooser — prefer omitting so the user can pick their own.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200,
      "description": "Display name / heading for the site"
    },
    "bio": {
      "type": "string",
      "maxLength": 5000,
      "description": "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."
    },
    "links": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "required": [
          "title",
          "url"
        ],
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 200,
            "description": "Link label"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Link URL (http or https; https recommended)"
          },
          "subtitle": {
            "type": "string",
            "maxLength": 200,
            "description": "Optional subtitle (supports markdown)"
          },
          "leading_icon": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "emoji",
                  "image"
                ],
                "description": "Icon type"
              },
              "value": {
                "type": "string",
                "description": "Emoji character(s) or image URL"
              },
              "url": {
                "type": "string",
                "description": "Alias for value — accepted for convenience when round-tripping get_state output. Prefer value for new input."
              }
            },
            "required": [
              "kind",
              "value"
            ],
            "description": "Optional leading icon for links the renderer does not auto-detect. Well-known social links (GitHub, Twitter/X, LinkedIn, etc.) always display branded icons regardless of this field. Provide kind + value."
          },
          "trailing_badge": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional trailing badge text for emphasis or highlights (e.g. 'New', 'Preferred', 'DMs open'). Use to draw attention to important links or flag contact preferences."
          }
        }
      },
      "description": "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_id": {
      "type": "string",
      "enum": [
        "editorial-minimal",
        "midnight-gradient",
        "soft-pastel-craft",
        "neo-brutal-poster",
        "liquid-glass",
        "carbon-folio",
        "concrete-grid",
        "signal-noir",
        "studio-warm",
        "sunset-decks",
        "electric-sermon",
        "hot-press",
        "chrome-vogue",
        "tidal-shelf",
        "dune-light",
        "moss-veil",
        "golden-hour"
      ],
      "description": "Optional theme skin. When omitted, the live site includes a visual theme chooser — prefer omitting so the user can pick their own."
    }
  },
  "required": [
    "name"
  ]
}

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).

Parameters1

site_id

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "site_id": {
      "type": "string",
      "description": "Site ID, full URL (e.g. https://abc123.unu.lu), or bare hostname (e.g. abc123.unu.lu)"
    }
  },
  "required": [
    "site_id"
  ]
}

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).

Parameters8

site_id	string	required	Site ID, full URL (e.g. https://abc123.unu.lu), or bare hostname (e.g. abc123.unu.lu)
claim_token	string	optional	HMAC token for ephemeral sites (alternative to X-Claim-Token header)
claim_url	string	optional	Legacy parameter — accepts a full Claim URL from older create-site responses. The server extracts the claim_token automatically. Prefer claim_token directly.
edit_token	string	optional	JWT token for claimed sites (alternative to X-Edit-Token header)
name	string	optional	Display name / heading for the site
bio	string	optional	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.
links	array	optional	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_id	string	optional	Optional theme skin. When omitted, the live site includes a visual theme chooser — prefer omitting so the user can pick their own.

Raw schema

{
  "type": "object",
  "properties": {
    "site_id": {
      "type": "string",
      "description": "Site ID, full URL (e.g. https://abc123.unu.lu), or bare hostname (e.g. abc123.unu.lu)"
    },
    "claim_token": {
      "type": "string",
      "description": "HMAC token for ephemeral sites (alternative to X-Claim-Token header)"
    },
    "claim_url": {
      "type": "string",
      "description": "Legacy parameter — accepts a full Claim URL from older create-site responses. The server extracts the claim_token automatically. Prefer claim_token directly."
    },
    "edit_token": {
      "type": "string",
      "description": "JWT token for claimed sites (alternative to X-Edit-Token header)"
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "description": "Display name / heading for the site"
    },
    "bio": {
      "type": "string",
      "maxLength": 5000,
      "description": "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."
    },
    "links": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "required": [
          "title",
          "url"
        ],
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 200,
            "description": "Link label"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Link URL (http or https; https recommended)"
          },
          "subtitle": {
            "type": "string",
            "maxLength": 200,
            "description": "Optional subtitle (supports markdown)"
          },
          "leading_icon": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "emoji",
                  "image"
                ],
                "description": "Icon type"
              },
              "value": {
                "type": "string",
                "description": "Emoji character(s) or image URL"
              },
              "url": {
                "type": "string",
                "description": "Alias for value — accepted for convenience when round-tripping get_state output. Prefer value for new input."
              }
            },
            "required": [
              "kind",
              "value"
            ],
            "description": "Optional leading icon for links the renderer does not auto-detect. Well-known social links (GitHub, Twitter/X, LinkedIn, etc.) always display branded icons regardless of this field. Provide kind + value."
          },
          "trailing_badge": {
            "type": "string",
            "maxLength": 50,
            "description": "Optional trailing badge text for emphasis or highlights (e.g. 'New', 'Preferred', 'DMs open'). Use to draw attention to important links or flag contact preferences."
          }
        }
      },
      "description": "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_id": {
      "type": "string",
      "enum": [
        "editorial-minimal",
        "midnight-gradient",
        "soft-pastel-craft",
        "neo-brutal-poster",
        "liquid-glass",
        "carbon-folio",
        "concrete-grid",
        "signal-noir",
        "studio-warm",
        "sunset-decks",
        "electric-sermon",
        "hot-press",
        "chrome-vogue",
        "tidal-shelf",
        "dune-light",
        "moss-veil",
        "golden-hour"
      ],
      "description": "Optional theme skin. When omitted, the live site includes a visual theme chooser — prefer omitting so the user can pick their own."
    }
  },
  "required": [
    "site_id"
  ]
}

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.

Parameters1

handle

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "The handle to check (3-30 chars, alphanumeric + hyphens)"
    }
  },
  "required": [
    "handle"
  ]
}

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

Tools (4)

unulu_create_siteunulu_get_stateunulu_update_siteunulu_check_handle

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.unulu.ai

Add to VS Code Add to Cursor

claude_desktop_config.json

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.

AI Unulu Unulu MCP Server (ai.unulu/unulu)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

unulu_create_site

unulu_get_state

unulu_update_site

unulu_check_handle

unulu

What is unulu?

What AI agents can do

Quick start (MCP)

REST API

Example

Docs

Platform guides

Roadmap

Links

Install

Remote endpoint

Related servers