How do I use skyspark-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@skyspark-mcp list all sites in the current project" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

skyspark-mcp

by pipseedai

Overview Schema Source Related Servers Discussions Admin

Python

Remote

skyspark-mcp

MCP server for SkySpark — connect AI assistants to your building automation data.

Evaluate Axon expressions, read/write records, manage functions, and explore your SkySpark projects through the Model Context Protocol.

Features

21 tools for comprehensive SkySpark interaction
SCRAM, token, or no-auth — works with any network setup (including Tailscale)
Multi-project — target different projects from the same server
Base64-safe commits — avoids Axon ${} string interpolation issues
Production-tested — used daily for building analytics dashboards

Quick Start

pip install skyspark-mcp

Create a .env file (see .env.example):

SKYSPARK_HOST=192.168.1.100
SKYSPARK_PORT=8080
SKYSPARK_PROJECT=demo
SKYSPARK_AUTH=scram
SKYSPARK_USERNAME=su
SKYSPARK_PASSWORD=your-password

Run the server:

# SSE transport (default, port 8765)
skyspark-mcp

# stdio transport (for direct MCP client integration)
skyspark-mcp --stdio

Tools

Core

Tool	Description
`ss_eval`	Evaluate any Axon expression
`ss_about`	Server info (version, project, user)
`ss_read`	Read records by Haystack filter
`ss_read_by_id`	Read a single record by ID
`ss_search`	Full-text search across records

CRUD

Tool	Description
`ss_create`	Create a new record
`ss_update`	Update record tags
`ss_delete`	Delete matching records

Functions

Tool	Description
`ss_func_list`	List project functions
`ss_func_read`	Read function source code
`ss_func_commit`	Update function source (base64-safe)
`ss_func_commit_batch`	Batch commit multiple functions
`ss_func_diff`	Compare current vs proposed source
`ss_funcs_all`	List ALL functions including built-ins

Content (base64-safe)

Tool	Description
`ss_view_update`	Update view source
`ss_page_update`	Update Docunomicon page content
`ss_rec_create`	Create record with complex tag values

Discovery

Tool	Description
`ss_views`	List views
`ss_templates`	List Docunomicon templates
`ss_libs`	List installed extensions
`ss_projects`	List available projects

Authentication

SCRAM (default)

Standard SkySpark authentication. Set SKYSPARK_USERNAME and SKYSPARK_PASSWORD.

No Auth

For trusted networks (Tailscale, VPN, localhost). Set SKYSPARK_AUTH=none. The server strips auth headers automatically.

Token

Pre-shared auth token. Set SKYSPARK_AUTH=token and SKYSPARK_PASSWORD=your-token.

Multi-Project

Every tool accepts an optional project and server parameter:

ss_eval(expr="readAll(site)", project="other_project")
ss_read(filter_expr="site", server="http://other-server:8080", project="demo")

Clients are pooled per server+project combination.

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "skyspark": {
      "command": "skyspark-mcp",
      "args": ["--stdio"],
      "env": {
        "SKYSPARK_HOST": "192.168.1.100",
        "SKYSPARK_PORT": "8080",
        "SKYSPARK_PROJECT": "demo",
        "SKYSPARK_AUTH": "scram",
        "SKYSPARK_USERNAME": "su",
        "SKYSPARK_PASSWORD": "your-password"
      }
    }
  }
}

Usage with mcporter

# SSE
npx mcporter call --allow-http 'http://localhost:8765/mcp.ss_eval(expr: "readAll(site)")'

# stdio
npx mcporter call --stdio "skyspark-mcp --stdio" 'ss_eval(expr: "1 + 1")'

Dependencies

phable — Python Haystack client
FastMCP — MCP server framework

License

MIT — built by Pip 🌱

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Energy AT IT
com.energyatit.app
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Cloud Platforms Agent Orchestration Virtualization
2
Carbon VoiceOAuth
app.carbonvoice.mcp
Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.
Communication Knowledge & Memory Text Summarization
2
IFTTT MCP serverOAuth
com.ifttt
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
App Automation
1
Apideck MCP A
dev.apideck.mcp
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Developer Tools
42