{"id":50512494,"url":"https://github.com/bugfender/bugfender-mcp","last_synced_at":"2026-06-02T21:03:36.855Z","repository":{"id":354595583,"uuid":"1186716519","full_name":"bugfender/bugfender-mcp","owner":"bugfender","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-29T09:04:57.000Z","size":117,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T09:13:42.315Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bugfender.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-03-19T23:14:19.000Z","updated_at":"2026-04-29T09:05:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bugfender/bugfender-mcp","commit_stats":null,"previous_names":["bugfender/bugfender-mcp"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/bugfender/bugfender-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugfender%2Fbugfender-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugfender%2Fbugfender-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugfender%2Fbugfender-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugfender%2Fbugfender-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bugfender","download_url":"https://codeload.github.com/bugfender/bugfender-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugfender%2Fbugfender-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33835766,"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-02T02:00:07.132Z","response_time":109,"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":[],"created_at":"2026-06-02T21:03:36.146Z","updated_at":"2026-06-02T21:03:36.847Z","avatar_url":"https://github.com/bugfender.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `@bugfender/mcp`\n\nBugfender MCP server for local stdio clients such as Cursor, Claude Code, Codex, and Gemini CLI.\n\n## What It Provides\n\n- user-scoped Bugfender read access through MCP\n- automatic access-token refresh when a refresh token is configured\n- logs, devices, app metadata, crash aggregation, and issue aggregation tools\n- SDK snippet retrieval for app onboarding\n- resource templates for snippets, logs, and issue groups\n- companion Bugfender skills distributed from `bugfender/bugfender-skills`\n\n## Maintainers\n\n- development workflow: [DEVELOPMENT.md](./DEVELOPMENT.md)\n- release and publish flow: [RELEASING.md](./RELEASING.md)\n\n## Install\n\n```bash\nnpx -y @bugfender/mcp\n```\n\nAfter adding or updating the MCP server in your IDE or agent, restart that client so it reloads the new MCP configuration cleanly.\n\nIf you are running from inside this repository checkout, do not use `npx @bugfender/mcp` or `npx -p @bugfender/mcp bugfender-mcp`. npm can resolve the current package instead of the published tarball and fail with `bugfender-mcp: not found`.\n\nFor local development, build and run the generated entrypoint directly:\n\n```bash\npnpm build\npnpm start\n```\n\n## Configuration\n\n- `BUGFENDER_API_TOKEN`: required access token\n- `BUGFENDER_REFRESH_TOKEN`: recommended for automatic token refresh\n- `BUGFENDER_API_URL`: optional override, defaults to `https://dashboard.bugfender.com/api`\n- `~/.bugfender/mcp.json`: optional config file and local token store for rotated credentials\n\n```json\n{\n  \"default\": {\n    \"apiToken\": \"YOUR_ACCESS_TOKEN\",\n    \"refreshToken\": \"YOUR_REFRESH_TOKEN\",\n    \"apiUrl\": \"https://dashboard.bugfender.com/api\"\n  }\n}\n```\n\nWhen a refresh token is provided, the MCP stores rotated credentials in `~/.bugfender/mcp.json` so automatic refresh survives restarts. Updating the IDE config with a newly generated refresh token resets that local state.\n\nIf you are using local or self-hosted Bugfender credentials, `BUGFENDER_API_URL` must point to the matching backend. For example, local credentials generated from `https://dashboard:3000` will not work against `https://dashboard.bugfender.com/api`.\n\n## Cursor / Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"bugfender\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bugfender/mcp\"],\n      \"env\": {\n        \"BUGFENDER_API_TOKEN\": \"YOUR_ACCESS_TOKEN\",\n        \"BUGFENDER_REFRESH_TOKEN\": \"YOUR_REFRESH_TOKEN\",\n        \"BUGFENDER_API_URL\": \"https://dashboard.bugfender.com/api\"\n      }\n    }\n  }\n}\n```\n\n## Codex CLI\n\n```bash\ncodex mcp add bugfender \\\n  --env BUGFENDER_API_TOKEN='YOUR_ACCESS_TOKEN' \\\n  --env BUGFENDER_REFRESH_TOKEN='YOUR_REFRESH_TOKEN' \\\n  --env BUGFENDER_API_URL='https://dashboard.bugfender.com/api' \\\n  -- npx -y @bugfender/mcp\n```\n\nAfter running `codex mcp add`, restart the Codex session before testing `who_am_i` or `list_apps`.\n\n## Gemini CLI\n\n```bash\ngemini mcp add bugfender npx -y @bugfender/mcp \\\n  --env BUGFENDER_API_TOKEN='YOUR_ACCESS_TOKEN' \\\n  --env BUGFENDER_REFRESH_TOKEN='YOUR_REFRESH_TOKEN' \\\n  --env BUGFENDER_API_URL='https://dashboard.bugfender.com/api'\n```\n\nAfter running `gemini mcp add`, start a new Gemini CLI session or reload MCP servers before testing `who_am_i` or `list_apps`.\n\n## Codex App\n\nIn the custom MCP server form:\n\n- `Name`: `bugfender`\n- `Command to launch`: `npx`\n- `Argument 1`: `-y`\n- `Argument 2`: `@bugfender/mcp`\n- `BUGFENDER_API_TOKEN`: `YOUR_ACCESS_TOKEN`\n- `BUGFENDER_REFRESH_TOKEN`: `YOUR_REFRESH_TOKEN`\n- `BUGFENDER_API_URL`: `https://dashboard.bugfender.com/api`\n\nAdd the arguments as separate rows, not as one combined string.\n\nAfter saving the server, restart the app before testing `who_am_i` or `list_apps`.\n\n## Tools\n\n- `who_am_i`\n- `list_teams`\n- `list_apps`\n- `get_app`\n- `list_app_versions`\n- `get_sdk_snippet`\n- `get_crashes`\n- `get_crash_stats`\n- `get_crash_device_stats`\n- `get_crash_details`\n- `search_logs`\n- `count_logs`\n- `count_devices_with_logs`\n- `get_network_aggregates`\n- `get_network_details`\n- `search_devices`\n- `count_devices`\n- `list_issues`\n- `get_issue`\n- `get_issue_stats`\n- `get_issue_device_stats`\n- `get_issue_devices`\n- `get_feedback`\n- `get_app_summary`\n\n## Resources\n\n- `bugfender://snippet/{app_id}/{platform}`\n- `bugfender://app/{app_id}/logs?...`\n- `bugfender://issue/{issue_id}?app_id={app_id}`\n\n## Companion Skills\n\nThe companion skills now live in the separate [`bugfender/bugfender-skills`](https://github.com/bugfender/bugfender-skills) repository. They encode opinionated workflows on top of the MCP tools:\n\n- use aggregation before logs\n- narrow time ranges early\n- size impact before deep-diving\n- end with a short triage summary\n\nThe MCP package gives the agent raw Bugfender capabilities. The skill adds an opinionated investigation workflow on top of those capabilities.\n\nUse the skill when you want Cursor, Codex, or Claude Code to do things like:\n\n- help set up the Bugfender SDK in an app with the minimum required steps\n- fetch the SDK snippet for a platform and explain exactly where it goes\n- investigate the top crashes in an app\n- summarize issue or feedback trends over a time range\n- compare impact before and after an app version\n- identify likely cause, scope, and next checks\n\nThe investigation skill source lives in:\n\n- `https://github.com/bugfender/bugfender-skills/tree/main/skills/bugfender`\n\n## SDK Setup Skill\n\nThe dedicated onboarding skill also lives in [`bugfender/bugfender-skills`](https://github.com/bugfender/bugfender-skills).\n\nUse it when you want Cursor, Codex, or Claude Code to:\n\n- detect the project platform automatically\n- fetch the correct Bugfender SDK snippet\n- map the setup to the real repository files\n- ask one short feature question when optional capabilities like crash reporting or Android logcat matter\n- apply the minimum integration changes\n- reduce the developer’s work to one final verification step\n\nIt also includes platform-specific references for:\n\n- iOS\n- Android\n- Flutter\n- Unity\n- .NET MAUI\n- Cordova\n- Ionic\n- Angular\n- React\n- Vue\n- JavaScript\n- jQuery\n- Titanium\n- Web\n- React Native\n\nThe skill source lives in:\n\n- `https://github.com/bugfender/bugfender-skills/tree/main/skills/bugfender-sdk-setup`\n\n## Install Skills In Cursor, Codex, Or Claude Code\n\nCursor, Codex, and Claude Code can install the skills directly from GitHub without cloning the repo manually.\n\nIn the agent chat inside your IDE, run this prompt with the built-in installer skill:\n\n```text\nUse $skill-installer to install these skills from https://github.com/bugfender/bugfender-skills:\n- skills/bugfender\n- skills/bugfender-sdk-setup\n```\n\nAfter installation, restart the client and use:\n\n```text\nUse $bugfender-sdk-setup to set up Bugfender in this app with the minimum required changes.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbugfender%2Fbugfender-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbugfender%2Fbugfender-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbugfender%2Fbugfender-mcp/lists"}