teletype-mcp-server 0.1.0 → 0.1.1

package/llms-install.md

@@ -0,0 +1,17 @@
+# Install Teletype MCP
+
+Teletype MCP gives AI clients tools for customer conversations, profiles, replies, and workspace settings. A Teletype project Public API token is required. The public hosted endpoint has OAuth disabled.
+
+## Hosted connection
+
+Use Streamable HTTP at `https://mcp.teletype.app/mcp` with the secret header `X-Teletype-Api-Token`. Ask the user to configure their token in their client's private credential settings. Follow the [client-specific examples](docs/CLIENTS.md), including the different variable syntax used by each client.
+
+## Local connection
+
+Use Node.js 20.19+, 22.13+, or 24.x. Launch `npx -y teletype-mcp-server --stdio` with `TELETYPE_API_TOKEN` set in the server's private environment. Add `--read-only` to disable writes. For Claude Desktop, use the `.mcpb` asset from a [published release](https://github.com/Teletype-App/teletype-mcp-server/releases) when available and enter the token in its configuration dialog.
+
+## Plugin
+
+See [plugin/README.md](plugin/README.md) for Claude Code and Cursor configuration, and [README.md](README.md#plugins-for-claude-code-codex-and-cursor) for Codex.
+
+Check the connection by listing tools. Start with a read task. Obtain the user's approval before writes, use `dry_run` where supported, and never add a token to a repository or a public directory listing.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "teletype-mcp-server",
   "mcpName": "io.github.teletype-app/teletype-mcp-server",
-  "version": "0.1.0",
-  "description": "MCP-сервер с высокоуровневыми инструментами для Teletype Public API.",
+  "version": "0.1.1",
+  "description": "MCP server for Teletype customer support: conversations, customer profiles, replies, and workspace tools.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,19 +45,23 @@
     "dist",
     "README.md",
     "README-ru.md",
+    "llms-install.md",
+    "lhm.plugin.json",
+    "LAUNCHGUIDE.md",
+    "gemini-extension.json",
     "server.json",
     "LICENSE",
     "docs",
     "eval-results",
     "examples/clients",
-    "plugin/skills",
+    "plugin",
     ".env.example",
     ".env.eval.example",
     "smithery.yaml"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/teletype-app/teletype-mcp-server.git"
+    "url": "git+https://github.com/Teletype-App/teletype-mcp-server.git"
   },
   "bugs": {
     "url": "https://github.com/teletype-app/teletype-mcp-server/issues"
@@ -94,6 +98,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/node": "^2.0.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "@modelcontextprotocol/server": "^2.0.0",
     "ajv": "^8.20.0",
     "express": "^4.22.3",

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,37 @@
+{
+  "name": "teletype",
+  "displayName": "Teletype MCP Server",
+  "version": "0.1.1",
+  "description": "Teletype support tools and workflows: triage the inbox, send replies safely, summarize clients, escalate issues, hand over shifts.",
+  "author": {
+    "name": "Teletype-App",
+    "url": "https://github.com/Teletype-App",
+    "email": "p@teletype.app"
+  },
+  "repository": "https://github.com/Teletype-App/teletype-mcp-server",
+  "license": "MIT",
+  "keywords": ["mcp", "teletype", "customer-support", "messaging", "omnichat"],
+  "mcpServers": {
+    "teletype": {
+      "type": "http",
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${user_config.teletype_api_token}"
+      }
+    }
+  },
+  "homepage": "https://github.com/Teletype-App/teletype-mcp-server/tree/main/plugin",
+  "userConfig": {
+    "teletype_api_token": {
+      "type": "string",
+      "title": "Teletype Public API token",
+      "description": "Public API token from your Teletype project settings. Sent only to the hosted Teletype MCP server.",
+      "required": true,
+      "sensitive": true
+    }
+  },
+  "icon": "./assets/icon.png",
+  "documentationUrl": "https://github.com/Teletype-App/teletype-mcp-server/tree/main/plugin",
+  "supportUrl": "https://help.teletype.app",
+  "privacyPolicyUrl": "https://teletype.app/files/policy.pdf"
+}

package/plugin/.cursor-plugin/plugin.json

@@ -0,0 +1,34 @@
+{
+  "name": "teletype",
+  "version": "0.1.1",
+  "description": "Teletype support tools and workflows: triage the inbox, send replies safely, summarize clients, escalate issues, hand over shifts.",
+  "author": {
+    "name": "Teletype-App",
+    "email": "p@teletype.app"
+  },
+  "repository": "https://github.com/Teletype-App/teletype-mcp-server",
+  "license": "MIT",
+  "keywords": ["mcp", "teletype", "customer-support", "messaging", "omnichat"],
+  "homepage": "https://github.com/Teletype-App/teletype-mcp-server/tree/main/plugin",
+  "mcpServers": {
+    "teletype": {
+      "url": "https://mcp.teletype.app/mcp",
+      "headers": {
+        "X-Teletype-Api-Token": "${TELETYPE_API_TOKEN}"
+      }
+    }
+  },
+  "variables": {
+    "type": "object",
+    "properties": {
+      "TELETYPE_API_TOKEN": {
+        "type": "string",
+        "title": "Teletype Public API token",
+        "description": "Public API token from your Teletype project settings. Sent to https://mcp.teletype.app/mcp.",
+        "minLength": 1
+      }
+    },
+    "required": ["TELETYPE_API_TOKEN"]
+  },
+  "logo": "assets/logo.svg"
+}

package/plugin/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Teletype
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/plugin/README.md

@@ -0,0 +1,48 @@
+# Teletype support plugin
+
+![Teletype](assets/logo.svg)
+
+Connect your AI assistant to [Teletype](https://teletype.app) customer support. Find unanswered conversations, read customer history, draft and send replies, add notes, escalate issues, and prepare shift handovers. The plugin includes the `teletype-support` skill and five support commands. You need a Teletype project with Public API access and its project token.
+
+## Claude Code
+
+Run these commands inside Claude Code:
+
+```text
+/plugin marketplace add Teletype-App/teletype-mcp-server
+/plugin install teletype@teletype-mcp-server
+```
+
+Enable the plugin and enter the **Teletype Public API token** in its configuration dialog. The field is required and marked sensitive. Claude stores it in its secure credential store and substitutes it into the hosted server's authentication header. Use an up-to-date Claude Code version with `userConfig` support. Check the connection in `/mcp`.
+
+The commands are `/teletype:triage-inbox`, `/teletype:draft-reply`, `/teletype:client-summary`, `/teletype:escalate-issue`, and `/teletype:shift-handover`. You can also ask for a support task in plain language.
+
+## Cursor
+
+The Cursor manifest is `.cursor-plugin/plugin.json`. For a marketplace installation, set `TELETYPE_API_TOKEN` in the plugin's **Plugins → Configure** dashboard. It connects to the hosted Teletype MCP server and includes the shared skill and commands. Check the MCP connection after configuration.
+
+## Codex and Agent Plugins
+
+The portable `plugin.json` and `mcp.json` add the skill and a local stdio server. The launcher runs `npx -y teletype-mcp-server@0.1.1 --stdio`. It downloads the pinned npm package and starts it locally. See the [Codex setup guide](https://github.com/Teletype-App/teletype-mcp-server/blob/main/docs/CLIENTS.md#codex) for client configuration and installation.
+
+## Kiro Powers
+
+Import this directory as an Agent Plugin in Kiro. The portable manifest starts the local stdio server and loads the shared support skill. Set `TELETYPE_API_TOKEN` in the Kiro process environment before starting it. The pinned npm version must be published. See [Kiro installation](https://kiro.dev/docs/powers/installation/) and the [client guide](https://github.com/Teletype-App/teletype-mcp-server/blob/main/docs/CLIENTS.md#kiro).
+
+## What the plugin accesses
+
+Claude and Cursor send the configured token, tool arguments, and conversation operations to `https://mcp.teletype.app/mcp`. The hosted server forwards Public API requests to Teletype. The local stdio server calls the Teletype Public API directly. Customer profiles and message history returned by tools become available to your AI client. Message tools can send the text and attachments you select to customers. Project tools can change workspace settings.
+
+Write tools require `confirm: true`. Reply and template tools support `dry_run: true` for previews. Follow the skill's confirmation rules before sending messages or changing customer records. The confirmation flag is a guard against accidental calls, and the client still needs to enforce user consent. For restricted local access, configure the server with `--read-only` or selected `--toolsets` as described in the [client guide](https://github.com/Teletype-App/teletype-mcp-server/blob/main/docs/CLIENTS.md).
+
+Start with: “Find unanswered Teletype conversations and summarize the three most urgent. Do not send replies.”
+
+## Support and privacy
+
+- [Client setup and troubleshooting](https://github.com/Teletype-App/teletype-mcp-server/blob/main/docs/CLIENTS.md)
+- [Teletype help center](https://help.teletype.app)
+- [Report a bug](https://github.com/Teletype-App/teletype-mcp-server/issues)
+- [Teletype privacy policy](https://teletype.app/android/policy.html)
+- Security reports: `p@teletype.app`
+
+The plugin code is licensed under [MIT](LICENSE). Brand assets come from the [official Teletype website](assets/README.md).

package/plugin/assets/README.md

@@ -0,0 +1,12 @@
+# Teletype brand assets
+
+Source artwork retrieved from the official Teletype website on 2026-10-08:
+
+- `logo.svg`: <https://teletype.app/images/logo_TeletypeApp.svg>
+- `icon.svg`: the symbol and its gradient extracted from `logo.svg`, with a square viewport. The original paths and colors are unchanged.
+- `icon.png`: 512 × 512 PNG exported from `icon.svg` for plugins and the desktop bundle.
+- `icon-400.png`: 400 × 400 PNG exported from `icon.svg` for the Cline Marketplace.
+
+These files identify the Teletype plugin and MCP server in directory listings and the desktop bundle.
+
+The landing page and optional OAuth connection page use the original logo and the site's blue and neutral palette. Their text uses Manrope, available under the SIL Open Font License. `fonts/manrope.woff2` is a WOFF2 export of [the variable font from Google Fonts](https://github.com/google/fonts/tree/main/ofl/manrope). The license is included in `fonts/OFL.txt`. Logo and font are served locally through `/assets/` and, when OAuth is enabled, `/oauth/assets/`.

package/plugin/assets/consent.js

@@ -0,0 +1,32 @@
+const messages = JSON.parse(document.querySelector("[data-messages]").dataset.messages);
+const controls = document.querySelectorAll("[data-locale]");
+
+function changeLanguage(locale) {
+  if (!Object.hasOwn(messages, locale)) return;
+  const copy = messages[locale];
+  document.documentElement.lang = locale;
+  document.querySelectorAll("[data-i18n]").forEach((element) => {
+    element.textContent = copy[element.dataset.i18n];
+  });
+  document.querySelectorAll("[data-i18n-placeholder]").forEach((element) => {
+    element.setAttribute("placeholder", copy[element.dataset.i18nPlaceholder]);
+  });
+  document.querySelectorAll("[data-i18n-href]").forEach((element) => {
+    element.href = copy[element.dataset.i18nHref];
+  });
+  document.querySelectorAll("[data-i18n-label]").forEach((element) => {
+    element.setAttribute("aria-label", copy[element.dataset.i18nLabel]);
+  });
+  controls.forEach((button) => {
+    button.setAttribute("aria-pressed", String(button.dataset.locale === locale));
+  });
+  document.getElementById("language-status").textContent = copy.languageChanged;
+  document.cookie =
+    `teletype_oauth_locale=${locale}; Path=/; Max-Age=31536000; SameSite=Lax` +
+    (location.protocol === "https:" ? "; Secure" : "");
+}
+
+controls.forEach((button) => {
+  button.disabled = false;
+  button.addEventListener("click", () => changeLanguage(button.dataset.locale));
+});

package/plugin/assets/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2018 The Manrope Project Authors (https://github.com/googlefonts/manrope)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/plugin/assets/icon.svg

@@ -0,0 +1,15 @@
+<svg width="350" height="350" viewBox="47 0 350 350" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_512_1393)">
+<path d="M365 175C365 96.0233 300.977 32 222 32C143.023 32 79 96.0233 79 175C79 253.977 143.023 318 222 318C300.977 318 365 253.977 365 175Z" fill="#0079FF"/>
+<path d="M222 84.4333C272.018 84.4333 312.567 124.941 312.567 174.911C312.567 224.882 272.019 265.39 222 265.39C212.97 265.39 204.252 264.064 196.022 261.606L165.185 279.867V245.369C144.603 228.783 131.433 203.386 131.433 174.912C131.433 124.942 171.981 84.4333 222 84.4333ZM265.842 189.524C263.047 188.668 260.105 190.344 259.281 193.165C254.474 209.838 239.146 221.483 222.001 221.483C204.855 221.483 189.515 209.837 184.714 193.165C183.896 190.344 180.99 188.669 178.148 189.524C175.335 190.356 173.729 193.334 174.546 196.167C180.654 217.372 200.177 232.2 222 232.2C243.824 232.2 263.335 217.372 269.455 196.167C270.272 193.334 268.654 190.356 265.842 189.524Z" fill="url(#paint0_linear_512_1393)"/>
+</g>
+<defs>
+<linearGradient id="paint0_linear_512_1393" x1="159.451" y1="117.327" x2="292.509" y2="223.659" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#E8F3FF"/>
+</linearGradient>
+<clipPath id="clip0_512_1393">
+<rect width="286" height="286" fill="white" transform="translate(79 32)"/>
+</clipPath>
+</defs>
+</svg>