Tugboat MCP Server

What is Tugboat MCP Server?

A Model Context Protocol (MCP) server for interacting with the Tugboat API. It allows AI assistants like Claude and Cursor to access and manipulate Tugboat resources—projects, previews, and repositories—through the standardized MCP interface.

How to use Tugboat MCP Server?

Install by cloning the repository and running npm install && npm run build. Set the required environment variable TUGBOAT_API_KEY (and optionally TRANSPORT_TYPE, PORT, TUGBOAT_API_URL). Configure the server as an MCP tool in Claude Desktop or Cursor using the provided JSON/command template, or run it directly with HTTP transport for API access.

Key features of Tugboat MCP Server

• Access Tugboat projects, previews, and repositories
• Create, build, refresh, and delete previews
• Search for Tugboat resources
• View preview logs
• Support for both stdio and HTTP transports
• Authentication and authorization support

Use cases of Tugboat MCP Server

• List all Tugboat projects and their details
• Create a new preview from a specific repository branch
• Check logs for a running or building preview
• Update project settings or repository configurations
• Search previews by query and state

FAQ from Tugboat MCP Server

What is required to use this server?

You need a Tugboat API key set as the TUGBOAT_API_KEY environment variable. The server also requires Node.js and npm for installation.

Which transports are supported?

The server supports both stdio (default) and HTTP transports. The transport type is set via the TRANSPORT_TYPE environment variable. Stdio is used by Claude Desktop and Cursor; HTTP allows direct API calls.

How do I authenticate with the HTTP transport?

Send a POST request to http://localhost:3000/auth/login to receive a token, then include that token as a Bearer token in the Authorization header for subsequent MCP requests.

Can I use this server with Claude Desktop?

Yes. Configure the server in claude_desktop_config.json with the command and TUGBOAT_API_KEY environment variable. After restarting Claude Desktop, the tool will appear and can be used via natural language prompts.

What resources and tools are exposed?

Resources include projects, previews, repositories, and logs (e.g., tugboat://projects, tugboat://preview/{id}/logs). Tools cover CRUD operations for projects, previews, and repositories, plus search, build, clone, and statistics retrieval.