Exceptionless
Exceptionless provides one-project event ingestion and client configuration using a project-bound client API key.
Verdict
Common use cases
- Log feature-flag toggles during release planning
- Submit error events from incident postmortems
- Track session heartbeats for uptime reviews
- Close stale sessions after deployment windows
- Retrieve project config when debugging telemetry
Integration
- Vendor
- Exceptionless
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 4
- Composio slug
exceptionless
Tools
- Close Session
Close an active session in the Exceptionless project bound to the connected client API key. This records irreversible session-closure telemetry and returns only an acceptance confirmation.
- Get Client Configuration
Return the configuration for the single Exceptionless project bound to the connected client API key. Configuration values can contain sensitive project settings; request and expose them only when needed.
- Submit Event
Submit one structured telemetry event to the Exceptionless project bound to the connected client API key. Acceptance is asynchronous and does not confirm that the event was processed or persisted.
- Submit Session Heartbeat
Record an active session heartbeat in the Exceptionless project bound to the connected client API key. Use Close Session separately when the session ends. Despite using GET upstream, this tool writes telemetry.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations. 2. Find Exceptionless in the developer tools section and click Connect. 3. In a new tab, log into your Exceptionless dashboard and go to Project Settings > API Keys. 4. Copy the API key for the project you want to monitor. 5. Paste the key into Switchy's connection dialog and click Authorize. 6. Switchy confirms the connection by fetching your project configuration. 7. Open any Project in Switchy and type '@Exceptionless submit an error event with message test connection' to verify the integration works. 8. Check your Exceptionless dashboard to confirm the test event appears in the event stream. 9. If you monitor multiple Exceptionless projects, repeat these steps with a different API key for each.
What teammates see: by default, memories from Exceptionless are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Log Deployment Event
@Exceptionless submit a feature usage event with type 'deployment' and message 'v2.4.0 deployed to production'. Include a custom property 'environment' set to 'prod'.
Report Critical Error
@Exceptionless submit an error event with message 'Payment gateway timeout' and stack trace from the last incident. Tag it 'critical' and 'billing'.
Check Project Settings
@Exceptionless get the client configuration for this project and summarize the data retention settings and enabled integrations.
Close Abandoned Session
@Exceptionless close the session with ID 'abc123xyz' that was left open after last night's server restart.
Heartbeat Active Session
@Exceptionless submit a session heartbeat for session ID 'def456uvw' to record that the background worker is still running.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Exceptionless show me the current project configuration including data exclusions and session tracking settings
Retrieved configuration for project 'Production API Monitor'. Session tracking is enabled with a 30-second heartbeat interval. Data exclusions are active for fields matching 'password', 'token', and 'creditCard'. Storage limit is set to 3,000 events per day with a 90-day retention window. Note that this configuration contains sensitive project settings—review carefully before sharing with teammates or external tools.
This example demonstrates read-only configuration retrieval. The MCP returns settings for exactly one project tied to your API key—you cannot query multiple projects or switch context. Configuration values may include sensitive thresholds or exclusion patterns that reveal your monitoring strategy.
@Exceptionless submit an error event for a failed database connection in the checkout service with stack trace and user context
Submitted error event to Exceptionless. Event type: error. Message: 'Database connection timeout in checkout service'. Included stack trace (12 frames), user context (ID: user_89234, email: redacted), and environment tags (service: checkout, region: us-east-1). Exceptionless accepted the event for asynchronous processing—confirmation does not guarantee the event was persisted or will appear in your dashboard immediately.
This write example shows telemetry submission. The MCP accepts the event but returns only an acknowledgment—Exceptionless processes events asynchronously, so you won't see immediate confirmation of storage or indexing. Rate limits apply per your plan tier; burst submissions may be throttled or dropped.
@Exceptionless record a session heartbeat for user session abc-7829 and then summarize what active session tracking tells us about current system health
Recorded heartbeat for session 'abc-7829' at 14:32 UTC. Session has been active for 8 minutes with 4 prior heartbeats. Based on Exceptionless session tracking patterns, active sessions indicate real-time user engagement—frequent heartbeats with no error events suggest stable client connectivity, while gaps or missing heartbeats often precede crash reports or network issues. This session shows consistent 30-second intervals, aligning with healthy client behavior.
This synthesis example pairs a write action (heartbeat recording) with AI reasoning about session health patterns. The heartbeat write is irreversible and contributes to your event quota. The AI's interpretation is illustrative—actual session health analysis requires querying your Exceptionless dashboard for aggregate metrics across all sessions.
Use-case deep-dives
When Exceptionless MCP helps support triage production crashes
A 3-person support team fields customer complaints about intermittent crashes in a SaaS product. The Exceptionless MCP lets them submit structured events from Switchy when a customer reports an issue—tagging the event with ticket ID, user context, and reproduction steps—so engineering sees the full picture without Slack back-and-forth. The MCP's 4 tools cover the core workflow: submit events, check project config to confirm the right environment is logging, and close sessions when a repro attempt finishes. This works when your support volume is under 50 tickets a day and your team already uses Exceptionless for error tracking. If you're triaging hundreds of issues daily or need cross-project visibility, the single-project API key becomes a bottleneck. For small teams consolidating error context in one workspace, this MCP closes the loop between support and engineering.
Why this MCP fits lean on-call rotations
A 5-engineer startup runs a weekly on-call rotation. When an alert fires at 2am, the on-call engineer opens Switchy, pulls logs from other MCPs, and uses Exceptionless to submit a structured event capturing the incident timeline, affected endpoints, and mitigation steps. The session heartbeat tool keeps the incident session alive while they investigate; closing the session marks resolution. This pattern works because Exceptionless is already their error aggregator, and the MCP's API key scopes to one project—no risk of cross-contaminating staging and production events. The trade-off: if your on-call process spans multiple services or projects, the single-key constraint means you'll toggle API keys or skip the MCP entirely. For teams with one primary production project and fewer than 10 incidents a month, this MCP turns Switchy into a lightweight incident journal.
When Exceptionless MCP streamlines manual QA workflows
A 2-person QA team runs exploratory testing sessions before each release. They use Switchy to coordinate test coverage, and the Exceptionless MCP to log session starts, submit events when they hit a bug, and close sessions when a test pass finishes. The session heartbeat tool keeps long QA runs from timing out. This setup shines when your QA cycle is under 20 hours a week and your team already tags Exceptionless events with release metadata. The MCP's 4 tools map cleanly to the session lifecycle, and the API key constraint enforces single-project discipline—no accidental cross-environment pollution. If your QA process involves parallel testing across staging, canary, and production, the one-key-per-project model breaks down fast. For small teams doing serial, focused QA on a single environment, this MCP turns ad-hoc bug reports into structured telemetry without leaving the workspace.
Frequently asked
What does the Exceptionless MCP do in Switchy?
It lets AI agents submit error telemetry, session heartbeats, and structured events directly to your Exceptionless project. Agents can also close sessions and fetch project configuration when troubleshooting or monitoring application health. All writes go to the single project your API key is scoped to.
Do I need admin access to connect Exceptionless?
You need an API key with write permissions to the target Exceptionless project. The MCP binds to one project per key, so generate a dedicated client key in your project settings rather than using your personal admin token. This keeps the blast radius small if the key leaks.
Can the MCP read historical events or search past errors?
No. The four tools only write telemetry or fetch live configuration. If you need to query past events, filter stack traces, or pull analytics, use Exceptionless's web dashboard or REST API directly. The MCP is designed for agents that generate telemetry, not consume it.
Why use this instead of calling the Exceptionless API from code?
Use the MCP when you want AI agents to log errors or session state without writing custom integration code. If your app already instruments Exceptionless via SDK, you don't need this. The MCP shines when agents run workflows that should report telemetry but don't live inside your codebase.
Who on the team should connect the Exceptionless MCP?
Whoever owns the Exceptionless project and can generate a scoped API key. Typically that's a backend engineer or DevOps lead. Once connected in Switchy, any team member can invoke the tools in prompts, but all events land in the same project the key points to.