Skip to content
MCP server

Gradient MSP MCP

CLI and MCP server for Gradient MSP Synthesize: usage push, billing drift, alert tracing.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.13
Listing updated
4 days ago

About Gradient MSP MCP

Gradient MSP MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add gradient-mcp --env GRADIENT_PARTNER_API_KEY='<GRADIENT_PARTNER_API_KEY>' --env GRADIENT_TOKEN='<GRADIENT_TOKEN>' --env GRADIENT_VENDOR_API_KEY='<GRADIENT_VENDOR_API_KEY>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env GRADIENT_MCP_HTTP_TOKEN='<GRADIENT_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/gradient-v0.1.13/gradient-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gradient-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/gradient-v0.1.13/gradient-mcp.mcpb"
      ],
      "env": {
        "GRADIENT_PARTNER_API_KEY": "<GRADIENT_PARTNER_API_KEY>",
        "GRADIENT_TOKEN": "<GRADIENT_TOKEN>",
        "GRADIENT_VENDOR_API_KEY": "<GRADIENT_VENDOR_API_KEY>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "GRADIENT_MCP_HTTP_TOKEN": "<GRADIENT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gradient-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/gradient-v0.1.13/gradient-mcp.mcpb"
      ],
      "env": {
        "GRADIENT_PARTNER_API_KEY": "<GRADIENT_PARTNER_API_KEY>",
        "GRADIENT_TOKEN": "<GRADIENT_TOKEN>",
        "GRADIENT_VENDOR_API_KEY": "<GRADIENT_VENDOR_API_KEY>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "GRADIENT_MCP_HTTP_TOKEN": "<GRADIENT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "gradient-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/gradient-v0.1.13/gradient-mcp.mcpb"
      ],
      "env": {
        "GRADIENT_PARTNER_API_KEY": "<GRADIENT_PARTNER_API_KEY>",
        "GRADIENT_TOKEN": "<GRADIENT_TOKEN>",
        "GRADIENT_VENDOR_API_KEY": "<GRADIENT_VENDOR_API_KEY>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "GRADIENT_MCP_HTTP_TOKEN": "<GRADIENT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gradient-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/gradient-v0.1.13/gradient-mcp.mcpb"
      ],
      "env": {
        "GRADIENT_PARTNER_API_KEY": "<GRADIENT_PARTNER_API_KEY>",
        "GRADIENT_TOKEN": "<GRADIENT_TOKEN>",
        "GRADIENT_VENDOR_API_KEY": "<GRADIENT_VENDOR_API_KEY>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "GRADIENT_MCP_HTTP_TOKEN": "<GRADIENT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gradient-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/gradient-v0.1.13/gradient-mcp.mcpb"
      ],
      "env": {
        "GRADIENT_PARTNER_API_KEY": "<GRADIENT_PARTNER_API_KEY>",
        "GRADIENT_TOKEN": "<GRADIENT_TOKEN>",
        "GRADIENT_VENDOR_API_KEY": "<GRADIENT_VENDOR_API_KEY>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "GRADIENT_MCP_HTTP_TOKEN": "<GRADIENT_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Configuration

  • GRADIENT_BASE_URLBase URL for the Gradient MSP API. Leave the prefilled default unless your account uses a different regional or self-hosted host.
  • GRADIENT_PARTNER_API_KEYSynthesize partner API key, issued with the vendor key. Fill in this and the vendor key, or GRADIENT_TOKEN alone.
  • GRADIENT_TOKENThe GRADIENT-TOKEN header value, base64("<vendorApiKey>:<partnerApiKey>"). Leave empty when you fill in the vendor and partner API keys; when set, it is used instead of them.
  • GRADIENT_VENDOR_API_KEYSynthesize vendor API key (Integrations -> Custom -> Generate API Tokens). Fill in this and the partner key, or GRADIENT_TOKEN alone.
  • GRADIENT_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any state-changing execute call. Leave blank to keep every tool available.
  • GRADIENT_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API and nothing is written to the local store. Leave blank to keep the local store.
  • GRADIENT_USER_AGENTOverrides the User-Agent the CLI sends on Gradient MSP requests. Leave blank to use the CLI's own built-in User-Agent.
  • PRINTING_PRESS_CLIENT_PROFILEOnly for tenant-gated multi-client deployments: binds the MCP server to an existing Printing Press client profile. Leave blank for a single-tenant install.
  • GRADIENT_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http (a remote/hosted deployment). Callers must send a matching Authorization: Bearer header. Not needed for the default local stdio transport that Claude Desktop uses.

Pricing

Open source

Gradient MSP MCP FAQ

Is Gradient MSP MCP free?

Yes. Gradient MSP MCP is open source, so you can use and self-host it for free.

How do I add Gradient MSP MCP to Claude Code?

Run this command in your terminal: claude mcp add gradient-mcp --env GRADIENT_PARTNER_API_KEY='<GRADIENT_PARTNER_API_KEY>' --env GRADIENT_TOKEN='<GRADIENT_TOKEN>' --env GRADIENT_VENDOR_API_KEY='<GRADIENT_VENDOR_API_KEY>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env GRADIENT_MCP_HTTP_TOKEN='<GRADIENT_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/gradient-v0.1.13/gradient-mcp.mcpb