Set Up MCP Server

The elmah.io MCP server allows AI assistants to interact directly with your error logs, deployments, and organization statistics. By connecting your AI tools to elmah.io, you can debug production issues, analyze trends, and monitor your organization's health using natural language.

The MCP Server is available on the following URL:

https://mcp.elmah.io/mcp

MCP Authentication

The elmah.io MCP server uses OAuth2 to securely authorize your AI client. The authentication steps will vary from client to client, but all end up in a pop-up where you need to sign into elmah.io using either a username/password or with a social provider. Once signed in, a token will be generated for the MCP. The token is valid for 30 days. After the 30 days, your assistant will report an unauthorized error and you will need to re-authenticate.

If you need to call the MCP server from a script, CI/CD pipeline, or other automated context where browser sign-in is not practical, you can use an API key as a Bearer token instead. See Call MCP Server Using an API Key for details.

Setting up the MCP server in client

The elmah.io MCP server should be supported in all clients offering the OAuth flow. This documentation cover installation steps for a range of popular clients:

Claude Code
Claude Code
Claude Desktop
Claude Desktop
ChatGPT
ChatGPT
Cursor AI
Cursor AI
Perplexity AI
Perplexity AI
Visual Studio
Visual Studio
VS Code
VS Code

Available tools

The elmah.io MCP server exposes the following tools to AI assistants:

Tool Description
users_get_current Fetch the current user details.
system_get_context Get system information like current date and time. Useful when calculating time intervals.
organizations_list Get a list of all organizations that the current user is a part of. When authenticated as an organization, the current organization is returned.
organizations_get_details Get detailed information about an organization including configuration, subscription, usage statistics, and more.
logs_list Get a list of logs that the current user has access to.
logs_get_details Get detailed configuration and metadata for a specific log.
messages_get Fetch a single log message by ID. Includes full details like stack trace and metadata.
messages_list_recent List the most recent log messages for a specific log.
messages_list_frequent Identify the most frequent/common error groups in a log. Great for finding 'noisy' bugs.
messages_count Count the number of log messages based on severity and timeframe.
deployments_list List recent deployments for a log. A deployment represents a release of the software.
uptime_list Get a list of all uptime checks for a log, including their current status and 24h up/down percentage.
uptime_get_details Fetch the latest real-time results for a specific uptime check, including regional performance metrics.
heartbeats_list Get a list of all heartbeats configured for a log, including their current status.
heartbeats_get_details Get detailed information and recent check-in history for a specific heartbeat.

This article was brought to you by the elmah.io team. elmah.io is the best error management system for .NET web applications. We monitor your website, alert you when errors start happening, and help you fix errors fast.

See how we can help you monitor your website for crashes Monitor your website