# Honeybadger — how to use (mcp.ai)

Connect your Honeybadger account and use 7 tools for server monitoring straight from your AI agent. Connect with your own API key. Honeybadger is an error tracking and application performance monitoring service for developers.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_honeybadger?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `honeybadger_report_check_in`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/honeybadger`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/honeybadger/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/honeybadger/report/check/in` — Reports a check-in (ping) to Honeybadger for uptime monitoring. Check-ins are used to monitor scheduled tasks, cron jobs, and background processes. By pinging this endpoint regularly, you signal that 
  - body: { id?: string, slug?: string, project_api_key?: string }
- `POST https://api.mcp.ai/api/honeybadger/report/check/in/with/payload` — Report a check-in with additional payload data to Honeybadger. Use when monitoring scheduled tasks or cron jobs and need to send metrics, status, or metadata (up to 20KB).
  - body: { check_in: object, check_in_id: string }
- `POST https://api.mcp.ai/api/honeybadger/report/deployment` — Report a new deployment to Honeybadger for deployment tracking and error correlation. Use this tool after deploying code to notify Honeybadger, which allows you to: - Track deployment history on your 
  - body: { deploy: object }
- `POST https://api.mcp.ai/api/honeybadger/report/event` — Send custom events to Honeybadger Insights for tracking, monitoring, and analytics. Use this action to record any structured event data such as: - User activity and behavioral events (logins, page vie
  - body: { events: object[] }
- `POST https://api.mcp.ai/api/honeybadger/report/exception` — Tool to report an exception notice to Honeybadger. Use when sending error details (stack trace, context) for diagnostics.
  - body: { error: object, server?: object, request?: object, notifier?: object, breadcrumbs?: object }
- `POST https://api.mcp.ai/api/honeybadger/upload/file/to/s3` — Tool to upload a local file to a managed S3 bucket. Use when preparing files for source-map uploads.
  - body: { file: object, desired_name?: string }
- `POST https://api.mcp.ai/api/honeybadger/upload/source/map` — Upload JavaScript source maps to Honeybadger for error stack trace de-minification. Use this tool after deploying minified JavaScript assets to enable Honeybadger to display un-minified, readable stac
  - body: { revision?: string, source_map: object, minified_url: string, minified_file: object, additional_source_files?: object[] }

## Example prompts
- "What can I do in Honeybadger?"
- "Show me a summary of my Honeybadger account"

## More
- Page: https://mcp.ai/honeybadger
- Agent spec (llms.txt): https://mcp.ai/honeybadger/llms.txt
- Postman collection: https://mcp.ai/honeybadger/postman.json
