# Exceptionless — how to use (mcp.ai)

Connect your Exceptionless account and use 4 tools for developer tools straight from your AI agent. Connect with your own API key. Exceptionless provides one-project event ingestion and client configuration using a project-bound client API key.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_exceptionless?ms=1787291460000`
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. `exceptionless_close_session`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/exceptionless`
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/exceptionless/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/exceptionless/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.
  - body: { session_id: string }
- `POST https://api.mcp.ai/api/exceptionless/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 need
- `POST https://api.mcp.ai/api/exceptionless/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.
  - body: { data?: object, tags?: string[], type: string, source: string, message: string }
- `POST https://api.mcp.ai/api/exceptionless/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 
  - body: { session_id: string }

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

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