PHPackages                             leapfinder/laravel-bugherd-mcp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. leapfinder/laravel-bugherd-mcp

ActiveLibrary

leapfinder/laravel-bugherd-mcp
==============================

Laravel MCP server for the BugHerd API v2

v1.0.0(2mo ago)00MITPHPPHP ^8.2CI passing

Since Mar 6Pushed 2mo agoCompare

[ Source](https://github.com/leapfinder/laravel-bugherd-mcp)[ Packagist](https://packagist.org/packages/leapfinder/laravel-bugherd-mcp)[ Docs](https://github.com/leapfinder/laravel-bugherd-mcp)[ RSS](/packages/leapfinder-laravel-bugherd-mcp/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (7)Versions (2)Used By (0)

Laravel BugHerd MCP
===================

[](#laravel-bugherd-mcp)

[![Latest Version](https://camo.githubusercontent.com/afb6fb44f5727f38fffd1b65c5c35bfd7b7d2c7bcf361c07f9675890e4c46b54/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c65617066696e6465722f6c61726176656c2d627567686572642d6d6370)](https://packagist.org/packages/leapfinder/laravel-bugherd-mcp) [![Tests](https://github.com/leapfinder/laravel-bugherd-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/leapfinder/laravel-bugherd-mcp/actions) [![Coverage](https://camo.githubusercontent.com/32855e94577df9d0a30995653b17d33a5fbfdf644518f96ea0374313397d19b7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f7665726167652d3130302532352d627269676874677265656e)](https://github.com/leapfinder/laravel-bugherd-mcp) [![PHP](https://camo.githubusercontent.com/fe7da5ae1ecd188cdebe625c108d40cb3f2c65efaceaf0c993ff435debb1b158/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6c65617066696e6465722f6c61726176656c2d627567686572642d6d63702f706870)](composer.json) [![Laravel](https://camo.githubusercontent.com/fc16620f40913edfab569ef0c3b675e421994dbadf32fe2feb466213d6f7eb14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d31312e782d2d31322e782d726564)](composer.json) [![License: MIT](https://camo.githubusercontent.com/b8cadaa967891081f8f165695470689986c028821dd8a040132f6e661795dc0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c7565)](LICENSE)

A read-only [MCP](https://modelcontextprotocol.io) server for the [BugHerd API v2](https://www.bugherd.com/api_v2). Browse projects, review tasks, and read discussion threads from any MCP-compatible client.

Built with [Laravel MCP](https://laravel.com/docs/mcp).

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11 or 12
- `laravel/mcp` ^0.6
- A BugHerd API key

Installation
------------

[](#installation)

```
composer require leapfinder/laravel-bugherd-mcp
```

The service provider is auto-discovered. To publish the config file (optional):

```
php artisan vendor:publish --tag=bugherd-mcp-config
```

Add your BugHerd API key to `.env`:

```
BUGHERD_API_KEY=your_api_key_here

```

### Getting your API key

[](#getting-your-api-key)

In BugHerd, go to **Settings > General Settings**. Your API key is listed there. The key authenticates via HTTP Basic Auth (key as username, `x` as password). All requests use HTTPS.

MCP Client Setup
----------------

[](#mcp-client-setup)

Start the MCP server via Artisan:

```
php artisan mcp:start bugherd
```

The server communicates over stdio. Add it to your MCP client configuration - for example, in a `.mcp.json` file:

```
{
  "mcpServers": {
    "bugherd": {
      "type": "stdio",
      "command": "php",
      "args": ["artisan", "mcp:start", "bugherd"]
    }
  }
}
```

Available Tools
---------------

[](#available-tools)

ToolDescription`bugherd_list_projects`List all projects, optionally filtered to active only`bugherd_show_project`Get full details for a specific project`bugherd_list_tasks`List tasks with filters (status, priority, tag, assignee, date range)`bugherd_show_task`Get full task details including metadata and screenshot URLs`bugherd_list_comments`Get the full discussion thread for a task`bugherd_list_columns`Get the kanban board column structure for a projectAll tools are currently read-only. Results are paginated at 100 records per page.

BugHerd API Notes
-----------------

[](#bugherd-api-notes)

- **Rate limit**: 60 requests/minute average, bursts of 10. The client retries automatically on 429 responses.
- **Task statuses**: `backlog`, `todo`, `doing`, `done`, `closed`, or custom column names.
- **Task priorities**: `not set`, `critical`, `important`, `normal`, `minor`.
- **Pagination**: Use the `page` parameter. Max 100 records per response.

Roadmap
-------

[](#roadmap)

### v1.0 - Read-only tools (current)

[](#v10---read-only-tools-current)

- List and show projects
- List and show tasks (with filters)
- List comments
- List columns

### Planned

[](#planned)

- Create, update, and delete tasks
- Create comments
- List and manage users
- List and manage tags
- Webhook management
- Organization endpoints

Contributions welcome - see [CONTRIBUTING.md](CONTRIBUTING.md).

License
-------

[](#license)

MIT. See [LICENSE](LICENSE).

---

Built by [LeapFinder](https://leapfinder.com)

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance86

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

68d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8a0bd557441065df2de4f60ab4163e199e6f4c1601da75cb070c862ad77f9081?d=identicon)[tysonlist](/maintainers/tysonlist)

---

Top Contributors

[![tysonlist](https://avatars.githubusercontent.com/u/3150363?v=4)](https://github.com/tysonlist "tysonlist (1 commits)")

---

Tags

laravelmcpbug-trackingbugherd

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/leapfinder-laravel-bugherd-mcp/health.svg)

```
[![Health](https://phpackages.com/badges/leapfinder-laravel-bugherd-mcp/health.svg)](https://phpackages.com/packages/leapfinder-laravel-bugherd-mcp)
```

###  Alternatives

[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

71510.9M66](/packages/laravel-mcp)[tzsk/sms

A robust and unified SMS gateway integration package for Laravel, supporting multiple providers.

320244.3k6](/packages/tzsk-sms)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)[kerigard/laravel-lang-ru

Ru lang for Laravel

2116.8k](/packages/kerigard-laravel-lang-ru)[truckersmp/steam-socialite

Laravel Socialite provider for Steam OpenID.

1516.7k](/packages/truckersmp-steam-socialite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)