vox.ai MCP 서버는 19개 도구를 7개 그룹으로 제공합니다. 인증 방식은 인증 모델을 참고하세요.
| 도구 | 설명 | 인증 제한 |
|---|
list_organizations | 현재 사용자가 속한 조직 목록 | OAuth만 (API 토큰 불가) |
에이전트
| 도구 | 설명 | 주요 파라미터 |
|---|
create_agent | 새 에이전트 생성 | name, agent_type, prompt, data |
update_agent | 기존 에이전트 수정 (PATCH 방식) | agent_id, 변경할 필드 |
get_agent | 에이전트 상세 조회 | agent_id |
list_agents | 조직의 에이전트 목록 조회 | — |
agent_type 허용값: single_prompt (프롬프트 에이전트), flow (플로우 에이전트)
data 주요 필드: first_message, voice, tools, llm, speech_settings
가이드: 에이전트 생성과 수정
| 도구 | 설명 | 주요 파라미터 |
|---|
create_call | 아웃바운드 단건 통화 실행 | agent_id, call_from, call_to, dynamic_variables |
get_call | 통화 기록 상세 조회 (스크립트, 녹음, 비용) | call_id |
list_calls | 통화 기록 목록 조회 | agent_id, call_type, disconnection_reason, sort_by |
call_from, call_to 포맷: E.164 (+821012345678)
dynamic_variables: key-value 객체 (예: {"customer_name": "한승준"})
가이드: 통화 실행과 확인
캠페인
| 도구 | 설명 | 주요 파라미터 |
|---|
create_campaign | 대량 아웃바운드 캠페인 생성 | name, agent_id, call_from, tasks[], concurrency |
list_campaigns | 캠페인 목록 조회 | status, agent_id, sort_order |
tasks[]: 발신 대상 배열. 각 항목에 call_to와 dynamic_variables 포함
가이드: 대량 발신
커스텀 도구
| 도구 | 설명 |
|---|
create_custom_tool | 에이전트용 커스텀 도구 생성 (API 또는 MCP 타입) |
list_custom_tools | 조직의 커스텀 도구 목록 조회 |
delete_custom_tool | 커스텀 도구 삭제 |
전화번호
| 도구 | 설명 | 주요 파라미터 |
|---|
list_available_telephone_numbers | 구매 가능한 번호 목록 (플랫폼 재고) | number_type |
create_telephone_number | 번호 구매(vox) 또는 등록(custom) | number, number_type, address, inbound_agent_id |
list_telephone_numbers | 보유 번호 목록 | number_type, status |
update_telephone_number | 번호 설정 수정 (PATCH) | record_id, inbound_agent_id, outbound_agent_id |
| 도구 | 설명 | 주요 파라미터 |
|---|
create_ut_eval | 유닛 테스트 생성 | agent_id, name, scenario_prompt, expected_data, eval_criteria |
list_ut_evals | 유닛 테스트 목록 조회 | agent_id, status, limit, offset |
get_ut_eval | 유닛 테스트 상세 조회 (결과 포함) | ut_test_id |
run_ut_eval_batch | 배치 실행 | ut_test_ids[], agent_id (override) |
get_ut_eval_batch_result | 배치 결과 조회 (pass/fail 집계) | batch_id |
관련 문서
MCP 도구, create_agent, create_call, create_campaign, list_agents, get_call, 커스텀 도구, 전화번호, 평가, 유닛 테스트
