About The Project

This project consists of:

• A command line to be used by MCP Clients (Claude Desktop, VSCode, LM Studio, etc.)
• Classes and utils to define a stdio or HTTP MCP proxy to SailPoint Identity Security Cloud

Getting Started

Prerequisites

Install Node.js version 22+.

Personal Access Token (PAT)

Generate a personnal access token with the scope sp:scopes:all by following the documentation at https://developer.sailpoint.com/docs/api/v2025/authentication#generate-a-personal-access-token.

Environment variables

As for SailPoint CLI, you can use environment variables to define the tenant URL and credentials.

| Name | Description | | -------------------- | -------------------------------------------------------------------------- | | SAIL_BASE_URL | API base URL for your tenant (e.g. https://{tenant}.api.identitynow.com) | | SAIL_CLIENT_ID | Client ID of your PAT | | SAIL_CLIENT_SECRET | Client Secret of your PAT |

Usage

Usage depends on the MCP Client you are using. Here are a couple of examples

Claude Desktop

Follow the procedures as described in https://modelcontextprotocol.io/docs/develop/connect-local-servers

Use the following snippet to add the server:

{
  "command": "npx",
  "args": [
    "isc-mcp-server"
  ],
  "env": {
    "SAIL_BASE_URL": "https://...",
    "SAIL_CLIENT_ID": "...",
    "SAIL_CLIENT_SECRET": "..."
  }
}

In the example above, the environment variables are set directly in the config. It could be set "system wide" so you wouldn't need to set it in the config file.

claude_desktop_config.json will look like:

{
  "mcpServers": {
    "ISC": {
      "command": "npx",
      "args": [
        "isc-mcp-server"
      ],
      "env": {
        "SAIL_BASE_URL": "https://...",
        "SAIL_CLIENT_ID": "...",
        "SAIL_CLIENT_SECRET": "..."
      }
    }
  }
}

"ISC" is just an example. You can put another tool name.

Development

Compile

npm run compile

or

npm run watch

Run

npm run start-mcp-inspector

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Top contributors:

License

Distributed under MIT. See LICENSE for more information.