get_sampleLABSCO SUMMARY
The error data comes to the debugging session.
Filtering by exception name and action within a time window is the query you actually make when something broke overnight — and count_only answers 'how widespread is it' without pulling the samples back.
What it is
A Bun MCP server over AppSignal's Error and Performance Monitoring APIs. Two calls: fetch one sample by id, or search an application's samples with filters for type, exception name, action, time window and result count.
What you get
- One error or performance sample fetched by sampleId and appId
- Samples searched across an application — errors, performance, or both
- Filtering by exception name, and by action_id
- A time window set with since and before, as a timestamp or in ISO format
- A result limit, or count_only to get the number without the samples
Requirements
An AppSignal account, an API token in APPSIGNAL_API_TOKEN or handed over on the launch command, and the application id from your AppSignal dashboard. It runs on the Bun runtime.
Setup effort
Build from source — clone the repository, then follow the project's own run instructions
USE CASES
01
Working out how widespread an error is
Search by exception name across the window, with count_only for the number alone.
02
Reading one failure in full
Fetch the sample by id once the search has narrowed things down.
03
Tying an error to the endpoint that raises it
Filter by action_id instead of reading every sample.
04
Checking whether a deploy made things worse
Set since and before around the deploy and compare the counts.
2 tools
Listed in project docs. Your client may show a different list.
search_samplesBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- bun on PATH
- APPSIGNAL_API_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
bun run startMCP Clients
Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"appsignal-mcp": {
"type": "stdio",
"command": "bun",
"args": [
"run",
"start"
],
"env": {
"APPSIGNAL_API_TOKEN": "<YOUR_APPSIGNAL_API_TOKEN>"
}
}
}
}
