Vocenya Site

Official7 tools

by gadyamedia

Read-only answers from vocenya.com: plans and prices, products, industries, locations, guides.

MCP Server: com.vocenya/site

The com.vocenya/site MCP server provides read-only access to information from vocenya.com. It delivers answers covering plans and prices, products, industries, locations, and guides. The catalog entry for this server is identified by the slug com-vocenya-site and the name com.vocenya/site.

🛠️ Key Features

Read-only responses from vocenya.com
Covers: plans and prices, products, industries, locations, guides

🚀 Use Cases

Retrieve pricing and plan details
Look up product information and related industries
Find location and guide content from vocenya.com

⚠️ Limitations

No write operations (read-only access)
Tool capabilities are limited to the listed information categories

Topics

ai-agentsai-receptionistchatgptclaudeclaude-codeclaude-code-plugincursormcpmcp-servermodel-context-protocolremote-mcpsmall-businessstreamable-httpvoice-aivscodevocenya

Captured live from the server via tools/list.

get_pricing

Get Vocenya's current plans (monthly price in USD, included AI minutes, overage rate, phone numbers and features), the add-ons and each plan's free trial length (0 means no trial), exactly as published on vocenya.com/pricing.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_service

Get the full Vocenya page for a product or solution, as Markdown. Leave the slug empty to list every product page with a short description.

Parameters1

slug

string

optional

The product page, like "ai-receptionist", "live-agents" or "outbound-ai-calling".

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The product page, like \"ai-receptionist\", \"live-agents\" or \"outbound-ai-calling\".",
      "enum": [
        "about",
        "after-hours-answering-service",
        "ai-agents-for-small-business",
        "ai-answering-service",
        "ai-customer-service",
        "ai-receptionist",
        "appointment-booking",
        "appointment-reminders",
        "bilingual-receptionist",
        "business-phone-system",
        "conversational-ivr",
        "custom-solutions",
        "hipaa-ai-receptionist",
        "how-it-works",
        "integrations",
        "lead-qualification",
        "live-agents",
        "live-chat",
        "outbound-ai-calling",
        "outbound-lead-qualification",
        "virtual-receptionist",
        "whatsapp"
      ],
      "type": "string"
    }
  }
}

search_industries

Find the industries Vocenya has an AI receptionist page for, like "dentist", "plumber" or "auto repair". Returns each match's slug for get_industry, its category and page URL. Leave the query empty to list every industry.

Parameters1

query

string

optional

Words to look for in the industry name or description.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words to look for in the industry name or description.",
      "maxLength": 100,
      "type": "string"
    }
  }
}

get_industry

Get the full Vocenya page for one industry, as Markdown: why those businesses miss calls, the calls the AI receptionist handles, a sample script, what it captures and FAQs. Use a slug from search_industries.

Parameters1

slug

string

required

The industry slug, like "dentists" or "plumbers".

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The industry slug, like \"dentists\" or \"plumbers\".",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

list_locations

List the places Vocenya has local pages for (New Jersey and New York City), with their type, state, area codes and page URL. Vocenya serves businesses across the US; these are its focus areas.

Parameters1

state

string

optional

Only places in this state.

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "description": "Only places in this state.",
      "enum": [
        "NJ",
        "NY"
      ],
      "type": "string"
    }
  }
}

search_articles

Search Vocenya's guides and articles, like "cost", "HIPAA" or "speed to lead". Returns each match's slug for get_article, a short answer (TL;DR) and its URL, newest first. Leave the query empty to list every article.

Parameters1

query

string

optional

Words to look for in the article title, summary or topic.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words to look for in the article title, summary or topic.",
      "maxLength": 100,
      "type": "string"
    }
  }
}

get_article

Get one Vocenya guide or article in full, as Markdown. Use a slug from search_articles.

Parameters1

slug

string

required

The article slug, like "how-much-does-an-ai-receptionist-cost".

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The article slug, like \"how-much-does-an-ai-receptionist-cost\".",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

README.md13 KBView on GitHub

Vocenya MCP servers

Listed on mcpservers.org

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

Server	URL	Auth	What it does
Vocenya Docs	`https://vocenya.com/mcp/docs`	None	Search the Vocenya developer docs and get every REST endpoint with code samples. Read-only.
Vocenya (platform)	`https://vocenya.com/mcp/platform`	OAuth or API key	One business account's calls, leads, bookings and chats; add leads, queue outbound AI calls, update the Do Not Call list.
Vocenya Site	`https://vocenya.com/mcp/site`	None	Answers 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)

Tool	What it does
`search_docs`	Search guides (authentication, webhooks, pagination, outbound calling rules, live chat, MCP) and every API endpoint.
`get_doc_page`	One docs page as Markdown, for example `quickstart`, `webhooks` or `reference/leads`.
`list_endpoints`	REST endpoints with method, path, summary and required scope, grouped by resource.
`get_endpoint`	One endpoint in full: scope, parameters, request body, responses and code samples in cURL, Node, PHP and Python.

Vocenya platform (OAuth or API key)

Tool	Scope	What it does
`list_calls`	`calls:read`	Calls handled by the AI, GH Live agents or the team, newest first.
`get_call`	`calls:read`	One call with its leads; AI summary and transcript unless the account is in HIPAA mode.
`list_leads`	`leads:read`	Leads from calls, chats and forms.
`get_lead`	`leads:read`	One lead with contact details, reason, urgency and source.
`create_lead`	`leads:write` (+ `outbound:write` for an AI callback)	Add a lead from another system; optionally ask the AI to call back.
`list_bookings`	`bookings:read`	Appointments the AI booked into the business calendar.
`list_chats`	`chats:read`	Website live chat conversations.
`queue_outbound_call`	`outbound:write`	Ask the AI to call someone who consented. Compliance is checked first; refusals return the reason.
`add_do_not_call`	`dnc:write`	Add 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 variable
claude 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-mcp
claude 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.

Grok and Grok Bot

On Grok Business and Enterprise, add https://vocenya.com/mcp/platform as a custom MCP connector ("Bring your own MCP") and sign in with OAuth, or use an API key with read scopes only. The plugins/vocenya-grok folder packages both servers with a daily front-desk review skill for a Grok Bot: it summarizes calls, chats and leads and drafts follow-ups, and never contacts a customer without approval.

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).

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 info@gh-businesssolutions.com
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.

Install

Tools (7)

get_pricingget_servicesearch_industriesget_industrylist_locationssearch_articlesget_article

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://vocenya.com/mcp/site

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "site": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://vocenya.com/mcp/site"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Vocenya Site

MCP Server: com.vocenya/site

🛠️ Key Features

🚀 Use Cases

⚠️ Limitations

Topics

get_pricing

get_service

search_industries

get_industry

list_locations

search_articles

get_article

Vocenya MCP servers

Tools

Vocenya Docs (no key, read-only)

Vocenya platform (OAuth or API key)

Vocenya Site (no key, read-only)

Authentication

Connect

Claude Code

Claude Desktop and claude.ai

Cursor

VS Code

ChatGPT

Grok and Grok Bot

Any other client

Example prompts

Official MCP Registry

Links

Privacy

Support, security and license

Install

Remote endpoint

Related servers