Vocenya

com.vocenyav1.1.0更新於 Oct 5, 2026

Calls, leads, bookings, chats, outbound AI calls and Do Not Call for one Vocenya business.

概覽

AI 產生的概覽

讓助理讀取並操作某個 Vocenya 商家帳戶的通話、潛在客戶、預約和聊天,並可排入外撥 AI 電話。

功能
平台伺服器對應一個 Vocenya 商家帳戶:列出與查看通話(除非帳戶處於 HIPAA 模式,否則含 AI 摘要與逐字稿)、列出與查看潛在客戶、建立潛在客戶、列出預約與網站聊天、排入外撥 AI 電話,以及把號碼加入 Do Not Call 名單。每個工具各自檢查權限範圍,只有讀取權限的金鑰無法排入外撥。另有兩個搭配的伺服器提供 Vocenya 開發者文件與官網公開資訊,皆為唯讀。
適用情境
適合讓助理回答某商家的電話與聊天活動問題、取出潛在客戶或預約、從其他系統寫入潛在客戶,或要求 AI 回電。文件與官網伺服器適合回答 Vocenya API 以及方案與產品相關問題。
執行需求
遠端 Streamable HTTP 端點,無需安裝。平台伺服器需要帳戶擁有者以 OAuth 登入,或使用 Authorization 標頭帶 Bearer API 金鑰(vk_live_ 或 vk_test_)。文件與官網伺服器無需驗證。有速率限制:公開伺服器每 IP 每分鐘 60 次請求,平台伺服器每把金鑰每分鐘 120 次。
安裝前請注意
平台伺服器會讀取客戶通話逐字稿、潛在客戶與聊天訊息,並可寫入:create_lead、queue_outbound_call 和 add_do_not_call 會變更帳戶資料或觸發真實通話。Authorization 金鑰應放在環境變數中,切勿貼到聊天或提交到程式庫。測試金鑰使用範例資料,不會真正撥號。HIPAA 模式帳戶不傳回逐字稿、摘要或聊天訊息,連接 AI 用戶端也不會讓該用戶端受 BAA 涵蓋。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Vocenya,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "platform": {
      "type": "http",
      "url": "https://vocenya.com/mcp/platform"
    }
  }
}

README

Vocenya MCP servers

[License: MIT] [MCP Registry]

[Vocenya Site on AllMCPs] [Vocenya on AllMCPs] [Vocenya Docs on AllMCPs]

Connect Claude, ChatGPT, Cursor, VS Code and other AI assistants to Vocenya, the AI receptionist for small businesses made by GH Business Solutions, and to its developer docs.

Vocenya answers phone calls and website chats 24/7, books appointments, captures leads, hands calls to trained people and places outbound AI calls with Do Not Call, consent and calling-hours checks. It runs three remote Model Context Protocol servers over Streamable HTTP. Nothing to install: point your client at a URL.

Full guide: https://vocenya.com/docs/mcp

ServerURLAuthWhat it does
Vocenya Docshttps://vocenya.com/mcp/docsNoneSearch the Vocenya developer docs and get every REST endpoint with code samples. Read-only.
Vocenya (platform)https://vocenya.com/mcp/platformOAuth or API keyOne business account's calls, leads, bookings and chats; add leads, queue outbound AI calls, update the Do Not Call list.
Vocenya Sitehttps://vocenya.com/mcp/siteNoneAnswers about Vocenya itself from vocenya.com: plans and prices, products, industries, locations, guides. Read-only.

The public servers allow 60 requests a minute per IP address. The platform server shares the API key's REST limit (120 requests a minute per key by default).

This repository holds the official MCP Registry entries, a Claude Code plugin and these instructions. The servers are hosted by Vocenya; their code is not here.

Tools

Vocenya Docs (no key, read-only)

ToolWhat it does
search_docsSearch guides (authentication, webhooks, pagination, outbound calling rules, live chat, MCP) and every API endpoint.
get_doc_pageOne docs page as Markdown, for example quickstart, webhooks or reference/leads.
list_endpointsREST endpoints with method, path, summary and required scope, grouped by resource.
get_endpointOne endpoint in full: scope, parameters, request body, responses and code samples in cURL, Node, PHP and Python.

Vocenya platform (OAuth or API key)

ToolScopeWhat it does
list_callscalls:readCalls handled by the AI, GH Live agents or the team, newest first.
get_callcalls:readOne call with its leads; AI summary and transcript unless the account is in HIPAA mode.
list_leadsleads:readLeads from calls, chats and forms.
get_leadleads:readOne lead with contact details, reason, urgency and source.
create_leadleads:write (+ outbound:write for an AI callback)Add a lead from another system; optionally ask the AI to call back.
list_bookingsbookings:readAppointments the AI booked into the business calendar.
list_chatschats:readWebsite live chat conversations.
queue_outbound_calloutbound:writeAsk the AI to call someone who consented. Compliance is checked first; refusals return the reason.
add_do_not_calldnc:writeAdd a number to the business's Do Not Call list.

Each tool checks its own scope (the API key's, or the scopes an owner approved when connecting with OAuth), so a key with only leads:read can read leads but cannot queue calls. Test keys (vk_test_...) work on separate sample data and never ring anyone. Accounts in HIPAA mode never return transcripts, AI summaries or chat messages through MCP.

Vocenya Site (no key, read-only)

get_pricing, get_service, search_industries, get_industry, list_locations, search_articles, get_article, and the resource vocenya://llms.txt.

Authentication

  • Docs and Site: none.
  • Platform, OAuth (no key): clients that sign in with OAuth (Claude Code, Claude connectors, ChatGPT developer mode and others) just need the URL. The client registers itself, then an account owner signs in to Vocenya and chooses the account, live or test data, and the permissions (the same scopes as API keys). Owners see and disconnect connected apps on the Developers page: https://vocenya.com/app/developers. The server supports OAuth 2.1 authorization code with PKCE (S256) and dynamic client registration.
  • Platform, API key: Authorization: Bearer vk_live_... (or vk_test_... for test data). The account owner creates keys, each with its own scopes, on the same Developers page. Keep keys in environment variables; never paste them into a chat or commit them.

Connect

Claude Code

bash
# Docs (no key)claude mcp add --transport http vocenya-docs https://vocenya.com/mcp/docs
# Platform with OAuth (Claude Code opens the Vocenya sign-in)claude mcp add --transport http vocenya https://vocenya.com/mcp/platform
# Or platform with an API key in an environment variableclaude mcp add --transport http vocenya https://vocenya.com/mcp/platform \  --header "Authorization: Bearer $VOCENYA_API_KEY"

Or install the plugin from this repository, which adds the docs server and two skills (REST API and webhooks, website live chat install):

bash
claude plugin marketplace add gadyamedia/vocenya-mcpclaude plugin install vocenya@vocenya

Claude Desktop and claude.ai

Docs server: Settings > Connectors > Add custom connector, URL https://vocenya.com/mcp/docs, no authentication.

Platform server: add a custom connector with the URL https://vocenya.com/mcp/platform and sign in with your Vocenya owner account (OAuth).

Or, with an API key, through the mcp-remote bridge in claude_desktop_config.json:

json
{    "mcpServers": {        "vocenya": {            "command": "npx",            "args": [                "-y",                "mcp-remote",                "https://vocenya.com/mcp/platform",                "--header",                "Authorization:${VOCENYA_AUTH}"            ],            "env": {                "VOCENYA_AUTH": "Bearer paste-your-key-here"            }        }    }}

Cursor

~/.cursor/mcp.json:

json
{    "mcpServers": {        "vocenya-docs": { "url": "https://vocenya.com/mcp/docs" },        "vocenya": {            "url": "https://vocenya.com/mcp/platform",            "headers": { "Authorization": "Bearer ${env:VOCENYA_API_KEY}" }        }    }}

VS Code

.vscode/mcp.json (VS Code asks for the key once and stores it securely):

json
{    "inputs": [        {            "type": "promptString",            "id": "vocenya-key",            "description": "Vocenya API key (vk_live_... or vk_test_...)",            "password": true        }    ],    "servers": {        "vocenya-docs": {            "type": "http",            "url": "https://vocenya.com/mcp/docs"        },        "vocenya": {            "type": "http",            "url": "https://vocenya.com/mcp/platform",            "headers": { "Authorization": "Bearer ${input:vocenya-key}" }        }    }}

ChatGPT

Turn on developer mode, then add a custom connector with the URL https://vocenya.com/mcp/docs and no authentication. For your account data, add https://vocenya.com/mcp/platform with OAuth and sign in with your Vocenya owner account.

Any other client

Any client that supports Streamable HTTP works. For the platform server, sign in with OAuth, or send Authorization: Bearer <your key>.

Example prompts

  • "Using the Vocenya docs, how do I verify a webhook signature? Show Node code."
  • "Which scope do I need to create a lead, and what does the request body look like?"
  • "Show the leads my AI receptionist captured this week." (platform)
  • "What appointments did the AI book for next Monday?" (platform)
  • "How much does Vocenya cost and how many AI minutes does each plan include?" (site)

Official MCP Registry

The files in registry/ are the entries published to the official MCP Registry under the com.vocenya namespace (com.vocenya/docs, com.vocenya/platform, com.vocenya/site).

Links

Privacy

The docs and site servers are read-only and cannot see any customer account. The platform server sees only the one business account that owns the API key (or that an owner chose when connecting with OAuth), and only what the approved scopes allow. HIPAA mode is a paid add-on with a signed BAA; connecting an AI client does not make that client covered by the BAA, so only send patient data to AI tools you have your own agreements with. Full policy: https://vocenya.com/privacy

Support, security and license

  • Questions and corrections: open an issue, or email [email protected]
  • Security reports: see SECURITY.md
  • License: MIT for the contents of this repository. The Vocenya service itself is a hosted commercial product under the Vocenya terms.

Copyright (c) 2026 DRAKB LLC dba GH Business Solutions.

來源:README.md,提交 8d0aaaa

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.1.0最新Oct 5, 2026