# Ruellia Communications Platform
> Modern, multi-channel communications (Email, SMS, Webhooks/Notifications) with Model Context Protocol (MCP) support and real-time usage-based billing.

## Core Services & Endpoints
- Marketing Site: https://ruellia.cntnus.app
- Developer Console: https://app.ruellia.cntnus.app
- API Base URL: https://api.ruellia.cntnus.app
- MCP Endpoint: https://api.ruellia.cntnus.app/v1/mcp
- OpenAPI Spec: https://api.ruellia.cntnus.app/openapi.json

## Quick Start for AI Agents
To enable an AI agent to send messages, manage sender domains, or check usage:
1. Generate an Agent Token in the console or pass an existing token via \`Authorization: Bearer <agent_token>\`.
2. Connect your agent to the MCP endpoint:
   - Server URL: \`https://api.ruellia.cntnus.app/v1/mcp\`
   - Method: \`POST\` (JSON-RPC 2.0)
   - Header: \`Authorization: Bearer <agent_token>\`

## Tools Exposed via MCP
- \`send_email(to, subject, body, from?, replyTo?)\`: Dispatches transactional and conversational emails.
- \`send_sms(to, body, from?)\`: Sends SMS text messages.
- \`send_notification(targetUrl, event, data)\`: Fires webhook push events.
- \`get_usage(period?)\`: Queries real-time usage breakdown (requests, durationMs, storageBytes, messages, cost).
- \`get_message_status(messageId)\`: Checks delivery state.
- \`list_domains()\`: Lists verified and pending sender domains.
- \`register_domain(domainName)\`: Initiates custom domain registration and returns DKIM/SPF DNS records.

## Usage-Based Pricing (Pay-As-You-Go)
- Base Minimum Cost: $0.00 / month
- API Requests: $0.0002 / 1,000 requests
- Compute: $0.002 / 100,000 ms
- Storage: $0.025 / GB-month
- Email: $0.0001 / email
- SMS: $0.0075 / segment