tesserae-studio-mcp

Part of the Tesserae Studio repo (packages/tesserae-studio-mcp), so the bridge stays in lockstep with the Studio API it wraps. Published to PyPI as tesserae-studio-mcp.

The MCP bridge for Tesserae Studio. It lets an AI agent (Claude Code, Claude Desktop, or any MCP client) author Tesserae widgets end to end: scaffold a widget, edit its files, lint it, mine a data schema, register it to a running Tesserae, and render it, all through a running Studio server.

This is a thin stdio client. It talks to your Studio server over its local REST API (STUDIO_URL), so the linting, mining, registering, and rendering all run in your own Studio, which in turn drives your Tesserae.

scaffold_widget → write_file → lint_widget → register_widget → faithful_render → mine_data_schema

Prerequisites

A running Tesserae Studio server (it serves the API this bridge calls, and its web UI). See the Studio README for how to run it. Studio in turn connects to a Tesserae for live data and faithful (e-ink) render.

Install

Run this on the machine where your agent runs, which may differ from where Studio runs.

pip install tesserae-studio-mcp

or from source:

pip install "git+https://github.com/dmellok/tesserae-studio#subdirectory=packages/tesserae-studio-mcp"

Either gives you the tesserae-studio-mcp command.

Configure your agent

Point your MCP client at tesserae-studio-mcp. Example (Claude Desktop / Claude Code mcpServers config):

{
  "mcpServers": {
    "tesserae-studio": {
      "command": "tesserae-studio-mcp",
      "env": { "STUDIO_URL": "http://localhost:8770" }
    }
  }
}

Claude Code one-liner:

claude mcp add tesserae-studio -e STUDIO_URL=http://localhost:8770 -- tesserae-studio-mcp

STUDIO_URL — where your Studio server is reachable (default http://localhost:8770). For a remote / Home Assistant Studio, use its LAN address, e.g. http://192.168.1.50:8770.

The build loop and the widget contract rules are sent to the agent automatically at handshake (FastMCP instructions), so you don't paste a prompt.

Run without installing

From a clone:

pip install mcp httpx
STUDIO_URL=http://localhost:8770 python -m tesserae_studio_mcp

License

AGPL-3.0-or-later, matching Tesserae Studio.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tesserae_studio_mcp-0.6.0.tar.gz (23.9 kB view details)

Uploaded Jul 15, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

tesserae_studio_mcp-0.6.0-py3-none-any.whl (22.6 kB view details)

Uploaded Jul 15, 2026 Python 3

File details

Details for the file tesserae_studio_mcp-0.6.0.tar.gz.

File metadata

Download URL: tesserae_studio_mcp-0.6.0.tar.gz
Upload date: Jul 15, 2026
Size: 23.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for tesserae_studio_mcp-0.6.0.tar.gz
Algorithm	Hash digest
SHA256	`8116957e3ddf7144e73c6730bdd44e4d1a4bc9692398a2de5080c746a56c266b`
MD5	`b181a05ced3e1e70dc5072dfb55db7d7`
BLAKE2b-256	`445ffeaaaf274b55e7a90637a447d74614e0765b57a9d158858fb391c5009fd9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for tesserae_studio_mcp-0.6.0.tar.gz:

Publisher: publish-tesserae-studio-mcp.yml on dmellok/tesserae-studio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: tesserae_studio_mcp-0.6.0.tar.gz
- Subject digest: 8116957e3ddf7144e73c6730bdd44e4d1a4bc9692398a2de5080c746a56c266b
- Sigstore transparency entry: 2172502092
- Sigstore integration time: Jul 15, 2026
Source repository:
- Permalink: dmellok/tesserae-studio@f4f27cf5a5da547e38f9d8d629c5a44a9c31dff6
- Branch / Tag: refs/tags/studio-mcp-v0.6.0
- Owner: https://github.com/dmellok
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-tesserae-studio-mcp.yml@f4f27cf5a5da547e38f9d8d629c5a44a9c31dff6
- Trigger Event: push