{
  "name": "unulu",
  "version": "1.0.0",
  "description": "AI agent website builder, starting with link-in-bio sites. Create and publish via MCP server or REST API.",
  "homepage": "https://unulu.ai",
  "transport": {
    "type": "streamable-http",
    "url": "https://mcp.unulu.ai"
  },
  "tools": [
    {
      "name": "unulu_create_site",
      "title": "Create a link-in-bio site",
      "description": "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.",
      "inputSchema": {
        "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"
        ]
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "site_id",
          "url",
          "expires_at",
          "assistant_message"
        ],
        "properties": {
          "site_id": {
            "type": "string",
            "description": "Unique site identifier"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Live URL on unu.lu — always present as a clickable markdown link when showing to the user"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "description": "ISO 8601 expiry timestamp (~1 hour from creation)"
          },
          "assistant_message": {
            "type": "string",
            "description": "Pre-formatted message with the live site link, expiry notice, and short-code claim instructions. Share with the user as-is — do not paraphrase or restructure."
          },
          "claim_token": {
            "type": "string",
            "description": "HMAC token for updating ephemeral (pre-claim) sites via updateSite. Present when the site is unclaimed."
          },
          "claim_code_short": {
            "type": "string",
            "description": "Backup code (XXXX-XXXX) for claiming the site via the short-code flow"
          }
        }
      },
      "annotations": {
        "readOnlyHint": false,
        "openWorldHint": true,
        "destructiveHint": false
      },
      "_meta": {
        "ui": {
          "resourceUri": "ui://unulu/widget.html",
          "csp": {
            "resourceDomains": [
              "https://fonts.googleapis.com",
              "https://fonts.gstatic.com"
            ]
          }
        },
        "openai/outputTemplate": "ui://unulu/widget.html",
        "openai/widgetCSP": {
          "resourceDomains": [
            "https://fonts.googleapis.com",
            "https://fonts.gstatic.com"
          ]
        }
      }
    },
    {
      "name": "unulu_get_state",
      "title": "Get site state",
      "description": "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).",
      "inputSchema": {
        "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"
        ]
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "site_id",
          "url",
          "name",
          "links"
        ],
        "properties": {
          "site_id": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "bio": {
            "type": "string"
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "subtitle": {
                  "type": "string"
                },
                "leading_icon": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "const": "emoji"
                        },
                        "value": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "value"
                      ]
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "const": "image"
                        },
                        "value": {
                          "type": "string",
                          "format": "uri"
                        }
                      },
                      "required": [
                        "kind",
                        "value"
                      ]
                    }
                  ]
                },
                "trailing_badge": {
                  "type": "string"
                }
              }
            }
          },
          "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"
            ]
          }
        }
      },
      "annotations": {
        "readOnlyHint": true,
        "openWorldHint": false,
        "destructiveHint": false
      },
      "_meta": {
        "ui": {
          "resourceUri": "ui://unulu/widget.html",
          "csp": {
            "resourceDomains": [
              "https://fonts.googleapis.com",
              "https://fonts.gstatic.com"
            ]
          }
        },
        "openai/outputTemplate": "ui://unulu/widget.html",
        "openai/widgetCSP": {
          "resourceDomains": [
            "https://fonts.googleapis.com",
            "https://fonts.gstatic.com"
          ]
        }
      }
    },
    {
      "name": "unulu_update_site",
      "title": "Update a site",
      "description": "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).",
      "inputSchema": {
        "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"
        ]
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "site_id",
          "url",
          "name",
          "links"
        ],
        "properties": {
          "site_id": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "bio": {
            "type": "string"
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "subtitle": {
                  "type": "string"
                },
                "leading_icon": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "const": "emoji"
                        },
                        "value": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "value"
                      ]
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "const": "image"
                        },
                        "value": {
                          "type": "string",
                          "format": "uri"
                        }
                      },
                      "required": [
                        "kind",
                        "value"
                      ]
                    }
                  ]
                },
                "trailing_badge": {
                  "type": "string"
                }
              }
            }
          },
          "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"
            ]
          }
        }
      },
      "annotations": {
        "readOnlyHint": false,
        "openWorldHint": true,
        "destructiveHint": true
      },
      "_meta": {
        "ui": {
          "resourceUri": "ui://unulu/widget.html",
          "csp": {
            "resourceDomains": [
              "https://fonts.googleapis.com",
              "https://fonts.gstatic.com"
            ]
          }
        },
        "openai/outputTemplate": "ui://unulu/widget.html",
        "openai/widgetCSP": {
          "resourceDomains": [
            "https://fonts.googleapis.com",
            "https://fonts.gstatic.com"
          ]
        }
      }
    },
    {
      "name": "unulu_check_handle",
      "title": "Check handle availability",
      "description": "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.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "description": "The handle to check (3-30 chars, alphanumeric + hyphens)"
          }
        },
        "required": [
          "handle"
        ]
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "available",
          "handle"
        ],
        "properties": {
          "available": {
            "type": "boolean"
          },
          "handle": {
            "type": "string"
          }
        }
      },
      "annotations": {
        "readOnlyHint": true,
        "openWorldHint": false,
        "destructiveHint": false
      }
    }
  ],
  "links": {
    "openapi": "https://unulu.ai/openapi.json",
    "github": "https://github.com/unulu-ai",
    "documentation": "https://unulu.ai/llms.txt",
    "acceptableUse": "https://unulu.ai/acceptable-use"
  }
}