---
title: Voxonics Trial MCP for AI agents
updated: 2026-10-08
---

# Voxonics Trial MCP for AI agents

This page is **basic discovery**. It tells you that a Trial MCP server exists and how to unlock the **full** capability list. It does not duplicate every tool.

## What it is

Voxonics Trial MCP lets an AI agent activate a free Cloud PBX trial and operate it with tools: business number (v-num), users/extensions, departments, inbound/outbound routing, call history, recordings, and a small calling credit.

| Limit | Value |
|-------|--------|
| Business numbers (v-nums) | 1 |
| Users (extensions), including owner | up to 3 |
| Calling credit | USD 1.00 |
| Trial dashboard | https://trial.voxonics.com |

## MCP endpoint

- **MCP server URL:** https://trial.voxonics.com/mcp/
- **Human dashboard:** https://trial.voxonics.com
- **Site auth (humans / REST agents):** https://www.voxonics.com/auth.md

Connect your MCP client (Cursor, Claude, custom agent runtime) to the MCP URL above.

## How to get detailed capabilities (required)

This site page is intentionally short. **Live, complete capabilities** come from the MCP server after you connect:

1. Connect to `https://trial.voxonics.com/mcp/`
2. Call the tool **`get_platform_capabilities`** (no session required)
3. Use the returned `available_via_mcp`, `dashboard_only`, `feature_guide`, `trial_limits`, and `current_restrictions`

Do **not** invent tools or claim a feature is missing without calling `get_platform_capabilities`.

Optional machine metadata on the MCP host (when deployed): `GET https://trial.voxonics.com/.well-known/mcp.json` (or the path your deploy advertises next to `/mcp/`).

## How to register and get a session (for AI agents)

### Path A — via Trial MCP (preferred once connected)

1. `start_trial(email, company_name)` → status `pending_verification`
2. Read the user’s inbox; open the Voxonics verification mail
3. Extract the slug from `https://www.voxonics.com/auth/verify/{slug}`
4. `submit_verification_code(email, slug)` → `session_token` + active trial
5. Keep `session_token` for later tools (or `Authorization: Bearer` if the client supports headers)
6. Existing account: `login_trial` with email+password or extension `internal_number`+password

### Path B — via site (no MCP)

1. Register / verify / sign-in using https://www.voxonics.com/auth.md
2. Create trial via Site Control API (`users/me/trial/create-account`)
3. Use the dashboard at https://trial.voxonics.com

Human signup UI: https://www.voxonics.com/auth

## What you can do after auth (summary)

Exact tool names and availability: call **`get_platform_capabilities`**. Typical trial MCP surface includes:

- Trial status and balance
- Place / poll calls; list and export call history
- Create users (within the 3-user cap)
- Departments; outbound caller-ID routes; inbound scenarios
- Recordings export / fetch

Dashboard-only features (rich IVR builder, dialer campaigns, etc.) are listed under `dashboard_only` — send the human to https://trial.voxonics.com

## Safety rules for agents

- Confirm the destination before `place_call` (real credit, real ring)
- Do not promise more than trial limits
- Inactive unused accounts may be cleaned up by the site (unverified ~2 days; idle verified ~3+3 days) — see MCP standing instructions after connect

## Related links

| Resource | URL |
|----------|-----|
| This page (HTML) | https://www.voxonics.com/developers/agent-trial |
| This page (markdown) | https://www.voxonics.com/developers/agent-trial.md |
| This page (JSON) | https://www.voxonics.com/developers/agent-trial.json |
| Site auth guide | https://www.voxonics.com/auth.md |
| Trial MCP endpoint | https://trial.voxonics.com/mcp/ |
| Trial dashboard | https://trial.voxonics.com |
| Agent skill (MCP) | https://www.voxonics.com/.well-known/agent-skills/voxonics-mcp/SKILL.md |
| Agent skill (REST trial) | https://www.voxonics.com/.well-known/agent-skills/voxonics-trial/SKILL.md |