Skip to main content
Glama
zeph-to

@zeph-to/mcp-server

by zeph-to

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ZEPH_API_KEYYesAPI key from Settings > API Keys
ZEPH_HOOK_IDNoHook ID for interactive tools (zeph_prompt, zeph_input)
ZEPH_BASE_URLNoAPI base URL (default: https://api.zeph.to/v1)https://api.zeph.to/v1
ZEPH_DEVICE_IDNoTarget device ID. Omit to send to all devices

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
zeph_notifyA

Send a one-way push notification to the user's devices. Use this to inform the user about task completion, errors, or status updates. Long bodies are automatically uploaded as a file for full viewing.

zeph_clipboardA

Copy text to the user's device clipboard. The text will appear in their clipboard history and can be pasted immediately.

zeph_listA

List recent push notifications. Use this to check notification history, avoid duplicates, or reference previous messages.

zeph_dismissA

Dismiss (mark as read) a specific push notification by ID. Use after processing a notification to clear it from the user's feed.

zeph_dismiss_allA

Dismiss all push notifications at once. Clears the entire notification feed.

zeph_broadcastB

Send a push notification to all subscribers of a channel. Use zeph://channels resource to find available channels.

zeph_fileA

Send a file to the user's device. Pass filePath to send a file that already exists on disk — images (png/jpg/gif/webp/heic), PDFs, logs, anything. Pass content instead to send text you generated. Images render inline on the device.

zeph_askA

Ask the user a question on their phone: quick-reply buttons plus a text field — they tap or type. Pass actions (2–4 buttons) unless the answer is free-form text. Blocks until they answer or timeout passes. Requires ZEPH_HOOK_ID. Files the user attaches arrive as local absolute paths in the result's attachments; reading them is part of the answer. Never end-to-end encrypted (unlike zeph_notify / zeph_file), so keep secrets out of the question and do not expect a private answer.

zeph_session_renameA

Set a custom display name for THIS agent session in the user's Zeph app (the Streams › Agents list). Label what this session is working on — e.g. "Prod deploy" or "Auth refactor" — so the user can tell parallel sessions apart on their phone. Renames the current session; the name persists until changed.

zeph_agent_sendA

Type a message into ANOTHER agent session on any of the user's machines, as if the user sent it from their phone. Use when the user asks you to pass something to another agent. The receiver sees [from <you>@<host> · reply: <your key>] first. Answer such a message with this tool only when it asks for an answer — two agents replying to each other loop.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
devicesList of user devices connected to Zeph with online status
channelsList of channels the user owns or subscribes to. Use to find channelId for broadcasting.

TDQS

A3.9/5.0

Scored across 10 tools

Disambiguation4/5

Most tools map to distinct communication/notification actions, and descriptions clarify the recipient and medium. zeph_notify, zeph_broadcast, zeph_file, and zeph_clipboard all deliver content to devices and could be confused at a glance, though their purposes are ultimately different.

Naming Consistency3/5

All tools share the zeph_ prefix, but the naming convention varies: some are bare verbs (zeph_notify, zeph_ask), some are nouns used as actions (zeph_file, zeph_clipboard), and some are object_verb (zeph_agent_send, zeph_session_rename). This is readable but not a predictable pattern.

Tool Count5/5

Ten tools is well-scoped for a device notification and messaging server. The set covers sending, listing, dismissing, asking, file transfer, clipboard, agent messaging, and session naming without feeling bloated or redundant.

Completeness4/5

The core notification lifecycle (send/list/dismiss/dismiss_all) and key communication paths (ask, file, agent send) are present. Channel management is delegated to a resource and there is no explicit notification update, but these are minor gaps rather than blockers.

Maintenance

ActivityActive
ResponsivenessNo issues