Esper MCP for LLMs

Use Esper Model Context Protocol (MCP) to connect console data to your existing LLM tools, giving even non-technical users a way to query device information using prompts and existing tools. 

Esper MCP gives you access to the following: 

• Fetch Company Settings: Access your tenant information.
• Fetch Apps in Enterprise: Browse and filter applications by name, SDK version, or upload status.
• Fetch Single App Details: Get full app metadata including build info and SDK requirements.
• Fetch Single App Version Details: Drill into version-specific details like install counts and download links.
• Fetch Event Feed (Device/Group): View detailed or aggregated event histories for individual devices or groups.
• Event Feed Report (Device): Generate human-readable summaries — perfect for dashboards or reports.
• List Device Groups: Retrieve or filter all device groups within your enterprise.
• Get Single Group Details: Access full group metadata, configurations, and information.
• Fetch Blueprint Details: See details about a blueprint, including meta information and configuration details. 
• Check Device Drift: Check device drift status.

Requirements: 

• Access to an existing LLM such as Claude or ChatGPT

In this article: 

• NPX Package Installation

• Authentication Command Reference

NPX Package Installation

You may need to install or update your NPM package to install Esper MCP. See Esper MCP NPM documentation for development options, authentication commands, and more. 

Step 1: Log into the Esper tenant you’d like to use for Esper MCP. 

Step 2: To authenticate, open a terminal and input the following: 

npx @esperio/mcp-server@latest auth login --tenant <tenant name>

The browser will open and you'll be prompted to approve the request to connect with the Esper console. 

Press Approve Access to allow access to the tenant. 

You should get a success message.

Note: An API key will also be created in the Esper console. If the key is deleted, you may need to authenticate again.

No further action is required in the Esper console. Feel free to close the window. 

Step 3: Set up the MCP server using your preferred client. In this guide, we’ll use Claude as an example implementation. Open a configuration profile in Claude and paste the following:

{
  "mcpServers": {
    "esper": {
      "command": "npx",
      "args": [
        "-y",
        "@esperio/mcp-server@latest",
        "stdio"
      ]
    }
  }
}

Step 4: You should now be authenticated. Use the following command to check the authentication status.

npx @esperio/mcp-server@latest auth status

You should see a response that tells you you’re authenticated along with other details. 

Step 5: You now have the tools you need to connect to your desired LLM. For example, using Claude Desktop, you can create a chatbot that allows you to query device information from the terminal. 

You now have the tools you need to connect to your desired LLM. For example, using Claude Desktop, you can create a chatbot that allows you to query device information from the terminal. 

Use Esper MCP and your favorite LLM to create your own Esper chatbot.

Authentication Command Reference

Use the following commands to manage authentication status. 

• ./esper-mcp-server auth login: Authenticate via browser
• ./esper-mcp-server auth logout: Clear stored credentials
• ./esper-mcp-server auth status: Check authentication status