Temway

io.github.temwayPublished by GitHub account temwayv1.0.0Updated Nov 2, 2026

Visual email & layout builder that turns AI assistants into a Temway authoring studio.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowMedia & Design

Overview

AI-generated overview

Hosted Temway MCP server that lets an AI assistant draft, edit, preview, publish and test-send branded emails and layouts in a Temway workspace.

What you can do
  • Read workspace context: brand tokens, block and element schemas, templates, fonts, style and shape presets, concept docs
  • Author emails: create, update, duplicate and delete emails, apply brand-aware templates, edit blocks, set global styles, validate content
  • Preview and ship emails: fast web preview, MJML HTML preview, publish, and send a one-off test copy
  • Build layouts: create and edit free-form layouts with absolute-positioned elements, custom SVG shapes, starter templates, canvas fitting, publish
  • Find and lock: search the workspace for emails and layouts, fetch full content by id, and acquire or release edit locks on shared resources
When to use it
Useful when you want an assistant to produce marketing or transactional emails and visual layouts inside an existing Temway workspace without hand-writing HTML or using the drag-and-drop builder. Best for teams already on Temway that want natural-language authoring, iteration and publishing.
Requirements
Remote Streamable HTTP endpoint; nothing to install locally. Authentication is a Temway API key starting with tmw_live_ sent as an Authorization Bearer header, minted by a team admin in the Temway dashboard and bound to one workspace with read/write scopes. Hosted web connectors such as claude.ai and ChatGPT use OAuth 2.1 instead. Network access to the Temway endpoint is required.
Before you install
The Authorization API key is shown only once and grants workspace access, so store it securely; narrow it to read-only scopes for browsing. The assistant can create, update, delete, publish and test-send emails and layouts, and test sends deliver real mail to an address. Block and element mutations are not atomic, so parallel edits on one resource can clobber each other. Layouts embedded in emails rasterize to a PNG, so text is not selectable.

Installation

In SourceWeft

  1. Open Temway in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.temway%2Fmcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "temway": {
      "type": "http",
      "url": "https://mcp.temway.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Temway MCP Server

Let your AI assistant design beautiful emails & layouts — in your Temway workspace.

A Model Context Protocol server that turns Claude, ChatGPT, Cursor and friends into a visual email & layout authoring studio.

[MCP] [License: MIT] [Status]

Getting Started · Clients · Tools · Temway

Temway is a visual builder for emails and layouts. This MCP server exposes your Temway workspace to any MCP-compatible AI client: the model reads your brand tokens, drafts a promo / newsletter / welcome email, previews it, publishes it, and even sends a test — all through natural language. No code, no drag-and-drop, no copy-pasting HTML.

It is a hosted remote MCP server. You point your client at a URL with an API key (or OAuth for web clients) — there is nothing to install, build, or run locally. The server speaks the MCP Streamable HTTP transport.

🔒 No source here? Correct. This is the public onboarding repo for the Temway MCP server. The server is operated by Temway and runs at https://mcp.temway.com/mcp. This repo holds client configuration, tool reference, and connectivity helpers. Report issues / request tools in Issues.

How it works

Your AI client (Claude / ChatGPT / Cursor / Desktop)  └─ MCP over HTTPS  →  https://mcp.temway.com/mcp                         Authorization: Bearer tmw_live_…   ← API key                         (or OAuth token for web connectors)                              └─ Temway public API  →  your workspace

The model authenticates per-request, then drives your workspace through brand-aware templates, block mutations, layout artwork, live previews, and publishing.

Getting started

1. Get an API key

API keys are minted by a team admin in the Temway dashboard. The key:

  • starts with tmw_live_…
  • is bound to one workspace
  • carries scopes (emails:read, emails:write, layouts:read, layouts:write) that gate which tools succeed

Store it securely — it's shown once.

2. Point your client at the server

The endpoint and a ready-to-paste config for each client are in examples/. The short version:

bash
# Claude Codeclaude mcp add --transport http temway https://mcp.temway.com/mcp \  --header "Authorization: Bearer tmw_live_xxxxxxxxxxxxxxxx"

That's it. The workspace is derived from the key.

3. Ask your assistant

"Create a promo email for our summer sale, 25% off, brand colors, a big CTA button, preview it, then publish it."

The model will get_branding → create_email → apply_template → update_block → preview_email_web → publish_email for you.

Configure your client

The Temway server speaks the Streamable HTTP transport. Pick your client:

ClientConfigFile
Claude Codeclaude mcp add --transport http …examples/claude-code.md
Claude DesktopmcpServers JSONexamples/claude-desktop.json
claude.ai (web)OAuth connector URLexamples/claude-ai-web.md
ChatGPTOAuth connector URLexamples/chatgpt.md
CursorMCP settingsexamples/cursor.md
Any MCP clientStreamable HTTP URLexamples/generic.json

Authentication

Two credential types — both resolve onto the same workspace context:

  • tmw_live_… API keys — for desktop & programmatic clients (Claude Code, Claude Desktop, Cursor, scripts). Sent as Authorization: Bearer tmw_live_…. The workspace is derived from the key. Scope-bound.
  • OAuth 2.1 — for hosted web connectors (claude.ai, ChatGPT) that reject static keys. No header to paste — the user signs in and picks a workspace on the consent screen; the connector receives its own short-lived token (PKCE / S256). Just enter the URL https://mcp.temway.com/mcp.

Tools

The server exposes 58 tools across five groups. Reads need a *:read scope; mutations need *:write.

Discovery & context — brand tokens, schemas, catalogs
ToolWhat it does
get_brandingFetch workspace brand tokens (colors, fonts, logo, socials, footer).
list_block_types / get_block_schemaEmail block catalog + per-block editable fields.
list_layout_element_types / get_element_schemaLayout element catalog + fields.
get_universal_schemaGlobal email style fields.
list_templatesCurated email starter templates.
list_fontsUsable fonts (web-safe for emails; + Google/custom for layouts).
list_concepts / get_conceptMental-model concept docs (read before authoring).
list_layout_templatesCurated layout artwork starters.
list_shape_presets / list_style_presetsDecorative SVG library + style keys.
Emails — author, mutate, preview, publish, send
ToolWhat it does
list_emails / get_emailBrowse & read published/draft emails.
create_email / update_email / delete_email / duplicate_emailCRUD.
create_email_from_layoutSeed an email from a published layout.
set_content / validate_contentReplace whole content / validate before saving.
add_block / update_block / remove_block / move_blockIncremental block edits.
set_universalMerge global email styles.
apply_templateApply a brand-aware starter template.
preview_email_webFast web-target preview (preferred while iterating).
preview_email_htmlInbox-target MJML HTML (slower; verifies client rendering).
publish_emailRender + store; marks the email published.
test_send_emailSend a one-off test copy to an address.
Layouts — free-form pixel-perfect artwork canvas
ToolWhat it does
list_layouts / get_layoutBrowse & read layouts.
create_layout / update_layout / delete_layout / duplicate_layoutCRUD.
set_layout_contentReplace the whole layout descriptor.
add_layout_element / update_layout_element / remove_layout_elementElement edits (absolute positioning).
add_custom_shape / add_shape_presetBespoke SVG or curated decorative shapes.
apply_layout_templateApply a layout starter (hero-banner, promo-card, …).
fit_canvas_to_contentTighten canvas bounds to visible elements.
publish_layoutSnapshot for embedding in emails.

Note: layouts rasterize to a single PNG when embedded in an email (text not selectable). Author readable/clickable content as email blocks instead.

Concurrency locks — prevent clobbering on shared resources

acquire_* / get_*_lock_status / refresh_*_lock / release_*_lock / force_release_*_lock for both email and layout resources.

Block/element mutations are not atomic — never fire two on the same resource in parallel. Acquire the edit-lock first on shared resources.

Search & fetch
ToolWhat it does
searchSearch the workspace for emails/layouts by name/subject/tags.
fetchFetch the full content of a search result by id.

A typical authoring flow

get_branding→ create_email { name: "Spring sale" }→ apply_template { template: "promo" }        # brand-aware starter→ update_block / add_block                    # tweak copy, CTA, colors→ preview_email_web                           # fast preview (preferred)→ publish_email                               # renders + marks published→ test_send_email { to: "[email protected]" }    # optional real send

Environment variables

The hosted endpoint is fully managed — most users never touch env vars. They only matter if you self-host or run the stdio transport.

VarPurposeRequired?
TEMWAY_API_URLTemway API base URL.Only when self-hosting.
TEMWAY_API_KEYtmw_live_… key (stdio transport).stdio only.
TEMWAY_WORKSPACE_IDWorkspace id (stdio transport; HTTP derives from key).stdio only.
LOG_LEVELpino log level (default info).no

Connectivity check

Verify the endpoint is reachable from your network before wiring up a client:

bash
node scripts/healthcheck.mjs# → OK 200 OK (926ms)# → ✓ Temway MCP endpoint is reachable.

(npx temway-mcp-healthcheck once published, or npm run healthcheck.)

Self-hosting

This repo does not contain server source. If you need to run the server yourself (on-prem, air-gapped, custom auth), contact [email protected] or open an issue.

FAQ

Is this open source?

The server is operated by Temway (source currently private). This repo is the public integration surface: client configs, tool reference, and helpers, published under the MIT license so you can copy configs freely.

Do I need to install Node / npm / anything?

No. The hosted remote transport means your client connects over HTTPS by URL — nothing runs locally. The optional healthcheck.mjs needs Node ≥ 18.17.

Which client should I use?

For local/CLI work: Claude Code or Cursor. For no-install browser use: claude.ai or ChatGPT with the OAuth connector. All configs are in examples/.

How are my emails protected from the model?

Credentials are scope-bound per key (*:read / *:write). Reads never mutate; every mutation is explicit. Narrow scopes to a read-only key for safe browsing.

Support

License

MIT © Temway

Source: README.md at commit 02d359e

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts