What is Jupiterone Mcp Server

JupiterOne MCP Server is a Model Context Protocol (MCP) server that provides access to JupiterOne tools, enabling AI assistants and other MCP clients to interact with JupiterOne’s data.

Use cases

Use cases for the JupiterOne MCP Server include automating security assessments, integrating security data into AI-driven applications, and enhancing incident response capabilities by providing quick access to relevant data.

How to use

To use the JupiterOne MCP Server, you need an active JupiterOne account, an API key, and your account ID. You can configure it with Claude Desktop either by using npx or by installing it globally. The configuration involves setting environment variables for the API key, account ID, and base URL.

Key features

Key features of the JupiterOne MCP Server include seamless integration with JupiterOne tools, support for AI assistants, and flexible configuration options for different installation methods.

Where to use

JupiterOne MCP Server can be used in various fields such as cybersecurity, data analysis, and compliance management, where organizations need to access and analyze their security data effectively.

JupiterOne MCP Server

A Model Context Protocol (MCP) server that provides access to JupiterOne tools. This server enables AI assistants and other MCP clients to interact with JupiterOne’s data.

Configuration

Prerequisites

1. JupiterOne Account: You need an active JupiterOne account
2. API Key: Generate an API key from your JupiterOne account settings
3. Account ID: Your JupiterOne account identifier
4. Working node installation with a version >= 18 (See https://nodejs.org/en/download and click one of the green buttons)

Installation with Claude Desktop

To use this MCP server with Claude Desktop, you need to add it to your Claude configuration file.

Option 1: Using npx (Recommended)

Add the following configuration to your Claude Desktop configuration file:

{
  "mcpServers": {
    "jupiterone": {
      "command": "npx",
      "args": [
        "-y",
        "@jupiterone/jupiterone-mcp"
      ],
      "env": {
        "JUPITERONE_API_KEY": "your-api-key-here",
        "JUPITERONE_ACCOUNT_ID": "your-account-id-here",
        "JUPITERONE_BASE_URL": "https://graphql.us.jupiterone.io"
      }
    }
  }
}

Option 2: Global Installation (For nvm users or troubleshooting)

If you’re using nvm or experiencing issues with Option 1, first install the package globally:

npm install -g @jupiterone/jupiterone-mcp

Then add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "jupiterone": {
      "command": "/usr/local/bin/node",
      "args": [
        "/usr/local/bin/jupiterone-mcp"
      ],
      "env": {
        "JUPITERONE_API_KEY": "your-api-key-here",
        "JUPITERONE_ACCOUNT_ID": "your-account-id-here",
        "JUPITERONE_BASE_URL": "https://graphql.us.jupiterone.io"
      }
    }
  }
}

Note: You may need to adjust the paths in Option 2 based on your Node.js installation:

• For Homebrew Node.js: /usr/local/bin/node and /usr/local/bin/jupiterone-mcp
• For nvm: ~/.nvm/versions/node/v[version]/bin/node and ~/.nvm/versions/node/v[version]/bin/jupiterone-mcp

Installation with Cursor

For Cursor IDE, add the same configuration to your Cursor settings:

1. Open Cursor Settings
2. Navigate to “Features” → “Model Context Protocol”
3. Add the server configuration using either Option 1 or Option 2 from above

Environment Variables

Replace the placeholder values with your actual JupiterOne credentials:

• JUPITERONE_API_KEY: Your JupiterOne API key (required)
• JUPITERONE_ACCOUNT_ID: Your JupiterOne account ID (required).
• JUPITERONE_BASE_URL: JupiterOne GraphQL endpoint (optional, defaults to https://graphql.us.jupiterone.io)

Getting Your JupiterOne Credentials

1. API Key:

   • Log into your JupiterOne account
   • Go to Settings → API Keys
   • Create a new API key or use an existing one

2. Account ID:

   • This can be retrieved by either of the following:
   • Navigating to https://j1dev.apps.us.jupiterone.io/settings/account-management
   • Run the following query in your JupiterOne account: find jupiterone_account as x return x.accountId

Features

Rules Management

• list-rules - List all rules with optional limit parameter
• get-rule-details - Get detailed information about a specific rule by ID
• create-inline-question-rule - Create new inline question-based rules with operations and actions
• update-inline-question-rule - Update existing inline question rule instances
• evaluate-rule - Trigger on-demand evaluation of a specific rule

Rule Evaluations

• list-rule-evaluations - Get historical evaluation data for a rule with optional time filtering
• get-rule-evaluation-details - Get detailed evaluation information including query, condition, and action results
• get-raw-data-download-url - Get download URL for raw evaluation data
• get-rule-evaluation-query-results - Get the actual query results from a rule evaluation

Alert Monitoring

• get-active-alerts - Get all currently active alerts with optional limit parameter

Dashboard Management

• get-dashboards - List all dashboards in your account
• create-dashboard - Create new dashboards
• get-dashboard-details - Get detailed dashboard information including widgets and layouts
• update-dashboard - Update an existing dashboard layout

Integration Management

• get-integration-definitions - List available integration definitions with optional configuration details
• get-integration-instances - Get integration instances with optional filtering by definition ID
• get-integration-jobs - List integration jobs with optional filtering by status, instance, or definition
• get-integration-job - Get details for a specific integration job
• get-integration-events - Get events for a specific integration job with pagination support

Account Management

• test-connection - Test connection to JupiterOne API and get account information

Query Execution

• execute-j1ql-query - Execute a J1QL query

Available Tools

Rules Management

Rule Evaluations

Alert Monitoring

Dashboard Management

Integration Management

Account Management

Query Execution