MCP Tools Reference

Complete documentation for all available MCP tools

Quick Reference

Project Management

Create and manage your OpenBuild projects

list_projects

List all projects you own or have access to

Example

$"List my OpenBuild projects"

Returns

Array of projects with name, slug, supporters count, and status

get_project

Get detailed information about a specific project

Parameters

Name	Type	Description
project_id	string	Project ID or slug

Example

$"Show details for my-app"

Returns

Full project details including description, stats, and settings

create_project

Create a new project

Parameters

Name	Type	Description
name	string	Project name
tagline	string	Short description
category	string	Project category

Example

$"Create a new project called TaskFlow"

Returns

Newly created project with slug and ID

update_project

Update project settings

Parameters

Name	Type	Description
project_id	string	Project ID or slug
name	string	New name (optional)
tagline	string	New tagline (optional)
description	string	New description (optional)

Example

$"Update the tagline for my-app to: Build better, faster"

Returns

Updated project details

Updates/Announcements

Post progress updates and announcements

list_updates

List all updates for a project

Parameters

Name	Type	Description
project_id	string	Project ID or slug
limit	number	Max updates to return (optional)

Example

$"Show recent updates for my-app"

Returns

Array of updates with title, content, and timestamp

post_update

Post a new update to your project

Parameters

Name	Type	Description
project_id	string	Project ID or slug
title	string	Update title
content	string	Update content (markdown)
visibility	string	public or supporters (optional)

Example

$"Post an update to my-app: We shipped dark mode!"

Returns

Created update with ID and URL

edit_update

Edit an existing update

Parameters

Name	Type	Description
update_id	string	Update ID
title	string	New title (optional)
content	string	New content (optional)

Example

$"Fix typo in the latest update for my-app"

Returns

Updated update details

Features/Roadmap

Manage your project roadmap and features

list_features

List all features for a project

Parameters

Name	Type	Description
project_id	string	Project ID or slug
status	string	Filter by status (optional)

Example

$"Show the roadmap for my-app"

Returns

Array of features with title, status, and vote count

create_feature

Add a new feature to the roadmap

Parameters

Name	Type	Description
project_id	string	Project ID or slug
title	string	Feature title
description	string	Feature description
status	string	idea, planned, in_progress, shipped

Example

$"Add a feature for dark mode to my-app"

Returns

Created feature with ID

update_feature_status

Change the status of a feature

Parameters

Name	Type	Description
feature_id	string	Feature ID
status	string	New status

Example

$"Move the auth feature to shipped"

Returns

Updated feature with new status

Discussions

Manage community discussions

list_threads

List discussion threads for a project

Parameters

Name	Type	Description
project_id	string	Project ID or slug
limit	number	Max threads to return (optional)

Example

$"Show discussions for my-app"

Returns

Array of threads with title, author, and reply count

get_thread

Get a thread with all replies

Parameters

Name	Type	Description
thread_id	string	Thread ID

Example

$"Show the latest discussion thread"

Returns

Thread details with all replies

create_thread

Start a new discussion thread

Parameters

Name	Type	Description
project_id	string	Project ID or slug
title	string	Thread title
content	string	Initial post content

Example

$"Create a discussion about the new API design"

Returns

Created thread with ID and URL

reply_to_thread

Reply to a discussion thread

Parameters

Name	Type	Description
thread_id	string	Thread ID
content	string	Reply content

Example

$"Reply to the latest thread: Thanks for the feedback!"

Returns

Created reply with ID

list_unread_replies

Get recent replies since your last check

Parameters

Name	Type	Description
project_id	string	Project ID or slug (optional)

Example

$"Show unread replies"

Returns

Array of new replies across your projects

Notifications

Manage your notifications

list_notifications

Get your notifications

Parameters

Name	Type	Description
unread_only	boolean	Only show unread (optional)
limit	number	Max notifications (optional)

Example

$"Show my notifications"

Returns

Array of notifications with type, message, and timestamp

mark_notifications_read

Mark notifications as read

Parameters

Name	Type	Description
notification_ids	string[]	IDs to mark read (optional, marks all if empty)

Example

$"Mark all notifications as read"

Returns

Count of marked notifications

Feature Status Values

When working with features, use these status values:

💡

idea

Community suggestion

📅

planned

Scheduled for development

🔨

in_progress

Currently being built

🚀

shipped

Live and available

Tips for Natural Language

When using Claude Code, you don't need to know the exact tool names. Just describe what you want naturally:

"Show my projects" → list_projects
"Post an update saying we shipped dark mode" → post_update
"Move the auth feature to done" → update_feature_status
"Reply to that thread with thanks" → reply_to_thread