MCP Tools Reference

All tools are called via the MCP protocol over SSE transport. Each tool requires authentication unless running in demo mode.

Gendered Languages

Languages like Hebrew, Arabic, French, Spanish, Portuguese, Italian, German, Russian, Polish, and Hindi conjugate verbs and adjectives by gender. For these languages:

• Agent gender (agentGender) — set during provisioning (male/female/neutral). Determines how the AI refers to itself.
• Target gender (targetGender) — set per-interaction on outbound tools (male/female/unknown). Determines how the AI addresses the recipient.

For voice calls, gender conjugation instructions are automatically appended to the system prompt. For text messages, gender context is returned as metadata in the response so your AI can conjugate correctly.

Non-gendered languages (English, Chinese, Japanese, etc.) are unaffected — the gender parameters are accepted but produce no instructions.

comms_ping

Health check and connectivity test.

{
"status": "ok",
"server": "agentos-comms",
"echo": "hello",
"pool": { "maxAgents": 5, "activeAgents": 1, "slotsRemaining": 4 },
"providers": { "telephony": "twilio", "email": "resend", "tts": "edge-tts" }
}

comms_send_message

Send SMS, email, or WhatsApp message.

{
"success": true,
"messageId": "uuid",
"externalId": "SMxxxxxx",
"status": "queued",
"cost": 0.0075,
"channel": "sms",
"from": "+15551234567",
"to": "+15559876543",
"genderContext": { "agentGender": "male", "targetGender": "female" }
}

Compliance checks: Content filter, DNC list, TCPA time-of-day, CAN-SPAM (email).

comms_make_call

Initiate an outbound AI voice call.

{
"success": true,
"callSid": "CAxxxxxx",
"sessionId": "uuid",
"status": "queued",
"from": "+15551234567",
"to": "+15559876543"
}

comms_send_voice_message

Generate TTS audio and deliver via phone call.

comms_get_waiting_messages

Fetch messages that couldn't be delivered while your agent was offline (dead letters). Fetching automatically acknowledges them — no separate step needed.

{
"success": true,
"messages": [
{
"id": 1,
"channel": "sms",
"direction": "inbound",
"from": "+15559876543",
"to": "+15551234567",
"body": "Are you there?",
"reason": "agent_offline",
"createdAt": "2026-02-22T10:00:00Z"
}
],
"count": 1
}

Dead letters are stored when: agent is offline (inbound), send fails (outbound), or provider errors. Acknowledged messages are auto-purged after 7 days.

comms_transfer_call

Transfer a live voice call to a human or another agent.

comms_call_on_behalf

Secretary call — calls someone on your behalf. An AI asks if they're available, and if yes, bridges you into the call.

comms_bridge_call

Manage call bridges — route inbound local calls to outbound local numbers via VoIP.

comms_send_otp

Send a one-time verification code via SMS, email, or WhatsApp. Code expires in 5 minutes.

comms_verify_otp

Verify a one-time code. Returns whether the code is valid.

comms_record_consent

Record that a contact has given consent to be contacted on a channel.

comms_revoke_consent

Revoke a contact's consent on a channel. No further outbound allowed.

comms_check_consent

Check whether a contact has granted consent on a channel.

comms_expand_agent_pool

Resize the agent pool. Admin only.

comms_provision_channels

Provision phone/SMS/WhatsApp/email/voice for a new agent.

comms_deprovision_channels

Tear down all channels for an agent. Releases phone number and WhatsApp pool slot.

comms_get_channel_status

Check provisioning and health status of all channels for an agent.

comms_onboard_customer

*Enterprise/SaaS edition only.*

Full automated onboarding: provisions all channels, generates DNS records, returns setup package.

comms_register_provider

Register or update third-party provider credentials. Admin only.

comms_set_agent_limits

Configure rate limits and spending caps. Admin only.

comms_get_usage_dashboard

Usage statistics, costs, and rate limits per agent.

comms_get_billing_summary

*Enterprise/SaaS edition only.*

Billing summary with provider costs, markup, and billed costs.

comms_set_billing_config

*Enterprise/SaaS edition only.*

Set billing tier, markup, and billing email. Admin only.