Content
# JupiterOne MCP Server
A Model Code Predictor (MCP) server for Cursor that integrates with JupiterOne.
## Setup Instructions
### 1. Clone the Repository
```bash
git clone https://github.com/JupiterOne/jupiterone-mcp.git
cd jupiterone-mcp
```
### 2. Create and Activate a Python Virtual Environment
```bash
# Create virtual environment
python -m venv .venv
# Activate on macOS/Linux
source .venv/bin/activate
# Activate on Windows
# .venv\Scripts\activate
```
### 3. Install Dependencies
```bash
pip install -r requirements.txt
```
### 4. Configure the MCP Server
Update the `.cursor/mcp.json` file with your JupiterOne credentials:
```json
{
"mcpServers": {
"jupiterone": {
"command": "/ABSOLUTE/PATH/TO/jupiterone-mcp/.venv/bin/python",
"args": ["/ABSOLUTE/PATH/TO/jupiterone-mcp/mcp_server.py"],
"env": {
"JUPITERONE_API_KEY": "your-jupiterone-api-key",
"JUPITERONE_ACCOUNT_ID": "your-jupiterone-account-id",
"JUPITERONE_REGION": "us"
}
}
}
}
```
Make sure to:
- Replace `/ABSOLUTE/PATH/TO/` with the actual full path to the repository
- Add your JupiterOne API key and account ID
- Set the correct region (default is "us")
### 5. Use the MCP Server in Your Projects
To use this MCP server in another project:
1. Copy the `.cursor` directory to your target project:
```bash
cp -r /path/to/jupiterone-mcp/.cursor /path/to/your/project/
```
2. If you already have a `.cursor/mcp.json` file in your target project, merge the contents:
```json
{
"mcpServers": {
"jupiterone": {
"command": "/ABSOLUTE/PATH/TO/jupiterone-mcp/.venv/bin/python",
"args": ["/ABSOLUTE/PATH/TO/jupiterone-mcp/mcp_server.py"],
"env": {
"JUPITERONE_API_KEY": "your-jupiterone-api-key",
"JUPITERONE_ACCOUNT_ID": "your-jupiterone-account-id",
"JUPITERONE_REGION": "us"
}
},
// Keep any existing MCP servers here
}
}
```
You should get a prompt in the bottom left of cursor that a new MCP server has been discovered, and asking if you want to install it. Click yes.
## Usage
Once configured, you can use JupiterOne queries directly within Cursor through the MCP interface. The server provides the `run_j1_query` tool that accepts JupiterOne Query Language (J1QL) queries.
Example usage in Cursor:
```
You can now run JupiterOne queries by asking Cursor something like:
"Can you show me all my AWS accounts in JupiterOne?"
```
## Troubleshooting
- Ensure your virtual environment is activated when manually running the server
- Check that all paths in the `.cursor/mcp.json` file are absolute paths
- Verify your JupiterOne API key and account ID are correct
- Make sure the MCP server is running before using it in Cursor
You Might Also Like
Ollama
Ollama enables easy access to large language models on various platforms.

n8n
n8n is a secure workflow automation platform for technical teams with 400+...
OpenWebUI
Open WebUI is an extensible web interface for customizable applications.

Dify
Dify is a platform for AI workflows, enabling file uploads and self-hosting.

Zed
Zed is a high-performance multiplayer code editor from the creators of Atom.
MarkItDown MCP
markitdown-mcp is a lightweight MCP server for converting various URIs to Markdown.