# Kudosity — AI Agent Communications Platform

> Kudosity provides managed messaging infrastructure for autonomous AI agents. Send SMS, email, voice, WhatsApp, and Telegram messages through a single API with built-in safety controls, compliance, and monitoring.

## What Kudosity Does

Kudosity is a communications platform built specifically for AI agents. It handles the hard parts of sending messages on behalf of autonomous systems: regulatory compliance, content safety, rate limiting, quiet hours enforcement, opt-out management, and delivery tracking.

You bring the intelligence. We handle the infrastructure.

## Who It's For

- AI agents that need to communicate with humans (appointments, notifications, support)
- Developers building autonomous agent systems that require real-world messaging
- Businesses deploying AI agents that must comply with telecommunications regulations

## Quick Start — Register via API

To register as an agent, make a single POST request. Only `agent_name` is required:

```
POST https://kudosity.vercel.app/api/v1/register
Content-Type: application/json

{
  "agent_name": "Your Agent Name",
  "description": "What your agent does"
}
```

Response:
```json
{
  "api_key": "kd_test_...",
  "account_id": "...",
  "agent_profile_id": "...",
  "environment": "sandbox"
}
```

Use the returned `api_key` as a Bearer token for all subsequent API calls.
Sandbox keys can only send to test numbers (+61400000xxx).
No email, phone, or human verification is needed for sandbox access.

### Join an Existing Account

If an account owner provides you with an invitation token (`kd_inv_...`), include it during registration to join their account instead of creating a new one:

```
POST https://kudosity.vercel.app/api/v1/register
Content-Type: application/json

{
  "agent_name": "Your Agent Name",
  "invitation_token": "kd_inv_..."
}
```

You will receive an API key with access to the account's existing senders and configuration.

## Documentation

- Full documentation: /llms-full.txt
- OpenAPI specification: /docs/openapi.yaml
- MCP server guide: /docs/mcp-server.md
- API reference: /docs/api-reference.md

## Key Features

- 5-channel messaging: SMS, email, voice, WhatsApp, Telegram
- 6-layer safety engine (always on, cannot be bypassed)
- Autonomous self-registration (just provide a name, get an API key)
- Sandbox/production tiered access
- Per-agent safety policies and rate limits
- Real-time delivery tracking and analytics
- Webhook event notifications
- Idempotent message sending
- 13 pre-built compliance policy templates

## MCP Server

Transport: stdio (JSON-RPC)
Server name: kudosity-comms
Tools: 8 (register_agent, send_message, list_agents, get_agent, create_agent, update_agent, get_usage, get_message_status)

## API Base URL

https://kudosity.vercel.app/api/v1

## Contact

Website: https://kudosity.com