# Sendinel

> Email + social operations control plane with full AI agent support via MCP and REST API.

Sendinel is a cross-channel orchestration platform for campaigns, sequences, contacts, templates, segments, and analytics — across both email and social media. It is purpose-built for AI agent control: a 65-tool MCP server covers the full email ops lifecycle, and a REST API covers all CRUD operations. Social publishing routes through the SocialPublisher abstraction (Upload Post by default) supporting 12 platforms.

## Getting Started

- [Developer Hub](/developer): Quickstart, REST API reference, MCP setup, webhooks, and SDK notes
- [REST API Quickstart](/developer#quick-start): Create a contact and send a campaign in 5 minutes
- [MCP Server Setup](/developer#mcp): Connect Claude, Cursor, or any MCP-compatible client
- [Connections](/developer#connections): Email providers, social platforms, and import sources

## API Reference

- [OpenAPI Specification](/api/v1/openapi.json): Machine-readable OpenAPI 3.1 spec for the full REST surface
- [Full LLM Reference](/llms-full.txt): Complete API and tool reference optimized for LLM consumption

## REST API - Core Resources

- [POST /api/v1/send](/api/v1/send): Send a transactional email immediately
- [POST /api/v1/identify](/api/v1/identify): Identify or upsert a contact by email
- [GET/POST /api/v1/contacts](/api/v1/contacts): Subscriber list management
- [GET/POST /api/v1/campaigns](/api/v1/campaigns): Campaign CRUD and lifecycle
- [GET/POST /api/v1/templates](/api/v1/templates): Reusable email templates
- [GET/POST /api/v1/segments](/api/v1/segments): Audience segmentation with rule-based filters
- [GET/POST /api/v1/sites](/api/v1/sites): Sending domain and site configuration
- [POST /api/v1/trigger](/api/v1/trigger): Trigger a campaign enrollment by event name
- [POST /api/v1/events](/api/v1/events): Record a contact event (page view, purchase, etc.)

## MCP Server - Tool Groups

Sendinel's MCP server exposes 65 tools across 10 groups:

- analytics: get_stats, get_domain_health, get_engagement_insights, deliverability_check, performance_report, get_social_analytics
- campaigns: list_campaigns, create_campaign, add_campaign_step, list_campaign_steps, update_campaign_step, delete_campaign_step, update_campaign_status, enroll_contact, enroll_segment, get_enrollment_status, clone_campaign, generate_email, launch_campaign
- contacts: list_subscribers, add_subscriber, import_subscribers, update_subscriber, get_subscriber, unsubscribe_subscriber, set_subscriber_tags, list_email_log, list_suppressions, add_suppression, remove_suppression, send_test_email
- segments: create_segment, list_segments, update_segment, delete_segment, preview_segment, create_segment_nl
- templates: list_templates, get_template, create_template, update_template, delete_template
- drafts: create_draft, list_drafts, approve_draft, reject_draft
- sites: create_site, update_site, get_sites, list_domains, register_domain
- data: get_cron_runs, get_queue_status, get_send_dlq, export_data, get_scoring_rules, update_scoring_rules, explain_contact_score, get_portfolio_stats
- gdpr: delete_subscriber_data, list_deletion_log
- automations: list_automations, preview_automation, trigger_automation

## Authentication

All REST API calls require:
  Authorization: Bearer snk_<your-api-key>

Scopes: read, write, admin (broad) or contacts:read, contacts:write, campaigns:read, campaigns:write, templates:read, templates:write, segments:read, segments:write, sites:read, sites:write (granular).

API keys are created at: https://sendinel.ai (Settings -> Developer -> API Keys)

## Connected Services

### Email Delivery (outbound — Sendinel sends through your provider)
- Resend (default) — configure at Settings → Project → Email Provider
- SendGrid, Postmark, Amazon SES, Mailgun — same settings page

### Social Publishing (outbound — 12 platforms via SocialPublisher abstraction)
Powered by Upload Post. Connect accounts at Settings → Channels → Social.
- Instagram, Facebook, LinkedIn, Twitter/X, TikTok, YouTube
- Pinterest, Reddit, Threads, Bluesky, Google Business
OAuth connect URL: GET /api/integrations/social/{platform}/connect

### Import Sources (inbound — migrate contacts, templates, and campaigns into Sendinel)
- Customer.io, Mailchimp, Klaviyo, ActiveCampaign, Kit, Resend
Trigger: Settings → Import Contacts → Choose Provider

### Webhooks (outbound — Sendinel notifies your app)
Events: campaign.completed, email.bounced, email.complained, contact.unsubscribed, bounce_rate.warning, domain.dns_lost
Configure at: Settings → Developer → Webhooks