{"id":50875293,"url":"https://github.com/todevelopers/fogbugz-mcp","last_synced_at":"2026-06-15T09:03:08.547Z","repository":{"id":351342789,"uuid":"1151450147","full_name":"todevelopers/fogbugz-mcp","owner":"todevelopers","description":"MCP server for FogBugz — supports both XML API (legacy) and JSON API (v9+) with auto-detection. Works with on-premise and on-demand installations.","archived":false,"fork":false,"pushed_at":"2026-04-14T15:38:59.000Z","size":405,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T17:16:38.284Z","etag":null,"topics":["claude","claude-code","claude-cowork","claude-desktop","fogbugz","issue-tracker","mcp","mcp-server","model-context-protocol","project-management"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/todevelopers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-06T13:36:26.000Z","updated_at":"2026-04-14T15:39:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/todevelopers/fogbugz-mcp","commit_stats":null,"previous_names":["todevelopers/fogbugz-mcp"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/todevelopers/fogbugz-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todevelopers%2Ffogbugz-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todevelopers%2Ffogbugz-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todevelopers%2Ffogbugz-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todevelopers%2Ffogbugz-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/todevelopers","download_url":"https://codeload.github.com/todevelopers/fogbugz-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/todevelopers%2Ffogbugz-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34355181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","claude-code","claude-cowork","claude-desktop","fogbugz","issue-tracker","mcp","mcp-server","model-context-protocol","project-management"],"created_at":"2026-06-15T09:03:07.719Z","updated_at":"2026-06-15T09:03:08.524Z","avatar_url":"https://github.com/todevelopers.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"icon.png\" width=\"64\" alt=\"FogBugz MCP Server icon\" /\u003e FogBugz MCP Server\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/tommy-gun/6c206a2756e6294e7f635c9b89a7d20f/raw/fogbugz-mcp-tests.json\u0026cacheSeconds=0\" alt=\"Test count\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/package-json/v/todevelopers/fogbugz-mcp\" alt=\"Version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/todevelopers/fogbugz-mcp\" alt=\"License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/node-%3E%3D20-brightgreen\" alt=\"Node\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MCP-compatible-blue\" alt=\"MCP\" /\u003e\n\u003c/p\u003e\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that connects AI assistants to a live [FogBugz](https://www.fogbugz.com/) instance. Search and manage cases, track history, assign and resolve — all from a natural language conversation. Works with on-premise and on-demand FogBugz installations.\n\n## Features\n\n- **Search and list cases** using FogBugz query syntax (e.g. `project:Website status:Active`)\n- **Read case details** including full event and comment history\n- **Create and update cases** — set title, project, area, milestone, priority, and comments\n- **Full lifecycle management** — assign, resolve, reopen, and close cases\n- **User, project, and area discovery** — list people, categories, projects, milestones, and statuses\n- **Create new projects** directly from the conversation\n- **Automatic API selection** — detects your FogBugz version and switches between XML and JSON API automatically\n\n## Requirements\n\n- FogBugz (on-premise or on-demand)\n- Node.js 20 or later\n- A FogBugz API token\n\n## Getting a FogBugz API Token\n\nYou need an API token to authenticate the MCP server with FogBugz. There are two ways to obtain one:\n\n### Via the web UI\n\nGo to **Account \u0026 Settings → User Options** and click the **Create API Token** link.\n\nSee the official guide: [Create API Token using the FogBugz UI](https://support.fogbugz.com/article/52425-create-api-token-using-the-fogbugz-ui)\n\n### Via API request\n\nSend the following request (replace placeholders with your values):\n\n```\nhttps://[your-fogbugz-server]/api.asp?cmd=logon\u0026email=[your-email]\u0026password=[your-password]\n```\n\nThe response will contain your API token.\n\nSee the official guide: [Get an API Token using FogBugz API commands](https://support.fogbugz.com/article/55717-get-an-api-token-using-fogbugz-api-commands)\n\n---\n\n## AI Client Setup\n\nMCP is an open standard — this server works with any MCP-compatible AI client. Configuration varies by client.\n\n### Claude Desktop ✓ (tested)\n\n**One-click install:** Download the latest `.mcpb` package from the [Releases](https://github.com/todevelopers/fogbugz-mcp/releases) page and open it — Claude Desktop will install and configure the server automatically, prompting you for your FogBugz URL and API token.\n\n**Manual configuration:** Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"fogbugz\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@todevs/fogbugz-mcp\"],\n      \"env\": {\n        \"FOGBUGZ_URL\": \"https://your-fogbugz-server.com\",\n        \"FOGBUGZ_API_KEY\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code ✓ (tested)\n\nAdd to `.mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"fogbugz\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@todevs/fogbugz-mcp\"],\n      \"env\": {\n        \"FOGBUGZ_URL\": \"https://your-fogbugz-server.com\",\n        \"FOGBUGZ_API_KEY\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### Other MCP-compatible clients\n\nAny client that supports MCP stdio servers should work. Consult your client's documentation for how to register a stdio MCP server with environment variables. The server entry point is `npx @todevs/fogbugz-mcp` (or `node /path/to/dist/index.js` for a local build).\n\n---\n\n## Tools\n\n### Case Management\n\n| Tool           | Description                                                                  |\n| -------------- | ---------------------------------------------------------------------------- |\n| `create_case`  | Create a new case                                                            |\n| `update_case`  | Update an existing case (title, comment, project, area, milestone, priority) |\n| `assign_case`  | Assign a case to a user                                                      |\n| `resolve_case` | Resolve (mark as fixed/completed) a case                                     |\n| `reopen_case`  | Reopen a resolved or closed case                                             |\n| `close_case`   | Close a case                                                                 |\n\n### Search \u0026 View\n\n| Tool            | Description                                                              |\n| --------------- | ------------------------------------------------------------------------ |\n| `search_cases`  | Search using FogBugz query syntax (e.g. `project:Website status:Active`) |\n| `list_my_cases` | List cases assigned to a user (defaults to current user)                 |\n| `get_case`      | Get detailed case info including full event/comment history              |\n| `get_case_link` | Get a direct URL to a case                                               |\n\n### Reference Data\n\n| Tool              | Description                                                    |\n| ----------------- | -------------------------------------------------------------- |\n| `list_people`     | List all users with IDs, names, and emails                     |\n| `list_categories` | List case categories (Bug, Feature Request, etc.)              |\n| `list_projects`   | List all active projects with IDs and names                    |\n| `list_milestones` | List milestones/fix-fors, optionally by project                |\n| `list_statuses`   | List case statuses with resolved flags, optionally by category |\n| `view_project`    | Get detailed project information                               |\n| `view_area`       | Get detailed area information                                  |\n| `create_project`  | Create a new project                                           |\n\n### Advanced\n\n| Tool          | Description                                                                                                                                                                                                           |\n| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `api_request` | Generic XML API escape-hatch for commands not covered by dedicated tools.\u003cbr/\u003e⚠️ WARNING: can execute any API command the configured key permits, including destructive operations (delete, edit users, bulk modify). |\n\n---\n\n## Usage Examples\n\n### Example 1: Finding open bugs in a project\n\n**You:** \"Show me all open bugs in the Website project assigned to nobody.\"\n\n**Claude calls:** `search_cases` with query `project:Website status:Active assignedTo:nobody category:Bug`.\n\n**Result:** A list of unassigned bugs with their IDs, titles, and creation dates — ready to triage or assign.\n\n---\n\n### Example 2: Creating a case from a bug report\n\n**You:** \"Create a bug in the Mobile project titled 'Login button unresponsive on iOS 17', assign it to alice, and set priority to 2.\"\n\n**Claude calls:** `create_case` with project, title, assignee, and priority set in a single call, then `get_case_link` to return a direct URL.\n\n**Result:** New case created. Claude confirms the case number and provides a link.\n\n---\n\n### Example 3: Resolving a case with a closing comment\n\n**You:** \"Resolve case 1042 and add a comment saying the fix was deployed in v3.5.1.\"\n\n**Claude calls:** `resolve_case` with the case ID and a comment describing the fix.\n\n**Result:** Case resolved. Claude confirms the status change and the comment was saved.\n\n---\n\n### Example 4: Reviewing your team's workload\n\n**You:** \"What open cases does bob have right now?\"\n\n**Claude calls:** `list_people` to find Bob's user ID, then `list_my_cases` filtered to that user.\n\n**Result:** A summary of Bob's active cases grouped by project, with priorities and due dates.\n\n---\n\n### Example 5: Updating a case after a code review\n\n**You:** \"Move case 987 to the Backend project, change the milestone to v4.0, and leave a comment saying it was re-scoped after the architecture review.\"\n\n**Claude calls:** `update_case` with the new project, milestone, and comment all set in one call.\n\n**Result:** Case updated. Claude confirms each field change.\n\n---\n\n## How It Works\n\nThis server implements the [Model Context Protocol](https://modelcontextprotocol.io/) over stdio. The AI client translates natural language requests into FogBugz queries or API calls, invokes the appropriate tool, and presents the results. The server is a thin proxy — it passes requests directly to your FogBugz instance and returns the response.\n\n### API Auto-Detection\n\nAt startup the server automatically selects the right API client for your FogBugz instance:\n\n1. Probes `/api.xml` to read the FogBugz version number.\n2. If version ≥ 9, attempts to reach the JSON API (`/f/api/0/jsonapi`) — uses `FogBugzJsonClient` on success.\n3. Falls back to `FogBugzXmlClient` (XML API via `/api.asp`) for version \u003c 9 or if the JSON endpoint is unreachable.\n\n| FogBugz version             | API used                      |\n| --------------------------- | ----------------------------- |\n| ≥ 9 (JSON API available)    | JSON API (`/f/api/0/jsonapi`) |\n| \u003c 9 or JSON API unreachable | XML API (`/api.asp`)          |\n\n\u003e **Note on text formatting:** Plain text only is supported in descriptions and comments when connected to FogBugz 8.x via the XML API. HTML and Markdown are stored and displayed literally.\n\n---\n\n## Configuration Reference\n\n| Variable          | Required | Description                                                             |\n| ----------------- | -------- | ----------------------------------------------------------------------- |\n| `FOGBUGZ_URL`     | Yes      | Base URL of your FogBugz instance (e.g. `https://company.fogbugz.com`) |\n| `FOGBUGZ_API_KEY` | Yes      | FogBugz API token                                                       |\n\n## Installation\n\n### Via npx (no install needed)\n\n```bash\n# Latest stable release\nnpx @todevs/fogbugz-mcp\n\n# Latest dev build (pre-release)\nnpx @todevs/fogbugz-mcp@dev\n```\n\n### From source\n\n```bash\ngit clone https://github.com/todevelopers/fogbugz-mcp.git\ncd fogbugz-mcp\nnpm install\nnpm run build\nnode dist/index.js https://your-fogbugz-server.com your-api-token\n```\n\n## Development\n\n```bash\nnpm run dev    # run via ts-node (no build needed)\nnpm run build  # compile TypeScript to dist/\nnpm test       # run all Jest tests\n```\n\n## Compatibility\n\n- FogBugz on-premise and on-demand (tested with FogBugz 8.8.53 via XML API)\n- Node.js 20+\n\n## Privacy Policy\n\nThis server does not collect, store, or transmit any data to ToDevelopers or any third party. All communication is directly between your AI client and your own FogBugz instance using the URL and credentials you provide. No usage data, case content, or credentials are sent anywhere other than your configured FogBugz server.\n\nFor complete privacy information, see the [FogBugz Privacy Policy](https://trial.fogbugz.com/privacy-policy).\n\n## Acknowledgements\n\nThis project is based on the original work by [Sarasvati Akari Lara-Almeida](https://github.com/akari2600/fogbugz-mcp) — thank you for the foundation.\n\n## License\n\n[MIT](LICENSE) © Tomáš Gažovič, ToDevelopers s.r.o.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftodevelopers%2Ffogbugz-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftodevelopers%2Ffogbugz-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftodevelopers%2Ffogbugz-mcp/lists"}