LaunchNotes MCP Server

Retrieve complete details for a LaunchNotes project, including all customization settings, colors, custom code, and feature flags.

Args:

• project_id (string): The ID of the project to retrieve

• response_format ('json' | 'markdown'): Output format (default: 'markdown')

Returns: For JSON format: Complete project object with all fields For Markdown format: Formatted project details with sections for colors, custom code, and features

Use Cases:

• "Show me my project's current custom CSS"

• "What are the color values for project X?"

• "Get all settings for my LaunchNotes project"

Error Handling:

• Returns "Project not found" if the project ID doesn't exist

• Returns "Authentication failed" if the API token is invalid

List all LaunchNotes projects accessible with the current API token.

Args:

• response_format ('json' | 'markdown'): Output format (default: 'markdown')

Returns: List of projects with id, name, slug, and public URL

Use Cases:

• "Show me all my LaunchNotes projects"

• "List projects in my organization"

• "What projects do I have access to?"

Error Handling:

• Returns "Authentication failed" if the API token is invalid

Update custom CSS, HTML head, header, footer, or index hero for a LaunchNotes project.

Args:

• project_id (string): The ID of the project to update

• custom_css (string, optional): Custom CSS code

• custom_head (string, optional): Custom HTML for section

• custom_header (string, optional): Custom HTML for page header

• custom_footer (string, optional): Custom HTML for page footer

• custom_index_hero (string, optional): Custom HTML for index hero section

At least one custom code field must be provided. Fields not provided will remain unchanged.

Returns: Confirmation message with project ID and updated timestamp

Use Cases:

• "Add custom CSS to hide the sidebar"

• "Update the custom header HTML"

• "Set custom analytics code in the head"

• "Add a custom footer with social links"

Error Handling:

• Returns validation errors if no fields are provided

• Returns "Project not found" if the project ID doesn't exist

• Returns "Authentication failed" if the API token lacks permission

Update color palette and theme for a LaunchNotes project. All colors must be in hex format (e.g., #FF5733).

Args:

• project_id (string): The ID of the project to update

• primary_color (string, optional): Primary brand color (hex)

• secondary_color (string, optional): Secondary brand color (hex)

• primary_text_color (string, optional): Primary text color (hex)

• secondary_text_color (string, optional): Secondary text color (hex)

• gray_color (string, optional): Gray accent color (hex)

• light_gray_color (string, optional): Light gray color (hex)

• off_white_color (string, optional): Off-white color (hex)

• white_color (string, optional): White color (hex)

• supporting_palette (string, optional): Supporting palette configuration

• color_theme (string, optional): Overall color theme identifier

At least one color field must be provided. Fields not provided will remain unchanged.

Returns: Confirmation message with updated color fields

Use Cases:

• "Change the primary color to #FF5733"

• "Update all brand colors for my project"

• "Set text colors to improve readability"

• "Update the color theme to dark mode"

Error Handling:

• Returns validation error if hex colors are invalid

• Returns "Project not found" if the project ID doesn't exist

Update project title, description, headings, and slug for a LaunchNotes project.

Args:

• project_id (string): The ID of the project to update

• name (string, optional): Internal project name

• title (string, optional): Public-facing project title

• description (string, optional): Project description

• heading (string, optional): Main heading on the project page

• subheading (string, optional): Subheading below the main heading

• slug (string, optional): URL-friendly identifier (lowercase, hyphens only)

At least one content field must be provided. Fields not provided will remain unchanged.

Returns: Confirmation message with updated content fields

Use Cases:

• "Update project title to 'Product Updates'"

• "Change the heading and subheading"

• "Update the project slug to 'updates'"

• "Set a new description"

Error Handling:

• Returns validation error if slug format is invalid

• Returns "Project not found" if the project ID doesn't exist

Enable or disable features for a LaunchNotes project (feedback, roadmap, ideas, RSS, voting, SEO indexing).

Args:

• project_id (string): The ID of the project to update

• feedback_enabled (boolean, optional): Enable/disable feedback collection

• roadmap_enabled (boolean, optional): Enable/disable roadmap feature

• ideas_enabled (boolean, optional): Enable/disable ideas/feature requests

• rss_feed_enabled (boolean, optional): Enable/disable RSS feed

• voting_enabled (boolean, optional): Enable/disable voting on ideas

• noindex (boolean, optional): Prevent search engine indexing (true = disabled SEO)

At least one feature toggle must be provided. Features not specified will remain unchanged.

Returns: Confirmation message with updated feature toggles

Use Cases:

• "Enable feedback collection for my project"

• "Turn on the roadmap feature"

• "Disable RSS feed"

• "Enable voting on ideas"

Error Handling:

• Returns "Project not found" if the project ID doesn't exist

List all announcements in a LaunchNotes project with optional filtering and ordering.

Args:

• project_id (string): The ID of the project

• state ('draft' | 'scheduled' | 'published' | 'archived', optional): Filter by state

• limit (number, optional): Number to return (max 100, default: 50)

• order_by_field ('publishedAt' | 'createdAt' | 'updatedAt', optional): Field to sort by

• order_by_direction ('ASC' | 'DESC', optional): Sort direction (ascending or descending)

• response_format ('json' | 'markdown'): Output format (default: 'markdown')

Returns: List of announcements with id, headline, state, dates, and slug

Use Cases:

• "List all announcements in my LaunchNotes project"

• "Show me all published announcements ordered by published date"

• "List draft announcements"

• "Show scheduled announcements sorted by creation date descending"

Note: To use ordering, both order_by_field and order_by_direction must be specified. Default ordering (when not specified) is by updatedAt descending.

Error Handling:

• Returns "Project not found" if project ID doesn't exist

• Returns "Authentication failed" if API token is invalid

Retrieve complete details for a specific announcement including content, categories, and metadata.

Args:

• announcement_id (string): The ID of the announcement

• response_format ('json' | 'markdown'): Output format (default: 'markdown')

Returns: Complete announcement details with all fields

Use Cases:

• "Show me announcement details for ID abc123"

• "Get the full content of announcement xyz"

• "What are the categories for this announcement?"

Error Handling:

• Returns "Announcement not found" if ID doesn't exist

• Returns "Authentication failed" if API token is invalid

Create a new draft announcement in a LaunchNotes project. The announcement will be created in draft state.

Args:

• project_id (string): The ID of the project

• headline (string): The main headline/title (required)

• content_markdown (string, optional): Content in Markdown format

• content_html (string, optional): Content in HTML format

• content_jira (string, optional): Content in Jira Wiki Syntax

Note: Provide only ONE content format. If multiple are provided, the API will use contentMarkdown > contentHtml > contentJira in order of precedence.

Returns: Created announcement with ID, headline, state, and creation timestamp

Use Cases:

• "Create a new announcement about the API update"

• "Draft an announcement for the new feature launch"

• "Create announcement with headline 'v2.0 Released'"

Error Handling:

• Returns validation errors if required fields are missing

• Returns "Project not found" if project ID doesn't exist

• Returns "Authentication failed" if API token lacks permission

Update an existing announcement's content, metadata, or categorization.

Args:

• announcement_id (string): The ID of the announcement to update

• headline (string, optional): Update the headline/title

• content (string, optional): Update the content/body (must be in LaunchNotes JSON format, not Markdown)

• title (string, optional): Update SEO title

• description (string, optional): Update meta description

• excerpt (string, optional): Update excerpt/summary

• category_ids (array, optional): Replace category assignments

• change_type_ids (array, optional): Replace change type (label) assignments

Note: The 'content' field requires LaunchNotes' internal JSON format. For creating announcements with Markdown, use the create_announcement tool with content_markdown.

At least one field must be provided. Fields not specified will remain unchanged.

Returns: Confirmation with updated announcement details

Use Cases:

• "Update the headline of announcement abc123"

• "Update the excerpt"

• "Add categories to announcement xyz"

Error Handling:

• Returns validation error if no fields provided

• Returns "Announcement not found" if ID doesn't exist

• Returns "Authentication failed" if API token lacks permission

Publish an announcement immediately, making it live and visible to subscribers.

Args:

• announcement_id (string): The ID of the announcement to publish

Returns: Confirmation with published announcement details and publish timestamp

Use Cases:

• "Publish announcement abc123"

• "Make this announcement live now"

• "Publish my draft announcement"

Notes:

• Announcement must be in draft or scheduled state

• Subscribers will be notified according to project settings

• Use schedule_announcement to publish at a future time

Error Handling:

• Returns error if announcement is already published

• Returns "Announcement not found" if ID doesn't exist

• Returns "Authentication failed" if API token lacks permission

Schedule an announcement to be published automatically at a specific future date and time.

Args:

• announcement_id (string): The ID of the announcement to schedule

• scheduled_at (string): When to publish (ISO 8601 format, must be in future)

• scheduled_at_timezone (string, optional): Timezone (e.g., 'America/New_York', 'UTC'). Defaults to UTC.

Returns: Confirmation with scheduled announcement details and scheduled publish time

Use Cases:

• "Schedule announcement for tomorrow at 9am"

• "Set announcement to publish on December 25th at noon EST"

• "Schedule for next Monday at 3pm in New York timezone"

Examples of scheduled_at format:

• "2025-12-25T12:00:00Z" (UTC time)

• "2025-12-25T09:00:00-05:00" (EST - with timezone offset)

• "2025-12-25T09:00:00" with scheduled_at_timezone: "America/New_York"

Notes:

• Announcement will automatically publish at the scheduled time

• Subscribers will be notified when it publishes

• You can reschedule by calling this again with a new time

Error Handling:

• Returns error if scheduled_at is in the past

• Returns error if date format is invalid

• Returns "Announcement not found" if ID doesn't exist

Archive an announcement, removing it from the active list while preserving its content.

Args:

• announcement_id (string): The ID of the announcement to archive

Returns: Confirmation with archived announcement details

Use Cases:

• "Archive old announcement abc123"

• "Remove announcement from public view"

• "Archive outdated announcements"

Notes:

• Archived announcements are no longer visible on the public page

• Content and data are preserved

• Can be unarchived later if needed

• Different from deleting (which would be permanent)

Error Handling:

• Returns error if announcement is already archived

• Returns "Announcement not found" if ID doesn't exist

• Returns "Authentication failed" if API token lacks permission

Search and filter customer feedback in a LaunchNotes project.

Args:

• project_id (string): The ID of the project (required)

• query (string, optional): Search term to find in feedback content

• reaction ('happy' | 'meh' | 'sad', optional): Filter by customer sentiment

• importance ('low' | 'medium' | 'high', optional): Filter by importance level

• organized_state (string, optional): Filter by state ('organized', 'unorganized', 'announcement', 'idea', 'roadmap')

• starred (boolean, optional): Filter by starred status

• archived (boolean, optional): Filter by archived status

• limit (number, optional): Number to return (max 100, default: 20)

• response_format ('json' | 'markdown'): Output format (default: 'markdown')

Returns: List of feedback items with content, sentiment, importance, customer info, and timestamps

Use Cases:

• "What are customers saying about Digests?"

• "Show me all unhappy feedback"

• "Find high importance feedback that's unorganized"

• "Search feedback containing 'API integration'"

• "Show me starred feedback"

Error Handling:

• Returns "Project not found" if project ID doesn't exist

• Returns "Authentication failed" if API token is invalid

Retrieve complete details for a specific feedback item including customer info, reporter, and associations.

Args:

• feedback_id (string): The ID of the feedback item (required)

• response_format ('json' | 'markdown'): Output format (default: 'markdown')

Returns: Complete feedback details including:

• Content and internal notes

• Sentiment (reaction) and importance

• Affected customer information

• Reporter information

• Associated announcement/idea/work item

• Timestamps

Use Cases:

• "Show me details for feedback #abc123"

• "Get the full context of this feedback item"

• "What announcement is this feedback associated with?"

Error Handling:

• Returns "Feedback not found" if ID doesn't exist

• Returns "Authentication failed" if API token is invalid

Get top-performing announcements ranked by various metrics.

Args:

• project_id (string): The ID of the project (required)

• metric (enum, default: 'engagement'): Ranking metric

  • 'engagement' - Total viewers + email opens + clicks (most comprehensive)

  • 'open_rate' - Email open rate (email performance)

  • 'click_rate' - Email click rate (engagement depth)

  • 'feedback_count' - Number of feedback items (customer response)

  • 'feedback_sentiment' - Average sentiment score (customer satisfaction)

• limit (number, optional): Number of results (max 50, default: 10)

• response_format ('json' | 'markdown'): Output format (default: 'markdown')

Returns: Ranked list of announcements with:

• Announcement details (ID, headline, slug, publish date)

• Primary metric value

• All other available metrics (viewers, emails sent, opens, clicks, rates, feedback)

Note: Analytics are cumulative for all time, not filtered by date range.

Use Cases:

• "Which announcements performed best overall?"

• "Show me top 5 announcements by email open rate"

• "What got the most feedback?"

• "Which announcements had the best sentiment?"

Error Handling:

• Returns "Project not found" if project ID doesn't exist

• Returns "Authentication failed" if API token is invalid

• Returns empty result if no published announcements