@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/amplitude.md

@@ -0,0 +1,135 @@
+# Amplitude
+
+Product analytics platform for user behavior, retention, and experimentation.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | HTTP API for events, User Profile API, Export API |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | ✓ | JavaScript, iOS, Android, Python, etc. |
+
+## Authentication
+
+- **HTTP API**: API Key (public for events)
+- **Export/Dashboard API**: API Key + Secret Key
+
+## Common Agent Operations
+
+### Track event
+
+```bash
+POST https://api2.amplitude.com/2/httpapi
+
+{
+  "api_key": "{api_key}",
+  "events": [{
+    "user_id": "user_123",
+    "event_type": "signup_completed",
+    "event_properties": {
+      "plan": "pro"
+    },
+    "user_properties": {
+      "email": "user@example.com"
+    }
+  }]
+}
+```
+
+### Batch events
+
+```bash
+POST https://api2.amplitude.com/batch
+
+{
+  "api_key": "{api_key}",
+  "events": [
+    {"user_id": "user_1", "event_type": "pageview"},
+    {"user_id": "user_2", "event_type": "signup"}
+  ]
+}
+```
+
+### Get user activity
+
+```bash
+GET https://amplitude.com/api/2/useractivity?user={user_id}
+
+Authorization: Basic {base64(api_key:secret_key)}
+```
+
+### Export events
+
+```bash
+GET https://amplitude.com/api/2/export?start=20240101T00&end=20240131T23
+
+Authorization: Basic {base64(api_key:secret_key)}
+```
+
+### Get retention data
+
+```bash
+GET https://amplitude.com/api/2/retention?e={"event_type":"signup_completed"}&start=20240101&end=20240131
+
+Authorization: Basic {base64(api_key:secret_key)}
+```
+
+### Query with SQL (Snowflake)
+
+For Amplitude customers with SQL access:
+```sql
+SELECT event_type, COUNT(*) as count
+FROM events
+WHERE event_time > '2024-01-01'
+GROUP BY event_type
+```
+
+## JavaScript SDK
+
+```javascript
+// Initialize
+amplitude.init('API_KEY');
+
+// Identify user
+amplitude.setUserId('user_123');
+
+// Set user properties
+const identify = new amplitude.Identify();
+identify.set('plan', 'pro');
+amplitude.identify(identify);
+
+// Track event
+amplitude.track('Feature Used', {
+  feature_name: 'export'
+});
+```
+
+## Key Concepts
+
+- **Events** - User actions with properties
+- **User Properties** - Persistent user attributes
+- **Cohorts** - Behavioral segments
+- **Funnels** - Multi-step conversion analysis
+- **Retention** - User return patterns
+- **Journeys** - User path analysis
+
+## When to Use
+
+- Tracking product analytics
+- Analyzing user funnels
+- Cohort analysis and retention
+- Experimentation and A/B testing
+- User journey mapping
+
+## Rate Limits
+
+- HTTP API: 1000 events/second
+- Export API: 360 requests/hour
+
+## Relevant Skills
+
+- analytics-tracking
+- ab-test-setup
+- onboarding-cro

package/payload/tools/integrations/apollo.md

@@ -0,0 +1,148 @@
+# Apollo.io
+
+B2B prospecting and data enrichment platform with 210M+ contacts and 35M+ companies for sales intelligence.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | People Search, Company Search, Enrichment, Sequences |
+| MCP | - | Not available |
+| CLI | ✓ | [apollo.js](../clis/apollo.js) |
+| SDK | - | REST API only |
+
+## Authentication
+
+- **Type**: API Key
+- **Header**: `x-api-key: {api_key}` or `Authorization: Bearer {token}`
+- **Get key**: Settings > Integrations > API at https://app.apollo.io
+
+## Common Agent Operations
+
+### People Search
+
+```bash
+POST https://api.apollo.io/api/v1/mixed_people/api_search
+
+{
+  "person_titles": ["Sales Manager"],
+  "person_locations": ["United States"],
+  "organization_num_employees_ranges": ["1,100"],
+  "page": 1
+}
+```
+
+### Person Enrichment
+
+```bash
+POST https://api.apollo.io/api/v1/people/match
+
+{
+  "first_name": "Tim",
+  "last_name": "Zheng",
+  "domain": "apollo.io"
+}
+```
+
+### Bulk People Enrichment
+
+```bash
+POST https://api.apollo.io/api/v1/people/bulk_match
+
+{
+  "details": [
+    { "email": "tim@apollo.io" },
+    { "first_name": "Jane", "last_name": "Doe", "domain": "example.com" }
+  ]
+}
+```
+
+### Organization Search
+
+```bash
+POST https://api.apollo.io/api/v1/mixed_companies/search
+
+{
+  "organization_locations": ["United States"],
+  "organization_num_employees_ranges": ["1,100"],
+  "page": 1
+}
+```
+
+### Organization Enrichment
+
+```bash
+POST https://api.apollo.io/api/v1/organizations/enrich
+
+{
+  "domain": "apollo.io"
+}
+```
+
+## Key Metrics
+
+### Person Data
+- `first_name`, `last_name` - Name
+- `title` - Job title
+- `email` - Verified email
+- `linkedin_url` - LinkedIn profile
+- `organization` - Company details
+- `seniority` - Seniority level
+- `departments` - Department list
+
+### Organization Data
+- `name` - Company name
+- `website_url` - Website
+- `estimated_num_employees` - Employee count
+- `industry` - Industry
+- `annual_revenue` - Revenue
+- `technologies` - Tech stack
+- `funding_total` - Total funding
+
+## Parameters
+
+### People Search
+- `person_titles` - Array of job titles
+- `person_locations` - Array of locations
+- `person_seniorities` - Array: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry
+- `organization_num_employees_ranges` - Array of ranges (e.g., "1,100")
+- `organization_ids` - Filter by Apollo org IDs
+- `page` - Page number (default: 1)
+- `per_page` - Results per page (default: 25, max: 100)
+
+### Person Enrichment
+- `email` - Email address
+- `first_name` + `last_name` + `domain` - Alternative lookup
+- `linkedin_url` - LinkedIn URL
+- `reveal_personal_emails` - Include personal emails
+- `reveal_phone_number` - Include phone numbers
+
+### Organization Search
+- `organization_locations` - Array of locations
+- `organization_num_employees_ranges` - Employee count ranges
+- `organization_ids` - Specific org IDs
+- `page` - Page number
+
+## When to Use
+
+- Building targeted prospect lists by role, seniority, and company size
+- Enriching leads with verified contact info
+- Finding decision-makers at target accounts
+- Company research and firmographic analysis
+- ABM campaign targeting
+- Sales intelligence and outbound prospecting
+
+## Rate Limits
+
+- Rate limits vary by plan
+- Standard: 100 requests/minute for most endpoints
+- Bulk enrichment: up to 10 people per request
+- Search: max 50,000 records (100 per page, 500 pages)
+
+## Relevant Skills
+
+- abm-strategy
+- lead-enrichment
+- lead-scoring
+- cold-email
+- competitor-alternatives

package/payload/tools/integrations/beehiiv.md

@@ -0,0 +1,157 @@
+# Beehiiv
+
+Newsletter platform with subscriber management, post publishing, automations, and referral programs.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v2 for publications, subscriptions, posts, segments |
+| MCP | - | Not available |
+| CLI | ✓ | [beehiiv.js](../clis/beehiiv.js) |
+| SDK | - | No official SDK; OpenAPI spec available for codegen |
+
+## Authentication
+
+- **Type**: Bearer Token
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: Settings > API under Workspace Settings at https://app.beehiiv.com
+- **Note**: API key is only shown once on creation; copy and store it immediately
+
+## Common Agent Operations
+
+### List publications
+
+```bash
+GET https://api.beehiiv.com/v2/publications
+```
+
+### Get publication details
+
+```bash
+GET https://api.beehiiv.com/v2/publications/{publicationId}
+```
+
+### List subscriptions
+
+```bash
+GET https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions?limit=10&status=active
+
+# Filter by email
+GET https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions?email=user@example.com
+```
+
+### Create subscription
+
+```bash
+POST https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions
+
+{
+  "email": "user@example.com",
+  "reactivate_existing": false,
+  "send_welcome_email": true,
+  "utm_source": "api",
+  "tier": "free"
+}
+```
+
+### Update subscription
+
+```bash
+PUT https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions/{subscriptionId}
+
+{
+  "tier": "premium"
+}
+```
+
+### Delete subscription
+
+```bash
+DELETE https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions/{subscriptionId}
+```
+
+### List posts
+
+```bash
+GET https://api.beehiiv.com/v2/publications/{publicationId}/posts?limit=10&status=confirmed
+```
+
+### Create post (Enterprise only)
+
+```bash
+POST https://api.beehiiv.com/v2/publications/{publicationId}/posts
+
+{
+  "title": "Weekly Update",
+  "subtitle": "What happened this week",
+  "content": "<p>Hello subscribers...</p>",
+  "status": "draft"
+}
+```
+
+### List segments
+
+```bash
+GET https://api.beehiiv.com/v2/publications/{publicationId}/segments
+```
+
+### List automations
+
+```bash
+GET https://api.beehiiv.com/v2/publications/{publicationId}/automations
+```
+
+### Get referral program
+
+```bash
+GET https://api.beehiiv.com/v2/publications/{publicationId}/referral_program
+```
+
+## API Pattern
+
+All endpoints are scoped to a publication. The publication ID is a required path parameter for most operations. Responses use cursor-based pagination with a `cursor` parameter for fetching subsequent pages.
+
+## Key Metrics
+
+### Subscription Fields
+- `status` - validating, invalid, pending, active, inactive
+- `tier` - free or premium
+- `created` - Subscription creation timestamp
+- `utm_source`, `utm_medium`, `utm_campaign` - Acquisition tracking
+- `referral_code` - Unique referral code for subscriber
+
+### Post Fields
+- `status` - draft, confirmed (scheduled), archived
+- `publish_date` - When the post was/will be published
+- `stats` - Open rate, click rate, subscriber count (with expand)
+
+## Parameters
+
+### Common Query Parameters
+- `limit` - Results per page (1-100, default 10)
+- `cursor` - Cursor for next page of results
+- `expand[]` - Include additional data: stats, custom_fields, referrals
+- `status` - Filter by subscription/post status
+- `tier` - Filter by subscription tier (free, premium)
+
+## When to Use
+
+- Managing newsletter subscribers programmatically
+- Syncing subscribers from external signup forms or landing pages
+- Building referral program integrations
+- Automating post creation and publishing workflows
+- Tracking subscriber growth and engagement metrics
+
+## Rate Limits
+
+- API rate limits apply per API key
+- Use cursor-based pagination for efficient data retrieval
+- Batch operations not available; iterate with individual requests
+
+## Relevant Skills
+
+- email-sequence
+- newsletter-growth
+- referral-program
+- content-strategy

package/payload/tools/integrations/brevo.md

@@ -0,0 +1,268 @@
+# Brevo
+
+All-in-one marketing platform (formerly Sendinblue) for email, SMS, and WhatsApp with contacts, campaigns, and transactional messaging.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v3 for contacts, campaigns, transactional email/SMS |
+| MCP | - | Not available |
+| CLI | ✓ | [brevo.js](../clis/brevo.js) |
+| SDK | ✓ | Node.js, Python, PHP, Ruby, Java, C#, Go |
+
+## Authentication
+
+- **Type**: API Key
+- **Header**: `api-key: {api_key}`
+- **Get key**: SMTP & API settings at https://app.brevo.com/settings/keys/api
+- **Note**: API key is only shown once on creation; store securely. Formerly used `api.sendinblue.com` base URL.
+
+## Common Agent Operations
+
+### Get account info
+
+```bash
+GET https://api.brevo.com/v3/account
+```
+
+### List contacts
+
+```bash
+GET https://api.brevo.com/v3/contacts?limit=50&offset=0
+```
+
+### Get contact by email
+
+```bash
+GET https://api.brevo.com/v3/contacts/user@example.com
+```
+
+### Create contact
+
+```bash
+POST https://api.brevo.com/v3/contacts
+
+{
+  "email": "user@example.com",
+  "attributes": {
+    "FIRSTNAME": "Jane",
+    "LASTNAME": "Doe"
+  },
+  "listIds": [1, 2]
+}
+```
+
+### Update contact
+
+```bash
+PUT https://api.brevo.com/v3/contacts/user@example.com
+
+{
+  "attributes": {
+    "FIRSTNAME": "Updated"
+  },
+  "listIds": [3]
+}
+```
+
+### Delete contact
+
+```bash
+DELETE https://api.brevo.com/v3/contacts/user@example.com
+```
+
+### Import contacts
+
+```bash
+POST https://api.brevo.com/v3/contacts/import
+
+{
+  "jsonBody": [
+    { "email": "user1@example.com" },
+    { "email": "user2@example.com" }
+  ],
+  "listIds": [1]
+}
+```
+
+### List contact lists
+
+```bash
+GET https://api.brevo.com/v3/contacts/lists?limit=50&offset=0
+```
+
+### Create list
+
+```bash
+POST https://api.brevo.com/v3/contacts/lists
+
+{
+  "name": "Newsletter Subscribers",
+  "folderId": 1
+}
+```
+
+### Add contacts to list
+
+```bash
+POST https://api.brevo.com/v3/contacts/lists/{listId}/contacts/add
+
+{
+  "emails": ["user1@example.com", "user2@example.com"]
+}
+```
+
+### Remove contacts from list
+
+```bash
+POST https://api.brevo.com/v3/contacts/lists/{listId}/contacts/remove
+
+{
+  "emails": ["user1@example.com"]
+}
+```
+
+### Send transactional email
+
+```bash
+POST https://api.brevo.com/v3/smtp/email
+
+{
+  "sender": {
+    "name": "My App",
+    "email": "noreply@example.com"
+  },
+  "to": [
+    { "email": "user@example.com", "name": "Jane Doe" }
+  ],
+  "subject": "Order Confirmation",
+  "htmlContent": "<html><body><p>Your order is confirmed.</p></body></html>"
+}
+```
+
+### List email campaigns
+
+```bash
+GET https://api.brevo.com/v3/emailCampaigns?limit=50&offset=0&type=classic&status=sent
+```
+
+### Create email campaign
+
+```bash
+POST https://api.brevo.com/v3/emailCampaigns
+
+{
+  "name": "January Newsletter",
+  "subject": "Monthly Update",
+  "sender": { "name": "My Brand", "email": "news@example.com" },
+  "htmlContent": "<html><body><p>Newsletter content</p></body></html>",
+  "recipients": { "listIds": [1, 2] }
+}
+```
+
+### Send campaign immediately
+
+```bash
+POST https://api.brevo.com/v3/emailCampaigns/{campaignId}/sendNow
+```
+
+### Send test email for campaign
+
+```bash
+POST https://api.brevo.com/v3/emailCampaigns/{campaignId}/sendTest
+
+{
+  "emailTo": ["test@example.com"]
+}
+```
+
+### Send transactional SMS
+
+```bash
+POST https://api.brevo.com/v3/transactionalSMS/sms
+
+{
+  "sender": "MyApp",
+  "recipient": "+15551234567",
+  "content": "Your verification code is 123456",
+  "type": "transactional"
+}
+```
+
+### List SMS campaigns
+
+```bash
+GET https://api.brevo.com/v3/smsCampaigns?limit=50&offset=0
+```
+
+### List senders
+
+```bash
+GET https://api.brevo.com/v3/senders
+```
+
+## API Pattern
+
+Brevo uses standard REST with offset-based pagination (`limit` and `offset` parameters). Contact attributes use uppercase field names (FIRSTNAME, LASTNAME). Lists are nested under the contacts resource path. Transactional email uses the `/smtp/email` endpoint despite being REST-based.
+
+## Key Metrics
+
+### Contact Fields
+- `email` - Email address
+- `attributes` - Custom attributes (FIRSTNAME, LASTNAME, SMS, etc.)
+- `listIds` - Associated list IDs
+- `emailBlacklisted` - Email opt-out status
+- `smsBlacklisted` - SMS opt-out status
+- `statistics` - Engagement stats (with expand)
+
+### Campaign Metrics
+- `sent` - Total sends
+- `delivered` - Successful deliveries
+- `openRate` - Open percentage
+- `clickRate` - Click percentage
+- `unsubscribed` - Unsubscribe count
+- `hardBounces`, `softBounces` - Bounce counts
+
+### Transactional Email Response
+- `messageId` - Unique message identifier for tracking
+
+## Parameters
+
+### Contact Parameters
+- `email` - Contact email address
+- `attributes` - Key-value object of custom attributes
+- `listIds` - Array of list IDs to subscribe to
+- `unlinkListIds` - Array of list IDs to unsubscribe from
+
+### Campaign Parameters
+- `name` - Campaign name
+- `subject` - Email subject line
+- `sender` - Object with `name` and `email`
+- `htmlContent` / `textContent` - Email body
+- `recipients` - Object with `listIds` array
+- `type` - classic or trigger
+
+## When to Use
+
+- Multi-channel marketing (email + SMS + WhatsApp)
+- Transactional email sending with tracking
+- Managing contacts and segmented lists
+- Creating and scheduling email campaigns
+- SMS notifications and marketing
+- Affordable all-in-one marketing automation
+
+## Rate Limits
+
+- API rate limits depend on plan (free tier: limited sends/day)
+- Transactional email: varies by plan
+- Contact imports: batch processing with async status
+- Rate limit headers returned with responses
+
+## Relevant Skills
+
+- email-sequence
+- sms-marketing
+- transactional-email
+- lifecycle-marketing
+- contact-management