Skip to main content
Glama
ZhipingYang

TelePath PSTN MCP

by ZhipingYang

TelePath PSTN MCP

通过 AI 助手控制 TelePath 进行 PSTN 电话呼叫。

快速开始

1. 安装依赖

npm install

2. 配置 MCP

在 Cursor 或 Claude Desktop 的 MCP 配置中添加:

{
  "mcpServers": {
    "telepath": {
      "command": "node",
      "args": ["/path/to/telepath-mcp-server.js"],
      "env": {
        "TELEPATH_USERNAME": "your_username",
        "TELEPATH_PASSWORD": "your_password"
      }
    }
  }
}

3. 使用

在 AI 对话中直接说:

  • "拨打 +1 (212) 888-1843"

  • "我有哪些可用的电话号码?"

  • "新增一个电话号码"

  • "挂断电话"

Related MCP server: AgentPhone MCP Server

可用工具

工具

说明

telepath_make_call

📞 拨打电话

telepath_hangup

📴 挂断通话

telepath_list_phones

📱 查看电话列表

telepath_call_status

📊 查看通话状态

telepath_add_phone

➕ 新增电话号码

telepath_delete_phone

🗑️ 删除电话号码

telepath_stop_browser

🛑 停止服务

限制

  • ⚠️ 同一 Board 最多同时注册 3 个电话号码

  • 电话号码格式: +1209888xxxx (随机生成)

  • 推荐环境: XMR-UP-XMN

文档

详细技术文档请参阅 TEC.md

环境要求

  • Node.js 18+

  • Chrome 浏览器 (Puppeteer 自动下载)

  • TelePath 账号

测试结果 (2026-01-05)

✅ 通过 API 创建随机号码可正常注册和拨打 ✅ 成功拨打真实外部号码 (+12128881843) ✅ 删除电话 API 工作正常

许可证

MIT

Available Tools

1 tool
telepath_setup_helpA

⚠️ TelePath 未配置。请设置环境变量:

  • TELEPATH_USERNAME: 你的用户名

  • TELEPATH_PASSWORD: 你的密码

配置方式:

  1. 在 MCP 配置中添加 env

  2. 或在 shell 中 export 环境变量

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description bears full responsibility for disclosing behavior. It communicates that the tool surfaces setup instructions, but it doesn't explicitly state that the tool performs no configuration itself or describe the output format. The instructional tone implies it's informational, but this could be more explicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured, using a warning icon, bulleted list of environment variables, and numbered configuration steps. Every element serves a purpose, and the most critical information (missing configuration) is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a setup-help tool with no parameters, no output schema, and no annotations, the description fully covers the necessary context: the problem, the specific environment variables needed, and two ways to set them. It is self-contained and complete for its intended use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, and the schema is empty. According to the rubric, 0 params earns a baseline score of 4. The description adds no parameter details simply because there are none to explain.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states the tool's purpose: addressing TelePath not being configured and instructing the user to set environment variables. It names the specific resources (TELEPATH_USERNAME, TELEPATH_PASSWORD) and provides actionable steps, making the intent unambiguous even without sibling tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description clearly defines the context in which this tool is relevant: when TelePath is unconfigured. It lists two concrete configuration methods, giving the agent and user clear usage guidance. While it doesn't mention alternatives or exclusions, the absence of siblings makes this acceptable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.2.0
    • First observedtelepath_setup_help

TDQS

A3.7/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap. The tool's purpose as a setup/help guide is clear, though it is not a domain operation.

Naming Consistency5/5

A single tool cannot exhibit inconsistency. The name telepath_setup_help follows a clear snake_case convention, which is acceptable.

Tool Count1/5

The server is named 'TelePath PSTN MCP' but exposes only a setup help tool, not a single actual PSTN operation. This is a severe under-scoping for the apparent domain.

Completeness1/5

The tool surface is almost empty. There are no tools for making calls, managing numbers, or any other PSTN functionality. The setup help tool does not contribute to the server's intended purpose.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    B
    quality
    F
    maintenance
    Enables interaction with Telnyx's telephony, messaging, and AI assistant APIs to manage phone numbers, send messages, make calls, and create AI assistants. Includes webhook support for real-time event handling and comprehensive tools for voice, SMS, cloud storage, and embeddings.
    46
    25
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to place VoIP phone calls via Asterisk, play TTS messages, capture DTMF input, and optionally record and transcribe voice responses.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to make real outbound phone calls to US/Canada numbers, handle conversations, and return transcripts and recordings via the Model Context Protocol.
    7
    MIT