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

How are these scores calculated?

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

MongoDB MCP Server for LLMs
nickiiitu
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact directly with MongoDB databases, allowing users to query collections, inspect schemas, and manage data through natural language.
Last updated -
1,783
1
TypeScript
MIT License
MongoDB MCP Server for LLMs
vivek1612
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact directly with MongoDB databases, allowing users to query collections, inspect schemas, and manage data through natural language.
Last updated -
1,783
MIT License
MCP Database Server
manpreet2000
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
Last updated -
TypeScript
MIT License
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 -
554
TypeScript
MIT License

View all related MCP servers

FogBugz MCP Server