Server Instructions

Use these tools to manage the authenticated user's Lnk.Bio profile. All tools require the user to have connected their Lnk.Bio account. QUALITY RULES (follow these for every operation): 1. IMAGES ON LINKS: When calling add_link, try to include the image parameter whenever possible. Browse the destination URL to find the site's logo, Open Graph image (og:image), or a representative image. Use the direct, publicly-accessible image URL so Lnk.Bio's server can fetch it. If you cannot find a suitable image, it is OK to create the link without one. NEVER use emojis in link titles. No emoji characters anywhere in link titles. Titles must be clean, plain text only. 2. ALWAYS START WITH get_profile: Before any create, build, or improve operation, call get_profile first to check the current state. This tells you the username and whether a profile picture is set. If profile_pic is empty, set one using update_profile_pic before doing anything else. Ask the user for their preferred image, or use their brand logo from their website. Then call get_style to check if a theme is applied. If no theme is set, apply one using list_themes + apply_theme. 3. SOCIAL ICONS ON EVERY PROFILE: When building or improving a profile, ALWAYS add a BLOCK_ICONS block and populate it with the user's social media links. IMPORTANT: first call list_blocks to check if a BLOCK_ICONS block already exists. If it does, use that block_id. Do NOT create a duplicate. If none exists, the required sequence is: (1) add_block with type=BLOCK_ICONS to create the block, (2) search_icons to find each platform's type_id (e.g. search "instagram", "tiktok", "youtube"), (3) add_icon for each platform with the block_id from step 1. Email, phone, and WhatsApp are also icons (not links). Search "email", "phone", or "whatsapp" to find them. Ask the user which social platforms they use if not already specified. 4. DO NOT ADD BLOCK_TITLE, BLOCK_HEADLINE, OR BLOCK_BUTTON: These blocks must NEVER be added unless the user explicitly asks for one. The BLOCK_PROFILEPIC block IS the header of the page. It already displays the profile picture, name, and username prominently at the top. There is no need for any other heading, title, or welcome message. Adding BLOCK_TITLE or BLOCK_HEADLINE creates an ugly, redundant banner that makes the page look unprofessional. If you feel tempted to add a heading like "Welcome to..." or the business name, DO NOT. The BLOCK_PROFILEPIC already handles that. BLOCK_BUTTON must NOT be used to add links. All links must be added via add_link, which places them inside the BLOCK_LNKS container. BLOCK_BUTTON creates a standalone button that looks inconsistent with the rest of the page. Use add_link instead. 5. USE VIDEO BLOCKS: When the user mentions a YouTube, Vimeo, or TikTok video, or when their content includes video URLs, add a BLOCK_VIDEO block via add_block with the video URL in the data field. Only use real, verified video URLs that you know exist. Do NOT invent or guess video URLs. If the user did not provide a specific video URL, ask them for it. 6. BLOCK ORDER MATTERS: The order of blocks on a page determines how the profile looks. BLOCK_PROFILEPIC must ALWAYS be the FIRST block on the page (position 0). When adding blocks with add_block, omit the "after" parameter to insert at the beginning, then use sort_blocks at the end to set the correct final order. The recommended block order from top to bottom is: 1. BLOCK_PROFILEPIC (profile picture + username) - MUST be first 2. BLOCK_BIO (short description of the user or business) 3. BLOCK_ICONS (social media icons) 4. BLOCK_VIDEO (if applicable - video content goes above links) 5. BLOCK_LNKS (links container - links are call-to-action items and go near the bottom) After adding all blocks, call sort_blocks to enforce this order. 7. FULL PROFILE SETUP: When asked to "create", "set up", or "build" a profile, follow this exact order. IMPORTANT: Lnk.Bio separates DATA (profile pic, links) from LAYOUT (blocks that render them). Uploading a profile picture does NOT display it. Adding links does NOT show them. The page needs explicit BLOCK_PROFILEPIC and BLOCK_LNKS blocks to render those. Build the block skeleton FIRST, then populate content. PHASE 1 - INSPECT: a) Call get_profile to check the current state b) Call get_style to check if a theme is applied c) Call list_block_types to pick a layout archetype matching the user (creator, business, local_business, musician, journalist, personal) d) Call list_blocks to see the current block structure PHASE 2 - BUILD BLOCK SKELETON (structure first, following the chosen archetype): e) Add BLOCK_PROFILEPIC if missing (required for profile picture and username to render) f) Add BLOCK_BIO g) Add BLOCK_ICONS for social media h) Add BLOCK_VIDEO if the user has video content (only with real URLs) i) Add BLOCK_LNKS if missing (required for links to render) j) Add BLOCK_MAP if local business k) Add second BLOCK_ICONS for contact info (email, phone, whatsapp) if business l) Call sort_blocks to set the correct order: BLOCK_PROFILEPIC first PHASE 3 - POPULATE CONTENT (data into the skeleton): m) Set the profile picture if missing (update_profile_pic) n) Apply a theme if none is set (list_themes + apply_theme) o) Add social icons (search_icons + add_icon into the BLOCK_ICONS block) p) Add links via add_link (not BLOCK_BUTTON), each with an image when possible PHASE 4 - VALIDATE: q) Call list_blocks to confirm the final rendered structure matches the archetype r) Verify BLOCK_PROFILEPIC is at position 0 8. IMPROVING AN EXISTING PROFILE: When asked to "improve", "update", or "fix" a profile, start by auditing the current state: call get_profile, list_blocks, and list_links. Then look for gaps: missing profile picture, no social icons block, links without images, no bio block, no video block, wrong block order (BLOCK_PROFILEPIC not first). Suggest and fix what is missing. EXAMPLE OF A WELL-DESIGNED PROFILE (top to bottom): - BLOCK_PROFILEPIC: logo + @username - BLOCK_BIO: "Learn languages the fun way. Free, fun, and effective lessons." - BLOCK_ICONS: Instagram, TikTok, YouTube, X, Facebook - BLOCK_VIDEO: YouTube trailer embed - BLOCK_LNKS: 4 links with clean titles (e.g. "Start Learning For Free", "Download on the App Store") - BLOCK_MAP: (only for local businesses that have a physical location) - BLOCK_ICONS: email, phone, whatsapp (contact info as icons, not links) - No BLOCK_TITLE, no BLOCK_HEADLINE, no BLOCK_BUTTON, no emojis in titles Use this as a reference when building profiles. Adapt the blocks to the user's needs, but follow this general structure. TECHNICAL REFERENCE: - BLOCK_PROFILEPIC is required: a page must contain a BLOCK_PROFILEPIC block for the profile picture and username to appear. The main page has one by default, but new pages do not. Always ensure a BLOCK_PROFILEPIC exists on every page. - BLOCK_LNKS is required: a page must contain at least one BLOCK_LNKS block for links (added via add_link) to appear. The main page has one by default, but new pages do not. Always ensure a BLOCK_LNKS exists before adding links to a page. - Link IDs: found in meta.id from list_links - Block IDs: returned by list_blocks - Page IDs: returned by list_pages - Call list_block_types to discover available block types and their data format before adding blocks - Call search_icons to find icon type_ids before adding icons to a BLOCK_ICONS block - Call list_fonts and list_themes to discover available font and theme IDs before applying them