KODE.link

Get list of available predefined themes with their full params. Args: is_pro: Filter by PRO themes only (None for all) limit: Maximum number of themes to return (None for all) Returns: Dictionary with list of available themes

Get current flash message for the authenticated user.

Get current user settings for the authenticated user. Returns: Dictionary with user settings including title, description, name, etc.

A simple hello tool for testing MCP server connectivity. Args: name: Name to greet (default: "World") Returns: A greeting message

List highlights for the authenticated user.

List links for the authenticated user. Args: link_type: Filter by link type is_published: Filter by published status limit: Maximum number of links to return Returns: Dictionary with list of links

Parse and normalize a social link value or URL. Args: value: Social URL, handle, phone, or email social_network_id: Optional SocialNetwork ID to force parsing rules Returns: Dictionary with detected social network and normalized value

Use this tool to query data available in the server. The `collection` parameter specifies the collection to query and the `search_pipeline` parameter is a list of stage of a MongoDB aggregation pipeline with restricted syntax. ## MongoDB aggregation pipeline syntax supported The syntax to query is a subset of MangoDB aggregation pipeline JSON with support of following stages : 1. $lookup: Joins another collection :. - "from" must refer to a model name listed in ref in the schema (if defined). - "localField" must be a field path on the base collection or a previous $lookup alias. - "foreignField" must be "_id" - "as" defines an alias used in subsequent $match and $lookup stages as a prefix (e.g., alias.field). 2. $match: Filter documents using comparison and logical operators. - Supports: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $regex in addition to $text for collections that support full text search. - Field references can include lookup aliases via dot notation, e.g. "user.name" 3. $sort: Sorts the result. Keys must map to model fields. 4. $limit: Truncates the result set to the specified number of items. 5. $project: Selects specific fields for results. Only "flat" objects are supported. Value is either a number/boolean to include/exclude the field or a string starting in format "$<lookupAlias>.<field>" to project a field from a previous $lookup stage. 6. $search: For collection that support full-text search. Limited to {"text":{"query":"<keyword>"}}. 7. $group: Groups the result set by a field and applies aggregations. - It must be the **final** stage in the pipeline. - You cannot have a $project stage in the pipeline. - `_id` can be null for global aggregation or a $<field> reference of a single field or lookup field or an object mapping "keys" to "$<field>" refs. - Supported accumulator operators: `$sum`, `$avg`, `$min`, `$max` and `$count` All other stages NOT SUPPORTED : $addFields, $set, $unset, $unwind ... . ## Available collections to query ### 'theme' collection Documents conform the following JSON Schema ```json {'description': 'Model to store Themes', '$jsonSchema': {'bsonType': 'object', 'properties': {'id': {'description': 'Primary unique identifier for this model', 'bsonType': 'int'}, 'created_at': {'bsonType': 'date'}, 'updated_at': {'bsonType': 'date'}, 'published_at': {'bsonType': 'date'}, 'is_published': {'bsonType': 'bool'}, 'deleted_at': {'bsonType': 'date'}, 'is_deleted': {'bsonType': 'bool'}, 'template_preview': {'bsonType': 'string'}, 'name': {'bsonType': 'string'}, 'slug': {'bsonType': 'string'}, 'theme_class': {'bsonType': 'string'}, 'page_bg_color': {'bsonType': 'string'}, 'card_bg_color': {'bsonType': 'string'}, 'is_pro': {'bsonType': 'bool'}, 'logo_url': {'bsonType': 'string'}, 'thumbnail': {'bsonType': 'string'}, 'is_for_onboarding': {'bsonType': 'bool'}, 'params': {'bsonType': 'object'}}, 'required': ['created_at', 'is_published', 'is_deleted', 'name', 'slug', 'theme_class']}} ``` Full text search is supported on the following fields: template_preview, name, logo_url, theme_class, page_bg_color, slug, card_bg_color. ### 'colorpalette' collection Documents conform the following JSON Schema ```json {'description': 'Model to store Color Palette', '$jsonSchema': {'bsonType': 'object', 'properties': {'id': {'description': 'Primary unique identifier for this model', 'bsonType': 'int'}, 'params': {'bsonType': 'object'}, 'thumbnail': {'bsonType': 'string'}, 'ordering': {'bsonType': 'int'}}}} ``` Full text search is not supported on this collection. ### 'socialnetwork' collection Documents conform the following JSON Schema ```json {'description': 'Model to store Social Networks used for Social Links', '$jsonSchema': {'bsonType': 'object', 'properties': {'id': {'description': 'Primary unique identifier for this model', 'bsonType': 'int'}, 'created_at': {'bsonType': 'date'}, 'updated_at': {'bsonType': 'date'}, 'published_at': {'bsonType': 'date'}, 'is_published': {'bsonType': 'bool'}, 'deleted_at': {'bsonType': 'date'}, 'is_deleted': {'bsonType': 'bool'}, 'type': {'bsonType': 'string', 'enum': ['url', 'email', 'handle', 'phone', 'url_or_handle'], 'description': "Choices: 'url' = URL, 'email' = Email, 'handle' = Handle, 'phone' = Phone, 'url_or_handle' = URL or Handle"}, 'name': {'bsonType': 'string'}, 'icon_svg': {'bsonType': 'string', 'description': 'Used to display in Dashboard form and public view as a <b>standalone</b> link'}, 'icon_button_svg': {'bsonType': 'string', 'description': 'Used to display in public view as a <b>button</b> link'}, 'icon_svg_branded': {'bsonType': 'string'}, 'button_gradient': {'bsonType': 'string'}, 'form_placeholder': {'bsonType': 'string'}, 'form_label': {'bsonType': 'string'}, 'base_url': {'bsonType': 'string', 'description': 'Base URL prefix, i.e. "http://www.instagram.com/" or "mailto:"'}, 'url_validation': {'bsonType': 'string', 'description': 'URL part for frontend validation, i.e. "facebook.com|fb.com|fb.me" for Facebook links'}, 'url_detection_list': {'bsonType': 'object'}, 'is_copy': {'bsonType': 'bool'}, 'ordering': {'bsonType': 'int'}, 'is_favorite': {'bsonType': 'bool'}, 'append_at_to_slug': {'bsonType': 'bool'}}, 'required': ['created_at', 'is_published', 'is_deleted', 'type', 'name', 'icon_svg']}} ``` Full text search is supported on the following fields: form_placeholder, type, icon_svg_branded, form_label, button_gradient, icon_button_svg, base_url, name, url_validation, icon_svg. ### 'customtheme' collection Documents conform the following JSON Schema ```json {'description': 'Model to store Custom Themes', '$jsonSchema': {'bsonType': 'object', 'properties': {'id': {'description': 'Primary unique identifier for this model', 'bsonType': 'int'}, 'created_at': {'bsonType': 'date'}, 'updated_at': {'bsonType': 'date'}, 'published_at': {'bsonType': 'date'}, 'is_published': {'bsonType': 'bool'}, 'deleted_at': {'bsonType': 'date'}, 'is_deleted': {'bsonType': 'bool'}, 'name': {'bsonType': 'string'}, 'button_color': {'bsonType': 'string'}, 'button_font_color': {'bsonType': 'string'}, 'button_border_color': {'bsonType': 'string'}, 'button_style': {'bsonType': 'string'}, 'button_thumbnail_style': {'bsonType': 'string'}, 'card_button_color': {'bsonType': 'string'}, 'card_button_font_color': {'bsonType': 'string'}, 'card_bg_color': {'bsonType': 'string'}, 'card_font_color': {'bsonType': 'string'}, 'card_button_hover_color': {'bsonType': 'string'}, 'card_button_font_hover_color': {'bsonType': 'string'}, 'card_secondary_button_color': {'bsonType': 'string'}, 'card_secondary_button_font_color': {'bsonType': 'string'}, 'card_secondary_button_hover_color': {'bsonType': 'string'}, 'card_secondary_button_font_hover_color': {'bsonType': 'string'}, 'placeholder_bg_color': {'bsonType': 'string'}, 'card_secondary_font_color': {'bsonType': 'string'}, 'font_secondary_color': {'bsonType': 'string'}, 'social_icon_hover_color': {'bsonType': 'string'}, 'background_image': {'bsonType': 'string'}, 'background_image_resized': {'bsonType': 'string'}, 'background_image_blur': {'bsonType': 'bool'}, 'background_image_landscape': {'bsonType': 'string'}, 'background_image_landscape_resized': {'bsonType': 'string'}, 'background_image_landscape_blur': {'bsonType': 'bool'}, 'background_video': {'bsonType': 'string'}, 'background_color': {'bsonType': 'string'}, 'background_color_mobile': {'bsonType': 'string'}, 'background_color_mobile_enabled': {'bsonType': 'bool'}, 'background_style': {'bsonType': 'string'}, 'background_gradient': {'bsonType': 'string'}, 'background_animated_style': {'bsonType': 'string'}, 'bg_animation_color1': {'bsonType': 'string'}, 'bg_animation_color2': {'bsonType': 'string'}, 'content_bg_color': {'bsonType': 'string'}, 'content_bg_color_enabled': {'bsonType': 'bool'}, 'content_bg_image': {'bsonType': 'string'}, 'content_bg_image_resized': {'bsonType': 'string'}, 'content_border_radius': {'bsonType': 'int'}, 'card_button_border_radius': {'bsonType': 'int'}, 'font_color': {'bsonType': 'string'}, 'font_style': {'bsonType': 'string'}, 'avatar_style': {'bsonType': 'string'}, 'cover_style': {'bsonType': 'string'}, 'cover_shape': {'bsonType': 'string'}, 'combined_style': {'bsonType': 'string'}, 'social_icon_color': {'bsonType': 'string'}, 'crypto_button_color': {'bsonType': 'string'}, 'crypto_font_color': {'bsonType': 'string'}, 'color_palette': {'bsonType': 'objectId', 'description': 'Reference to ColorPalette', 'ref': 'ColorPalette'}}, 'required': ['created_at', 'is_published', 'is_deleted', 'name']}} ``` Full text search is supported on the following fields: card_secondary_button_color, bg_animation_color1, card_button_hover_color, card_secondary_button_font_hover_color, cover_shape, card_button_font_hover_color, content_bg_color, card_bg_color, background_gradient, font_secondary_color, background_color, card_font_color, background_color_mobile, card_button_font_color, bg_animation_color2, combined_style, card_button_color, name, background_animated_style, social_icon_hover_color, button_thumbnail_style, button_border_color, placeholder_bg_color, button_font_color, font_color, cover_style, card_secondary_button_hover_color, crypto_font_color, font_style, avatar_style, background_style, social_icon_color, button_style, card_secondary_button_font_color, button_color, crypto_button_color, card_secondary_font_color. ### 'link' collection Documents conform the following JSON Schema ```json {'description': 'Model to store Links', '$jsonSchema': {'bsonType': 'object', 'properties': {'id': {'description': 'Primary unique identifier for this model', 'bsonType': 'int'}, 'created_at': {'bsonType': 'date'}, 'updated_at': {'bsonType': 'date'}, 'published_at': {'bsonType': 'date'}, 'is_published': {'bsonType': 'bool'}, 'deleted_at': {'bsonType': 'date'}, 'is_deleted': {'bsonType': 'bool'}, 'name': {'bsonType': 'string'}, 'link_type': {'bsonType': 'string', 'enum': ['link', 'header', 'video', 'tiktok', 'rss', 'stripe_checkout', 'twitter', 'spotify', 'pinterest', 'opensea', 'phone', 'dropdown', 'twitch', 'pdf', 'bank_details', 'nft_gallery', 'contact_details', 'book', 'cv', 'podcast', 'multi_button', 'countdown_timer', 'app', 'google_review', 'delimiter', 'gofundme', 'advertise', 'music', 'calendly', 'text_block', 'qrcode', 'digital_product', 'threads', 'tiktok_feed', 'social_links', 'crypto_link', 'menu', 'location', 'gallery', 'tiles', 'lead_form'], 'description': "Choices: 'link' = Web Link, 'header' = Header, 'video' = Video, 'tiktok' = Tiktok, 'rss' = RSS, 'stripe_checkout' = Stripe Checkout, 'twitter' = Twitter, 'spotify' = Spotify, 'pinterest' = Pinterest, 'opensea' = OpenSea, 'phone' = Phone, 'dropdown' = Drop-down List, 'twitch' = Twitch, 'pdf' = PDF, 'bank_details' = Bank Details, 'nft_gallery' = NFT Gallery, 'contact_details' = Contact Details, 'book' = Book Link, 'cv' = CV Link, 'podcast' = Podcast, 'multi_button' = Multi Button, 'countdown_timer' = Countdown Timer, 'app' = APP Link, 'google_review' = Google Review, 'delimiter' = Delimiter, 'gofundme' = GoFundMe, 'advertise' = Advertise, 'music' = Music Link, 'calendly' = Calendly link, 'text_block' = Text Block, 'qrcode' = QR Code, 'digital_product' = Digital Product, 'threads' = Threads Link, 'tiktok_feed' = TikTok Feed, 'social_links' = Social Links, 'crypto_link' = Crypto Link, 'menu' = Menu, 'location' = Map, 'gallery' = Gallery, 'tiles' = Tiles, 'lead_form' = Lead Form"}, 'weblink_view': {'bsonType': 'string', 'enum': ['button', 'card', 'image'], 'description': "Choices: 'button' = Button, 'card' = Card, 'image' = Image"}, 'weblink_card_thumbnail_alignment': {'bsonType': 'string', 'enum': ['left', 'right'], 'description': "Choices: 'left' = Left, 'right' = Right"}, 'weblink_button_text': {'bsonType': 'string'}, 'weblink_image_text_color': {'bsonType': 'string'}, 'url': {'bsonType': 'string'}, 'slug': {'bsonType': 'string'}, 'thumbnail': {'bsonType': 'string'}, 'thumbnail_default': {'bsonType': 'string'}, 'thumbnail_resized': {'bsonType': 'string'}, 'thumbnail_icon': {'bsonType': 'string'}, 'is_show_thumbnail': {'bsonType': 'bool'}, 'priority_class': {'bsonType': 'string'}, 'is_fastlink': {'bsonType': 'bool'}, 'is_header': {'bsonType': 'bool'}, 'ordering': {'bsonType': 'int'}, 'description': {'bsonType': 'string', 'description': 'Content cannot exceed 10000 characters.'}, 'description_html': {'bsonType': 'string', 'description': 'Content cannot exceed 12000 characters.'}, 'file': {'bsonType': 'string'}, 'image': {'bsonType': 'string'}, 'image_resized': {'bsonType': 'string'}, 'image_size': {'bsonType': 'string', 'enum': ['SQ', 'HR', 'VR', 'WL', 'NL'], 'description': "Choices: 'SQ' = Square, 'HR' = Rectangle, 'VR' = Vertical Rectangle, 'WL' = Wide Landscape, 'NL' = Narrow Landscape"}, 'rss_data': {'bsonType': 'object'}, 'rss_links_limit': {'bsonType': 'int'}, 'is_rss_thumbnails': {'bsonType': 'bool'}, 'video_service': {'bsonType': 'string'}, 'is_embed': {'bsonType': 'bool'}, 'is_autoplay': {'bsonType': 'bool'}, 'is_mute': {'bsonType': 'bool'}, 'is_danger': {'bsonType': 'bool'}, 'active_from': {'bsonType': 'date'}, 'active_until': {'bsonType': 'date'}, 'link_data': {'bsonType': 'object'}, 'twitter_link_type': {'bsonType': 'string', 'description': "Possible types: tweet_link, tweet_embed, latest_tweet_link, latest_tweet_embed Choices: 'tweet_link' = Tweet Link, 'tweet_embed' = Tweet Embed, 'latest_tweet_link' = Latest Tweet Link, 'latest_tweet_embed' = Latest Tweet Embed", 'enum': ['tweet_link', 'tweet_embed', 'latest_tweet_link', 'latest_tweet_embed']}, 'is_expanded_in_dashboard': {'bsonType': 'bool'}, 'is_expanded': {'bsonType': 'bool'}, 'short_url_domain': {'bsonType': 'string', 'enum': ['hey.link', 'he1.me', 'hey1.me', 'heybio.link', 'he1.link', 'myhey.link', 'shortlink-dev.heylink.me'], 'description': "Choices: 'hey.link' = hey.link, 'he1.me' = he1.me, 'hey1.me' = hey1.me, 'heybio.link' = heybio.link, 'he1.link' = he1.link, 'myhey.link' = myhey.link, 'shortlink-dev.heylink.me' = shortlink-dev.heylink.me"}, 'short_url_code': {'bsonType': 'string'}, 'heyl_ink_url': {'bsonType': 'string'}, 'is_short_link_use': {'bsonType': 'bool'}, 'twitch_display': {'bsonType': 'string'}, 'nft_gallery_wallet_number': {'bsonType': 'string'}, 'nft_gallery_blockchain': {'bsonType': 'string'}, 'qr_code_image': {'bsonType': 'string'}, 'has_link_to_user_profile': {'bsonType': 'bool'}, 'description_is_active': {'bsonType': 'bool'}, 'is_social_brand_colors': {'bsonType': 'bool'}}, 'required': ['created_at', 'is_published', 'is_deleted', 'is_show_thumbnail', 'is_rss_thumbnails', 'is_danger', 'short_url_domain', 'is_short_link_use', 'has_link_to_user_profile', 'description_is_active', 'is_social_brand_colors']}} ``` Full text search is supported on the following fields: link_type, short_url_code, nft_gallery_blockchain, video_service, twitter_link_type, thumbnail_icon, weblink_view, slug, name, url, weblink_card_thumbnail_alignment, weblink_button_text, image_size, thumbnail_default, priority_class, twitch_display, weblink_image_text_color, heyl_ink_url, nft_gallery_wallet_number, description_html, short_url_domain, description.

Reorder links by providing a list of link IDs in desired order. Args: link_ids: List of link IDs in desired order Returns: Dictionary with reordering status

Toggle Sensitive Material and optionally set its level. Args: on: Enable or disable sensitive material warning level: Sensitive content level (12, 15, 18, 21, 25, sensitive) Returns: Dictionary with updated sensitive_content

Update a highlight item.

Update an existing link. Args: link_id: ID of the link to update name: New link name url: New link URL slug: New link slug is_published: New published status description: Link description text description_html: Rich description HTML (optional) description_is_active: Toggle description visibility (defaults to True when description provided) weblink_view: Standard link layout ("button") or card layout ("card") weblink_card_thumbnail_alignment: Card thumbnail alignment ("left" or "right") weblink_button_text: Custom button text priority_class: Priority CSS class is_fastlink: Toggle fastlink is_header: Toggle header styling is_expanded: Expand link block is_expanded_in_dashboard: Expand in dashboard rss_links_limit: RSS items limit is_rss_thumbnails: Toggle RSS thumbnails video_service: Video service identifier is_embed: Toggle embed mode is_autoplay: Toggle autoplay is_mute: Toggle mute active_from: Active from datetime (ISO 8601) active_until: Active until datetime (ISO 8601) active_timezone_id: Timezone ID for active window link_data: JSON metadata for the link twitter_link_type: Twitter link type heyl_ink_url: Short URL value short_url_domain: Short URL domain short_url_code: Short URL code is_short_link_use: Toggle short URL usage twitch_display: Twitch display mode thumbnail_icon: Thumbnail icon override thumbnail_default: Default thumbnail value Returns: Dictionary with updated link details

Update the thumbnail image for a link from a URL or raw image data. Args: link_id: ID of the link to update thumbnail_url: URL of the thumbnail image to download and set (optional) thumbnail_data: Base64 encoded image data or data URL (e.g., 'data:image/png;base64,...') (optional) Returns: Dictionary with updated link details

Update menu settings and optionally replace menu items. Args: menu_id: Menu ID to update link_id: Link ID (menu link) to resolve menu title: Menu title currency_id: Currency ID is_published: Publish menu is_expanded: Expand menu is_link_enable: Enable menu button link link_title: Button title link_url: Button URL link_button_color: Button color link_font_color: Button text color items: List of menu items, each with description/name/title and optional price/order replace_items: If True, replace existing items (default True) Returns: Updated menu/link payload

Update animated background for the authenticated user's custom theme. Args: background_animated_style: Animation name (e.g., "Snow"); empty/None disables animation bg_animation_color1: Primary animation color (rgb/hex string) bg_animation_color2: Secondary animation color (rgb/hex string) clear_static_backgrounds: Clear background_style and background images (default True) Returns: Dictionary with updated theme animation fields

Update theme colors for the authenticated user's custom theme. Args: background_color: Page background color (hex/rgba format) background_color_mobile: Mobile background color (hex/rgba format) content_bg_color: Content background color (hex/rgba format) font_color: Primary text color (hex/rgba format) font_secondary_color: Secondary text color (hex/rgba format) social_icon_color: Social icon color (hex/rgba format) social_icon_hover_color: Social icon hover color (hex/rgba format) button_color: Button background color (hex/rgba format) button_font_color: Button text color (hex/rgba format) button_border_color: Button border color (hex/rgba format) card_button_color: Card button background color (hex/rgba format) card_button_font_color: Card button text color (hex/rgba format) card_button_hover_color: Card button hover color (hex/rgba format) card_button_font_hover_color: Card button hover text color (hex/rgba format) card_secondary_button_color: Card secondary button color (hex/rgba format) card_secondary_button_font_color: Card secondary button text color (hex/rgba format) card_secondary_button_hover_color: Card secondary button hover color (hex/rgba format) card_secondary_button_font_hover_color: Card secondary button hover text color (hex/rgba format) card_bg_color: Card background color (hex/rgba format) card_font_color: Card text color (hex/rgba format) card_secondary_font_color: Card secondary text color (hex/rgba format) placeholder_bg_color: Placeholder background color (hex/rgba format) crypto_button_color: Crypto button color (hex/rgba format) crypto_font_color: Crypto button text color (hex/rgba format) bg_animation_color1: Animated background primary color (hex/rgba format) bg_animation_color2: Animated background secondary color (hex/rgba format) Returns: Dictionary with updated theme colors

Update theme styles for the authenticated user's custom theme. Args: button_style: Button style class name button_thumbnail_style: Button thumbnail style class name avatar_style: Avatar style class name cover_style: Cover style class name combined_style: Combined style class name font_style: Font family name Returns: Dictionary with updated theme styles

Update user settings for the authenticated user. Args: title: User profile title/headline description_html: HTML description (max 2000 characters) first_name: User's first name last_name: User's last name page_layout: Page layout style (avatar, cover, combined, image-bg) desktop_layout: Desktop layout (one_col, two_col) username_is_hidden: Whether to hide username avatar_is_hidden: Whether to hide avatar social_links_mode: Social links display mode (buttons, icons) crypto_links_mode: Crypto links display mode (copy, qr) links_align: Links alignment (left, center, right) header_text_align: Header text alignment (left, center, right) qr_code_is_hidden: Whether to hide QR code qr_code_color: QR code color (hex format) share_profile: Whether profile sharing is enabled share_links: Whether link sharing is enabled highlights_is_active: Whether highlights section is active highlights_title: Highlights section title sensitive_content: Sensitive content level (off, 12, 15, 18, 21, 25, sensitive) flash_message_is_active: Whether flash message is active (PRO only) messages_is_active: Whether messages feature is active messages_on_shortcut: Whether messages appear on shortcut shortcut_is_active: Whether shortcut feature is active show_verification_badge: Whether to show verification badge Returns: Dictionary with updated user settings

Create or update flash message for the authenticated user. Args: title: Flash message title description: Flash message description button_title: Button title button_link: Button URL button_color: Button background color button_text_color: Button text color is_active: Enable/disable flash message (PRO only) Returns: Dictionary with updated flash message