geniete-mcp 0.1.0__tar.gz

geniete_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Genie, Inc.
+
+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.

geniete_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: geniete-mcp
+Version: 0.1.0
+Summary: GenieTé MCP server — screens, voice, and channels tools for AI agents
+License: MIT
+License-File: LICENSE
+Keywords: mcp,agents,geniete,tts,pubsub,screens
+Author: Genie, Inc.
+Author-email: renat@geniete.com
+Requires-Python: >=3.10
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Dist: httpx (>=0.27.0)
+Requires-Dist: mcp (>=1.0.0)
+Project-URL: Company, https://www.genieinc.com/
+Project-URL: Homepage, https://www.geniete.com/
+Description-Content-Type: text/markdown
+
+# geniete-mcp
+
+One MCP server for the whole [GenieTé](https://www.geniete.com/) suite —
+give an AI agent a live screen, a voice, and a realtime channel with one
+install. Tools appear only for the services you configure.
+
+```bash
+uv tool install geniete-mcp     # or: pip install geniete-mcp
+```
+
+```json
+{
+  "mcpServers": {
+    "geniete": {
+      "command": "geniete-mcp",
+      "env": {
+        "AGENTSCREEN_API_KEY":   "as_key_...",
+        "AGENTSCREEN_SCREEN_ID": "scr_...",
+        "VOICE_API_KEY":         "vk_...",
+        "VOICE_SPEAKER_ID":      "spk_...",
+        "CHANNELS_TOKEN":        "tok_...",
+        "CHANNELS_CHANNEL_ID":   "chan_..."
+      }
+    }
+  }
+}
+```
+
+Configure any subset — each pair of env vars switches on its tool group:
+
+| Tools | Service |
+|-------|---------|
+| `screen_message` `screen_metric` `screen_terminal` `screen_clear` `screen_link` | [Screens](https://screens.geniete.com/docs/screens/) |
+| `voice_say` `voice_speak_url` `voice_listen_link` `voice_voices` | [Voice](https://voice.geniete.com/docs/voice/) |
+| `channel_publish` `channel_ticket` | [Channels](https://channels.geniete.com/docs/channels/) |
+
+Keys come from each service's console; one GenieTé account and one
+shared credit balance cover all of them (account.geniete.com).
+
+MIT © Genie, Inc.
+

geniete_mcp-0.1.0/README.md

@@ -0,0 +1,40 @@
+# geniete-mcp
+
+One MCP server for the whole [GenieTé](https://www.geniete.com/) suite —
+give an AI agent a live screen, a voice, and a realtime channel with one
+install. Tools appear only for the services you configure.
+
+```bash
+uv tool install geniete-mcp     # or: pip install geniete-mcp
+```
+
+```json
+{
+  "mcpServers": {
+    "geniete": {
+      "command": "geniete-mcp",
+      "env": {
+        "AGENTSCREEN_API_KEY":   "as_key_...",
+        "AGENTSCREEN_SCREEN_ID": "scr_...",
+        "VOICE_API_KEY":         "vk_...",
+        "VOICE_SPEAKER_ID":      "spk_...",
+        "CHANNELS_TOKEN":        "tok_...",
+        "CHANNELS_CHANNEL_ID":   "chan_..."
+      }
+    }
+  }
+}
+```
+
+Configure any subset — each pair of env vars switches on its tool group:
+
+| Tools | Service |
+|-------|---------|
+| `screen_message` `screen_metric` `screen_terminal` `screen_clear` `screen_link` | [Screens](https://screens.geniete.com/docs/screens/) |
+| `voice_say` `voice_speak_url` `voice_listen_link` `voice_voices` | [Voice](https://voice.geniete.com/docs/voice/) |
+| `channel_publish` `channel_ticket` | [Channels](https://channels.geniete.com/docs/channels/) |
+
+Keys come from each service's console; one GenieTé account and one
+shared credit balance cover all of them (account.geniete.com).
+
+MIT © Genie, Inc.

geniete_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+# Publishes to PyPI as "geniete-mcp"
+# Install:  uv tool install geniete-mcp
+#
+# Public package: NO GenieForge dependencies. One MCP server for the whole
+# GenieTé suite — tools appear only for the services you configure via env.
+[project]
+name = "geniete-mcp"
+version = "0.1.0"
+description = "GenieTé MCP server — screens, voice, and channels tools for AI agents"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["mcp", "agents", "geniete", "tts", "pubsub", "screens"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+geniete-mcp = "geniete_mcp.server:main"
+
+[project.urls]
+Homepage = "https://www.geniete.com/"
+Company = "https://www.genieinc.com/"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "geniete-mcp"
+version = "0.1.0"
+description = "GenieTé MCP server"
+authors = ["Genie, Inc. <renat@geniete.com>"]
+packages = [{ include = "geniete_mcp", from = "src" }]
+
+[tool.poetry.dependencies]
+python = ">=3.10"
+mcp = ">=1.0.0"
+httpx = ">=0.27.0"
+
+[tool.poetry.scripts]
+geniete-mcp = "geniete_mcp.server:main"

geniete_mcp-0.1.0/src/geniete_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

geniete_mcp-0.1.0/src/geniete_mcp/server.py

@@ -0,0 +1,237 @@
+"""
+GenieTé MCP server — one server, the whole suite. Tools appear only for
+the services you configure:
+
+    {
+      "mcpServers": {
+        "geniete": {
+          "command": "geniete-mcp",
+          "env": {
+            "AGENTSCREEN_API_KEY":   "as_key_...",   // screens tools
+            "AGENTSCREEN_SCREEN_ID": "scr_...",
+            "VOICE_API_KEY":         "vk_...",       // voice tools
+            "VOICE_SPEAKER_ID":      "spk_...",
+            "CHANNELS_TOKEN":        "tok_...",      // channels tools
+            "CHANNELS_CHANNEL_ID":   "chan_..."
+          }
+        }
+      }
+    }
+
+Tools (per configured service):
+    screen_message / screen_metric / screen_terminal / screen_clear / screen_link
+    voice_say / voice_speak_url / voice_listen_link / voice_voices
+    channel_publish / channel_ticket
+"""
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+import uuid
+from typing import Any
+
+import httpx
+from mcp.server import Server
+from mcp.server.stdio import stdio_server
+from mcp.types import TextContent, Tool
+
+_TONES = ("info", "success", "warning", "error")
+
+
+def _env(name: str, default: str = "") -> str:
+    return os.environ.get(name, default).strip()
+
+
+class Config:
+    """Read once; each service group is on when its env pair is set."""
+
+    def __init__(self) -> None:
+        self.screens_key = _env("AGENTSCREEN_API_KEY")
+        self.screens_id = _env("AGENTSCREEN_SCREEN_ID")
+        self.screens_base = _env("AGENTSCREEN_BASE_URL", "https://screens.geniete.com").rstrip("/")
+        self.voice_key = _env("VOICE_API_KEY")
+        self.voice_id = _env("VOICE_SPEAKER_ID")
+        self.voice_base = _env("VOICE_BASE_URL", "https://voice.geniete.com").rstrip("/")
+        self.channels_token = _env("CHANNELS_TOKEN")
+        self.channels_id = _env("CHANNELS_CHANNEL_ID")
+        self.channels_base = _env("CHANNELS_BASE_URL", "https://channels.geniete.com").rstrip("/")
+
+    @property
+    def screens_on(self) -> bool:
+        return bool(self.screens_key and self.screens_id)
+
+    @property
+    def voice_on(self) -> bool:
+        return bool(self.voice_key and self.voice_id)
+
+    @property
+    def channels_on(self) -> bool:
+        return bool(self.channels_token and self.channels_id)
+
+
+def available_tools(cfg: Config) -> list[Tool]:
+    tools: list[Tool] = []
+    if cfg.screens_on:
+        tools += [
+            Tool(name="screen_message",
+                 description="Show a status card on the live screen (title, body, tone info|success|warning|error).",
+                 inputSchema={"type": "object", "properties": {
+                     "body": {"type": "string"}, "title": {"type": "string"},
+                     "tone": {"type": "string", "enum": list(_TONES)}},
+                     "required": ["body"]}),
+            Tool(name="screen_metric",
+                 description="Push a named metric tile (updated in place by name).",
+                 inputSchema={"type": "object", "properties": {
+                     "name": {"type": "string"}, "value": {"type": ["number", "string"]},
+                     "unit": {"type": "string"}}, "required": ["name", "value"]}),
+            Tool(name="screen_terminal",
+                 description="Append text to the screen's terminal block (include your own newlines).",
+                 inputSchema={"type": "object", "properties": {"text": {"type": "string"}},
+                              "required": ["text"]}),
+            Tool(name="screen_clear",
+                 description="Clear everything currently shown on the screen.",
+                 inputSchema={"type": "object", "properties": {}}),
+            Tool(name="screen_link",
+                 description="Mint a one-time viewer URL for the screen (share it; previews can't consume it).",
+                 inputSchema={"type": "object", "properties": {
+                     "ttl_seconds": {"type": "integer"}}}),
+        ]
+    if cfg.voice_on:
+        tools += [
+            Tool(name="voice_say",
+                 description="Speak text out loud on every open listen page of the speaker (pump mode; nothing returned but the charge).",
+                 inputSchema={"type": "object", "properties": {
+                     "text": {"type": "string"}, "voice_id": {"type": "string"}},
+                     "required": ["text"]}),
+            Tool(name="voice_speak_url",
+                 description="Turn text into speech and return a hosted MP3 link (kept ~1 day, plays anywhere).",
+                 inputSchema={"type": "object", "properties": {
+                     "text": {"type": "string"}, "voice_id": {"type": "string"}},
+                     "required": ["text"]}),
+            Tool(name="voice_listen_link",
+                 description="Mint a standing speaker-page link — open it on any device; every voice_say plays there.",
+                 inputSchema={"type": "object", "properties": {
+                     "ttl_seconds": {"type": "integer"}}}),
+            Tool(name="voice_voices",
+                 description="List the available voice ids.",
+                 inputSchema={"type": "object", "properties": {}}),
+        ]
+    if cfg.channels_on:
+        tools += [
+            Tool(name="channel_publish",
+                 description="Publish a JSON payload to the channel; returns how many subscribers received it.",
+                 inputSchema={"type": "object", "properties": {
+                     "payload": {"type": "object"}}, "required": ["payload"]}),
+            Tool(name="channel_ticket",
+                 description="Mint a one-time 30-second subscribe credential for a browser client.",
+                 inputSchema={"type": "object", "properties": {}}),
+        ]
+    return tools
+
+
+# ── HTTP helpers (sync httpx; called via to_thread) ──────────────────
+
+def _post(url: str, bearer: str, body: dict, *, transport: Any = None) -> httpx.Response:
+    with httpx.Client(timeout=130.0, transport=transport) as c:
+        return c.post(url, headers={"Authorization": f"Bearer {bearer}",
+                                    "Content-Type": "application/json"}, json=body)
+
+
+def _get(url: str, *, transport: Any = None) -> httpx.Response:
+    with httpx.Client(timeout=30.0, transport=transport) as c:
+        return c.get(url)
+
+
+def dispatch(cfg: Config, name: str, args: dict, *, transport: Any = None) -> str:
+    """Execute one tool call; returns the text result. Raises nothing —
+    API refusals come back as readable text (agents retry better on
+    words than on tracebacks)."""
+    def screens_event(event: dict) -> str:
+        r = _post(f"{cfg.screens_base}/public/api/publish", cfg.screens_key,
+                  {"screen_id": cfg.screens_id, "event": event}, transport=transport)
+        return "published" if r.status_code < 400 else f"refused: {r.text[:300]}"
+
+    if name == "screen_message":
+        tone = args.get("tone", "info")
+        return screens_event({"type": "content.message", "title": args.get("title", ""),
+                              "body": str(args.get("body", ""))[:8192],
+                              "tone": tone if tone in _TONES else "info"})
+    if name == "screen_metric":
+        return screens_event({"type": "metric.update", "name": str(args["name"])[:100],
+                              "value": args["value"], "unit": args.get("unit", "")})
+    if name == "screen_terminal":
+        return screens_event({"type": "terminal.append", "text": str(args["text"])[:32768]})
+    if name == "screen_clear":
+        return screens_event({"type": "display.clear"})
+    if name == "screen_link":
+        r = _post(f"{cfg.screens_base}/public/api/screens/{cfg.screens_id}/tokens",
+                  cfg.screens_key,
+                  {"type": "one-time", "ttl_seconds": int(args.get("ttl_seconds", 3600))},
+                  transport=transport)
+        return r.json().get("url", "") if r.status_code < 400 else f"refused: {r.text[:300]}"
+
+    if name in ("voice_say", "voice_speak_url"):
+        body = {"speaker_id": cfg.voice_id, "voice_id": args.get("voice_id", "kanika"),
+                "text": str(args.get("text", ""))[:4000],
+                "request_id": f"mcp_{uuid.uuid4().hex[:16]}"}
+        body["deliver" if name == "voice_speak_url" else "return_audio"] = (
+            "url" if name == "voice_speak_url" else False)
+        r = _post(f"{cfg.voice_base}/public/api/speak", cfg.voice_key, body, transport=transport)
+        if r.status_code >= 400:
+            return f"refused: {r.text[:300]}"
+        d = r.json()
+        return d.get("url") or f"spoken ({d.get('charged_credits', '?')} credits)"
+    if name == "voice_listen_link":
+        body = {"ttl_seconds": int(args["ttl_seconds"])} if args.get("ttl_seconds") else {}
+        r = _post(f"{cfg.voice_base}/public/api/speakers/{cfg.voice_id}/listen-links",
+                  cfg.voice_key, body, transport=transport)
+        return r.json().get("url", "") if r.status_code < 400 else f"refused: {r.text[:300]}"
+    if name == "voice_voices":
+        r = _get(f"{cfg.voice_base}/public/api/voices", transport=transport)
+        if r.status_code >= 400:
+            return f"refused: {r.text[:300]}"
+        return ", ".join(v.get("id", "") for v in r.json().get("voices", []))
+
+    if name == "channel_publish":
+        r = _post(f"{cfg.channels_base}/api/v1/publish/{cfg.channels_id}",
+                  cfg.channels_token, dict(args.get("payload") or {}), transport=transport)
+        if r.status_code >= 400:
+            return f"refused: {r.text[:300]}"
+        return f"delivered to {r.json().get('receivers', 0)} subscriber(s)"
+    if name == "channel_ticket":
+        r = _post(f"{cfg.channels_base}/api/v1/channels/{cfg.channels_id}/tickets",
+                  cfg.channels_token, {}, transport=transport)
+        return json.dumps(r.json()) if r.status_code < 400 else f"refused: {r.text[:300]}"
+
+    return f"unknown tool: {name}"
+
+
+def build_server(cfg: Config) -> Server:
+    server = Server("geniete")
+
+    @server.list_tools()
+    async def list_tools() -> list[Tool]:
+        return available_tools(cfg)
+
+    @server.call_tool()
+    async def call_tool(name: str, arguments: dict) -> list[TextContent]:
+        text = await asyncio.to_thread(dispatch, cfg, name, arguments or {})
+        return [TextContent(type="text", text=text)]
+
+    return server
+
+
+def main() -> None:
+    cfg = Config()
+    server = build_server(cfg)
+
+    async def run() -> None:
+        async with stdio_server() as (read, write):
+            await server.run(read, write, server.create_initialization_options())
+
+    asyncio.run(run())
+
+
+if __name__ == "__main__":
+    main()