OpenSolar MCP MCP Server

io.github.Align-Software-Company/opensolar-mcp

Repository Registry

What is the OpenSolar MCP MCP server?

Unofficial, self-hosted MCP server for the documented OpenSolar API.

How to install OpenSolar MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENSOLAR_API_TOKEN
required
secret
OpenSolar bearer token
OPENSOLAR_ORG_ID
required
OpenSolar organisation ID
OPENSOLAR_PROFILE
Tool profile: agent (curated default) or full (every registered tool)
OPENSOLAR_READ_ONLY
Hide every tool that can change OpenSolar data
OPENSOLAR_PLAN
OpenSolar access plan; api_access hides tools that need Raw Data API Access
OPENSOLAR_TOOLSETS
Comma-separated toolsets that replace the profile's tool selection
OPENSOLAR_UPLOAD_ROOT
Directory that create_private_file may read from; uploads stay disabled when unset

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "opensolar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alignco/opensolar-mcp"
      ],
      "env": {
        "OPENSOLAR_API_TOKEN": "<YOUR_OPENSOLAR_API_TOKEN>",
        "OPENSOLAR_ORG_ID": "<YOUR_OPENSOLAR_ORG_ID>",
        "OPENSOLAR_PROFILE": "<YOUR_OPENSOLAR_PROFILE>",
        "OPENSOLAR_READ_ONLY": "<YOUR_OPENSOLAR_READ_ONLY>",
        "OPENSOLAR_PLAN": "<YOUR_OPENSOLAR_PLAN>",
        "OPENSOLAR_TOOLSETS": "<YOUR_OPENSOLAR_TOOLSETS>",
        "OPENSOLAR_UPLOAD_ROOT": "<YOUR_OPENSOLAR_UPLOAD_ROOT>"
      }
    }
  }
}