@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/stripe.md

@@ -0,0 +1,148 @@
+# Stripe
+
+Payment processing, subscriptions, and billing for internet businesses.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Comprehensive REST API |
+| MCP | ✓ | Available via Stripe MCP server |
+| CLI | ✓ | `stripe` CLI for testing and webhooks |
+| SDK | ✓ | Official SDKs for most languages |
+
+## Authentication
+
+- **Type**: API Key
+- **Header**: `Authorization: Bearer sk_live_xxx` or `sk_test_xxx`
+- **Keys**: Secret key (server), Publishable key (client)
+
+## Common Agent Operations
+
+### List customers
+
+```bash
+GET https://api.stripe.com/v1/customers?limit=10
+```
+
+### Get customer by email
+
+```bash
+GET https://api.stripe.com/v1/customers?email=user@example.com
+```
+
+### Get subscription
+
+```bash
+GET https://api.stripe.com/v1/subscriptions/{subscription_id}
+```
+
+### List subscriptions for customer
+
+```bash
+GET https://api.stripe.com/v1/subscriptions?customer={customer_id}
+```
+
+### Create checkout session
+
+```bash
+POST https://api.stripe.com/v1/checkout/sessions
+
+customer={customer_id}
+&line_items[0][price]={price_id}
+&line_items[0][quantity]=1
+&mode=subscription
+&success_url=https://example.com/success
+&cancel_url=https://example.com/cancel
+```
+
+### Create customer portal session
+
+```bash
+POST https://api.stripe.com/v1/billing_portal/sessions
+
+customer={customer_id}
+&return_url=https://example.com/account
+```
+
+### List recent invoices
+
+```bash
+GET https://api.stripe.com/v1/invoices?customer={customer_id}&limit=10
+```
+
+### Get payment intent
+
+```bash
+GET https://api.stripe.com/v1/payment_intents/{payment_intent_id}
+```
+
+## Webhook Events
+
+Key events to handle:
+
+| Event | When | Action |
+|-------|------|--------|
+| `checkout.session.completed` | Successful checkout | Provision access |
+| `customer.subscription.created` | New subscription | Update user record |
+| `customer.subscription.updated` | Plan change | Update entitlements |
+| `customer.subscription.deleted` | Cancellation | Revoke access |
+| `invoice.payment_failed` | Payment failed | Notify user, retry |
+| `invoice.paid` | Invoice paid | Confirm payment |
+
+### Verify webhook signature
+
+```javascript
+const event = stripe.webhooks.constructEvent(
+  payload,
+  sig,
+  webhookSecret
+);
+```
+
+## CLI Commands
+
+```bash
+# Listen to webhooks locally
+stripe listen --forward-to localhost:3000/webhooks
+
+# Trigger test events
+stripe trigger checkout.session.completed
+
+# List recent events
+stripe events list --limit 10
+
+# Get resource
+stripe customers retrieve cus_xxx
+```
+
+## Key Objects
+
+- **Customer** - User billing profile
+- **Subscription** - Recurring billing
+- **Price** - Pricing configuration
+- **Product** - What you sell
+- **Invoice** - Billing document
+- **PaymentIntent** - One-time payment
+- **Checkout Session** - Hosted payment page
+
+## When to Use
+
+- Processing payments
+- Managing subscriptions
+- Creating checkout flows
+- Handling billing portal
+- Querying customer data
+- Revenue analytics
+
+## Rate Limits
+
+- 100 read requests per second
+- 100 write requests per second
+- Higher limits available on request
+
+## Relevant Skills
+
+- pricing-strategy
+- referral-program (Stripe-integrated affiliate tools)
+- analytics-tracking (revenue tracking)

package/payload/tools/integrations/tiktok-ads.md

@@ -0,0 +1,161 @@
+# TikTok Ads
+
+Advertising platform for TikTok's short-form video audience.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Marketing API for campaigns, audiences, reporting |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | ✓ | Python SDK available |
+
+## Authentication
+
+- **Type**: Access Token
+- **Header**: `Access-Token: {access_token}`
+- **Setup**: Create app in TikTok for Business, get access token
+
+## Common Agent Operations
+
+### Get advertiser info
+
+```bash
+GET https://business-api.tiktok.com/open_api/v1.3/advertiser/info/?advertiser_ids=["{advertiser_id}"]
+
+Access-Token: {access_token}
+```
+
+### Get campaigns
+
+```bash
+GET https://business-api.tiktok.com/open_api/v1.3/campaign/get/?advertiser_id={advertiser_id}&page=1&page_size=20
+
+Access-Token: {access_token}
+```
+
+### Get campaign report
+
+```bash
+POST https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/
+
+Access-Token: {access_token}
+
+{
+  "advertiser_id": "{advertiser_id}",
+  "report_type": "BASIC",
+  "dimensions": ["campaign_id"],
+  "metrics": ["spend", "impressions", "clicks", "conversion"],
+  "data_level": "AUCTION_CAMPAIGN",
+  "start_date": "2024-01-01",
+  "end_date": "2024-01-31"
+}
+```
+
+### Create campaign
+
+```bash
+POST https://business-api.tiktok.com/open_api/v1.3/campaign/create/
+
+Access-Token: {access_token}
+
+{
+  "advertiser_id": "{advertiser_id}",
+  "campaign_name": "Campaign Name",
+  "objective_type": "CONVERSIONS",
+  "budget_mode": "BUDGET_MODE_DAY",
+  "budget": 100
+}
+```
+
+### Update campaign status
+
+```bash
+POST https://business-api.tiktok.com/open_api/v1.3/campaign/status/update/
+
+Access-Token: {access_token}
+
+{
+  "advertiser_id": "{advertiser_id}",
+  "campaign_ids": ["{campaign_id}"],
+  "opt_status": "ENABLE"
+}
+```
+
+### Get ad groups
+
+```bash
+GET https://business-api.tiktok.com/open_api/v1.3/adgroup/get/?advertiser_id={advertiser_id}&campaign_ids=["{campaign_id}"]
+
+Access-Token: {access_token}
+```
+
+### Get audiences
+
+```bash
+GET https://business-api.tiktok.com/open_api/v1.3/dmp/custom_audience/list/?advertiser_id={advertiser_id}
+
+Access-Token: {access_token}
+```
+
+## Key Metrics
+
+| Metric | Description |
+|--------|-------------|
+| `spend` | Amount spent |
+| `impressions` | Ad impressions |
+| `clicks` | Clicks |
+| `ctr` | Click-through rate |
+| `cpc` | Cost per click |
+| `cpm` | Cost per 1000 impressions |
+| `conversion` | Conversions |
+| `cost_per_conversion` | CPA |
+| `video_play_actions` | Video views |
+| `video_watched_6s` | 6s views |
+
+## Campaign Objectives
+
+- `REACH` - Brand awareness
+- `TRAFFIC` - Website traffic
+- `VIDEO_VIEWS` - Video views
+- `LEAD_GENERATION` - Lead forms
+- `CONVERSIONS` - Website conversions
+- `APP_PROMOTION` - App installs
+
+## Targeting Options
+
+### Demographics
+- Age ranges
+- Gender
+- Languages
+- Locations
+
+### Interests & Behavior
+- Interest categories
+- Video interactions
+- Creator interactions
+- Hashtag interactions
+
+### Custom Audiences
+- Customer file uploads
+- Website visitors (pixel)
+- App activity
+- Engagement audiences
+
+## When to Use
+
+- Reaching younger demographics (18-34)
+- Video-first advertising
+- Viral/creative campaigns
+- App promotion
+
+## Rate Limits
+
+- 10 requests/second
+- 100,000 requests/day
+
+## Relevant Skills
+
+- paid-ads
+- analytics-tracking

package/payload/tools/integrations/tolt.md

@@ -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

package/payload/tools/integrations/trustpilot.md

@@ -0,0 +1,191 @@
+# Trustpilot
+
+Business review management platform for collecting, managing, and showcasing customer reviews.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Business Units, Reviews, Invitations, Tags |
+| MCP | - | Not available |
+| CLI | ✓ | [trustpilot.js](../clis/trustpilot.js) |
+| SDK | ✓ | Node.js (official), community wrappers |
+
+## Authentication
+
+- **Type**: API Key (public endpoints) + OAuth 2.0 (private endpoints)
+- **Public Header**: `apikey: {YOUR_API_KEY}`
+- **Private Header**: `Authorization: Bearer {access_token}`
+- **OAuth Grant**: Client Credentials (`Basic base64(API_KEY:API_SECRET)`)
+- **Token Lifetime**: Access tokens expire after 100 hours, refresh tokens after 30 days
+- **Get credentials**: https://businessapp.b2b.trustpilot.com/ > Integrations > API
+
+## Common Agent Operations
+
+### Search for a business unit
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/search?query=example.com&limit=10
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### Get business unit details
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/{businessUnitId}
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### Get business profile info
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/{businessUnitId}/profileinfo
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### List public reviews
+
+```bash
+GET https://api.trustpilot.com/v1/business-units/{businessUnitId}/reviews?perPage=20&orderBy=createdat.desc
+
+Headers:
+  apikey: {API_KEY}
+```
+
+### List private reviews (with customer data)
+
+```bash
+GET https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/reviews?perPage=20
+
+Headers:
+  Authorization: Bearer {access_token}
+```
+
+### Reply to a review
+
+```bash
+POST https://api.trustpilot.com/v1/private/reviews/{reviewId}/reply
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "message": "Thank you for your feedback!"
+}
+```
+
+### Send email invitation
+
+```bash
+POST https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/email-invitations
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "consumerEmail": "customer@example.com",
+  "consumerName": "Jane Doe",
+  "referenceNumber": "order-123",
+  "redirectUri": "https://example.com/thanks"
+}
+```
+
+### Generate review invitation link
+
+```bash
+POST https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/invitation-links
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "email": "customer@example.com",
+  "name": "Jane Doe",
+  "referenceId": "order-123",
+  "redirectUri": "https://example.com/thanks"
+}
+```
+
+### List invitation templates
+
+```bash
+GET https://api.trustpilot.com/v1/private/business-units/{businessUnitId}/templates
+
+Headers:
+  Authorization: Bearer {access_token}
+```
+
+### Add tags to a review
+
+```bash
+PUT https://api.trustpilot.com/v1/private/reviews/{reviewId}/tags
+
+Headers:
+  Authorization: Bearer {access_token}
+
+{
+  "tags": [{ "group": "sentiment", "value": "positive" }]
+}
+```
+
+## Key Metrics
+
+### Business Unit Metrics
+- `numberOfReviews` - Total review count
+- `trustScore` - Overall trust score (1-5)
+- `stars` - Star rating displayed
+- `status` - Claim status (claimed, unclaimed)
+
+### Review Metrics
+- `stars` - Individual review star rating (1-5)
+- `language` - Review language code
+- `createdAt` - Review creation timestamp
+- `isVerified` - Whether the review is verified
+- `status` - Review status (active, reported, flagged)
+
+## Parameters
+
+### Review Filters
+- `stars` - Filter by star rating (1-5)
+- `language` - Filter by language code (e.g., `en`)
+- `orderBy` - Sort order (`createdat.desc`, `createdat.asc`, `stars.desc`, `stars.asc`)
+- `perPage` - Results per page (max 100)
+
+### Invitation Parameters
+- `consumerEmail` - Recipient email (required)
+- `consumerName` - Recipient name (required)
+- `referenceNumber` - Order or transaction reference
+- `templateId` - Email template ID
+- `redirectUri` - URL to redirect after review submission
+- `senderEmail` - Custom sender email
+- `replyTo` - Custom reply-to address
+
+## When to Use
+
+- Collecting and managing customer reviews at scale
+- Automating post-purchase review invitation flows
+- Monitoring brand reputation and review sentiment
+- Responding to customer feedback programmatically
+- Showcasing TrustScore and reviews on marketing pages
+- Tagging and categorizing reviews for analysis
+
+## Rate Limits
+
+- Recommended: no more than 833 calls per 5 minutes (10K/hour)
+- Throttled at more than 1 request per second
+- Rate limit headers returned in responses
+- Use webhooks instead of polling where possible
+
+## Relevant Skills
+
+- reputation-management
+- customer-feedback
+- review-generation
+- social-proof
+- post-purchase-flow