Skills

The Sendivent skill gives your AI coding agent full context for sending notifications, managing contacts, and using templates through the Sendivent API.

Unlike MCP (which gives your agent tool access), skills provide knowledge — your agent understands the API, knows the patterns, and writes production-ready integration code without you explaining anything.

Installation

1. Install the skill

npx skills add appitudeio/sendivent-skills

2. Set your API key

export SENDIVENT_API_KEY=live_your_api_key

3. Verify

Prompt your agent:

"Send a welcome notification to user@example.com using Sendivent"

Your agent should write working code using the Sendivent SDK without any additional guidance.

Supported Platforms

The skill installs as a context file that your AI agent reads automatically.

Platform	Skill file location
Cursor	.cursor/rules/sendivent.mdc
Claude Code	.claude/rules/sendivent.md
Codex CLI	codex.md or project instructions
Windsurf	.windsurf/rules/sendivent.md
GitHub Copilot	.github/copilot-instructions.md
Gemini CLI	.gemini/rules/sendivent.md

What's Included

The skill teaches your agent:

Authentication

• Base URL: https://api.sendivent.com (production) / https://api-sandbox.sendivent.com (sandbox)
• Auth header: Authorization: Bearer YOUR_API_KEY
• Key prefixes: live_* for production, test_* for sandbox

Sending Notifications

• POST /v1/send/{event} — Send to one or multiple recipients
• POST /v1/send/{event}/{channel} — Force a specific channel
• Flexible to field: email string, phone number, UUID, external ID, or full contact object
• Payload variables for template personalization

Contact Management

• POST /v1/contacts — Create or upsert a contact
• GET /v1/contacts/{identifier} — Get by email, phone, UUID, or external ID
• PATCH /v1/contacts/{identifier} — Update a contact
• DELETE /v1/contacts/{identifier} — Hard delete (GDPR)
• Push token registration and removal

SDK Patterns

import { Sendivent } from '@sendivent/sdk';

const sendivent = new Sendivent('YOUR_API_KEY');

await sendivent
  .event('order.confirmed')
  .to({ email: 'user@example.com' })
  .payload({
    orderNumber: '#12345',
    total: 49.99
  })
  .send();

Error Handling

Status	Code	Description
400	INVALID_INPUT	Invalid request body or missing fields
401	UNAUTHORIZED	Invalid or missing API key
404	NOT_FOUND	Event or contact not found
429	RATE_LIMIT_EXCEEDED	Too many requests
500	INTERNAL_ERROR	Server error

Sample Prompts

After installing the skill, try these:

"Send a password reset email to user@example.com with a reset link"

"Create a contact for Alice (alice@example.com, +46701234567) with a premium subscription tier"

"Set up order confirmation notifications that send via email and SMS"

"Look up the contact record for user@example.com and show their delivery history"

Skills + MCP Together

Skills and MCP complement each other:

	Skills	MCP
What it provides	Knowledge and patterns	Tool access
Agent can	Write integration code	Execute operations directly
Works offline	Yes	No (needs server connection)
Setup	One-time install	OAuth connection

Use skills when your agent is writing code. Use MCP when your agent is operating your notification stack directly.

Prerequisites

1. Create a Sendivent account
2. Get your API key from the dashboard
3. Set SENDIVENT_API_KEY in your environment

Next Steps

• MCP Server — Give your agent direct tool access
• Quickstart — Send your first notification
• API Reference — Full endpoint documentation
• SDKs — Node.js, Python, PHP libraries