FogBugz MCP Server

A Model Context Protocol (MCP) server for interacting with FogBugz through Language Learning Models (LLMs) such as Claude.

Overview

This server allows LLMs to perform various operations on FogBugz including:

Creating new issues/cases with optional attachments
Updating existing cases (changing project, area, milestone, priority)
Assigning cases to specific users
Listing a user's open cases
Getting direct links to specific cases
Searching for cases by various criteria

The server implements the Model Context Protocol (MCP) specification, allowing it to be used by any MCP-compatible LLM client.

Project Background

This project was initiated with the help of OpenAI's o3-mini-high model, which generated a comprehensive development plan (see DEVELOPMENT-PLAN.md in the repository). The plan outlined the architecture, tools, and implementation details for building a FogBugz MCP server in TypeScript.

The detailed specification served as a blueprint for the development team, demonstrating how AI can effectively assist in the early phases of project design and planning. This project is both an example of AI-assisted development and a tool that enhances AI capabilities through the MCP protocol.

Installation

# Install from npm
npm install -g fogbugz-mcp

# Or use directly with npx
npx fogbugz-mcp <fogbugz-url> <api-key>

Usage

Basic Usage

# Run with command line arguments
fogbugz-mcp https://yourcompany.fogbugz.com your-api-key

# Or use environment variables
export FOGBUGZ_URL=https://yourcompany.fogbugz.com
export TEST_FOGBUGZ_API_KEY=your-api-key
fogbugz-mcp

Development

# Clone the repository
git clone https://github.com/yourusername/fogbugz-mcp.git
cd fogbugz-mcp

# Install dependencies
npm install

# Create a .env file with your FogBugz credentials
echo "FOGBUGZ_URL=https://yourcompany.fogbugz.com" > .env
echo "TEST_FOGBUGZ_API_KEY=your-api-key" >> .env

# Run API explorer to test FogBugz API
npm run explore

# Run the development version of the server
npm run dev

# Run tests
npm test

# Build the project
npm run build

API Explorer

The project includes an API explorer tool for testing FogBugz API endpoints directly:

# Run all API tests
npm run explore

# Run a specific test (by index)
npm run explore 0  # Run the first test

MCP Tools

This server provides the following MCP tools for LLMs:

fogbugz_create_case - Create a new FogBugz case
fogbugz_update_case - Update an existing case's fields
fogbugz_assign_case - Assign a case to a specific user
fogbugz_list_my_cases - List cases assigned to a specific user
fogbugz_search_cases - Search for cases using a query string
fogbugz_get_case_link - Get a direct link to a specific case

License

ISC

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables Language Learning Models to interact with FogBugz, allowing operations like creating and updating issues, assigning cases, listing open cases, and searching through natural language.

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
Python
MIT License
Bonsai-mcp
JotaDeRodriguez
-
security
A
license
-
quality
A Model Context Protocol server that integrates Claude with Blender, enabling users to analyze and interact with IFC (Industry Foundation Classes) building models through natural language commands.
Last updated -
9
Python
MIT License
Wordware MCP
aleksandrkrivolap
-
security
F
license
-
quality
A Model Context Protocol server that bridges AI assistants like Claude with Wordware's specialized agent capabilities, allowing dynamic loading and access to any Wordware flow through a standardized interface.
Last updated -
Python
Linear MCP Server
magarcia
-
security
A
license
-
quality
A Model Context Protocol server that enables large language models to interact with Linear's issue tracking system, allowing management of issues, projects, teams, and other Linear resources.
Last updated -
TypeScript
MIT License

View all related MCP servers

FogBugz MCP Server