Skip to main content
Glama

stelaspace-mcp

stelaspace-mcp MCP server

A local MCP server for publishing HTML files to StelaSpace from coding agents that work with your local files — Claude Code and Codex.

It runs on your machine, so it reads HTML files directly from disk by path and uploads the bytes via the StelaSpace API. That's what lets it publish large (1 MB+) reports and dashboards — unlike passing file contents as a tool argument, which is capped by the model's output size.

Claude Desktop (chat) isn't supported for publishing: its sandbox can't share files with a local MCP server, so it can't upload local reports. Use Claude Code or Codex, where the agent generates the report to disk and publishes it directly.

Tools

  • publish_file — { path, spaceSlug, title?, slug?, tags?, visibility? } → reads the file and returns its permanent URL. Reusing a slug publishes a new version.

  • list_spaces — list the spaces in your team.

  • list_documents — { spaceSlug, query? } — list documents in a space.

Related MCP server: deloc-mcp

Setup

Get an API key from StelaSpace → Settings → API Keys (starts with ss_sk_).

Claude Code

claude mcp add stelaspace --scope user \
  --env STELASPACE_API_KEY=ss_sk_your_key \
  -- npx -y stelaspace-mcp

Codex

~/.codex/config.toml:

[mcp_servers.stelaspace]
command = "npx"
args = ["-y", "stelaspace-mcp"]
env = { STELASPACE_API_KEY = "ss_sk_your_key" }

Then ask the agent to build and publish a report, e.g. "generate the sales dashboard and publish the HTML to my reports space as public."

Environment

  • STELASPACE_API_KEY (required) — your ss_sk_ key.

  • STELASPACE_API_URL (optional) — override the API endpoint. Defaults to https://stelaspace.com; most users never need to set this.

Available Tools

3 tools
list_documentsList documentsA

List documents in a space, optionally filtered by a case-insensitive title search term.

Inputs: spaceSlug (required), query.

list_spacesList spacesA

List the spaces in your team. Use a space's slug as the spaceSlug when publishing a document.

Inputs: no named parameters.

publish_filePublish an HTML fileA

Upload a local .html/.htm file to a StelaSpace space and get back a permanent, shareable URL. The file is read from disk by path, so large files work fine. Reusing a slug publishes a new version.

Inputs: path (required), spaceSlug (required), slug, tags, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct purpose: listing documents, listing spaces, and publishing files. There is no overlap between their functionalities.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern: list_documents, list_spaces, and publish_file. The naming is clear and predictable.

    Tool Count5/5

    With 3 tools, the server is well-scoped for a simple document publishing service. The count falls within the ideal 3-15 range, and each tool serves a clear role.

    Completeness3/5

    The tool set covers listing and publishing but lacks essential operations like deleting documents or retrieving a single document's details. These gaps could hinder common workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Local-first knowledge base MCP server. Lets AI agents (Claude Code, Cursor, etc.) read and write your personal knowledge base through 20 MCP tools. Zero cloud dependency — all files stay on your machine.
      1,758 npm
      705
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Deloc — deploy static sites from AI coding agents. Say "deploy this to Deloc" in Claude Code or Cursor and get a live URL back without leaving your editor.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Publishes HTML pages straight from your AI assistant to a shareable URL, then lets you manage them - update, list, search, fetch, and delete pages in a public or private workspace. Turns "share what I just made" into a single tool call from Claude, Cursor, or any MCP client.
      MIT