feat: add marketing tools registry for agent discovery

Create centralized tools/ directory with REGISTRY.md index and 29
integration guides covering analytics, SEO, CRM, payments, referral,
email, ads, automation, and commerce platforms.

Each guide includes API endpoints, authentication, common operations,
and links to relevant skills. Updated AGENTS.md and key skills
(referral-program, analytics-tracking, email-sequence, paid-ads)
with tool integration references.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Corey Haines
2026-01-26 18:33:51 -08:00
parent 1477781b17
commit edcc34aa6d
35 changed files with 4803 additions and 0 deletions

144
tools/integrations/tolt.md Normal file
View File

@@ -0,0 +1,144 @@
# Tolt
Affiliate program management for SaaS, with Stripe and Paddle integration.
## Capabilities
| Integration | Available | Notes |
|-------------|-----------|-------|
| API | ✓ | REST API for affiliates, referrals, payouts |
| MCP | - | Not available |
| CLI | - | Not available |
| SDK | - | JavaScript snippet for tracking |
## Authentication
- **Type**: API Key
- **Header**: `Authorization: Bearer {api_key}`
- **Get key**: Settings > API in Tolt dashboard
## Common Agent Operations
### List affiliates
```bash
GET https://api.tolt.io/v1/affiliates
```
### Get affiliate
```bash
GET https://api.tolt.io/v1/affiliates/{affiliate_id}
```
### Create affiliate
```bash
POST https://api.tolt.io/v1/affiliates
{
"email": "affiliate@example.com",
"name": "John Doe"
}
```
### List referrals
```bash
GET https://api.tolt.io/v1/referrals?affiliate_id={affiliate_id}
```
### Get referral by customer
```bash
GET https://api.tolt.io/v1/referrals?customer_id={stripe_customer_id}
```
### List commissions
```bash
GET https://api.tolt.io/v1/commissions?affiliate_id={affiliate_id}
```
### Get payout history
```bash
GET https://api.tolt.io/v1/payouts?affiliate_id={affiliate_id}
```
### Update affiliate
```bash
PATCH https://api.tolt.io/v1/affiliates/{affiliate_id}
{
"commission_rate": 30,
"payout_method": "paypal",
"paypal_email": "affiliate@paypal.com"
}
```
## JavaScript Tracking
### Install snippet
```html
<script src="https://cdn.tolt.io/tolt.js" data-tolt="YOUR_PUBLIC_KEY"></script>
```
### Track signup
```javascript
window.tolt.signup(stripeCustomerId);
```
### Identify existing customer
```javascript
window.tolt.identify(stripeCustomerId);
```
## Webhook Events
| Event | When |
|-------|------|
| `affiliate.created` | New affiliate registered |
| `affiliate.approved` | Affiliate approved |
| `referral.created` | New referral tracked |
| `referral.converted` | Referral converted to customer |
| `commission.created` | Commission earned |
| `payout.completed` | Payout sent |
## Key Features
- **Stripe native** - Automatic commission tracking
- **Paddle support** - Works with Paddle billing
- **Affiliate dashboard** - White-labeled portal
- **Payout automation** - PayPal and Wise payouts
- **Custom commission tiers** - Different rates per affiliate
## Key Objects
- **Affiliate** - Partner in your program
- **Referral** - Tracked conversion
- **Commission** - Earned affiliate payment
- **Payout** - Processed payment to affiliate
- **Program** - Campaign configuration
## When to Use
- Setting up SaaS affiliate programs
- Managing affiliate relationships
- Tracking Stripe or Paddle-based referrals
- Processing affiliate payouts
- Building affiliate dashboards
## Rate Limits
- 100 requests per minute
- Higher limits on enterprise plans
## Relevant Skills
- referral-program
- pricing-strategy