@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/optimizely.md

@@ -0,0 +1,171 @@
+# Optimizely
+
+A/B testing and experimentation platform with a REST API for managing projects, experiments, campaigns, and results.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Projects, Experiments, Campaigns, Audiences, Results |
+| MCP | - | Not available |
+| CLI | ✓ | [optimizely.js](../clis/optimizely.js) |
+| SDK | ✓ | JavaScript, Python, Ruby, Java, Go, C#, PHP, React, Swift, Android |
+
+## Authentication
+
+- **Type**: Bearer Token (Personal Access Token or OAuth 2.0)
+- **Header**: `Authorization: Bearer {personal_token}`
+- **Get token**: https://app.optimizely.com/v2/profile/api > Generate New Token
+
+## Common Agent Operations
+
+### List Projects
+
+```bash
+GET https://api.optimizely.com/v2/projects
+```
+
+### Get Project
+
+```bash
+GET https://api.optimizely.com/v2/projects/{project_id}
+```
+
+### List Experiments
+
+```bash
+GET https://api.optimizely.com/v2/experiments?project_id={project_id}
+```
+
+### Get Experiment
+
+```bash
+GET https://api.optimizely.com/v2/experiments/{experiment_id}
+```
+
+### Get Experiment Results
+
+```bash
+GET https://api.optimizely.com/v2/experiments/{experiment_id}/results
+```
+
+### Create Experiment
+
+```bash
+POST https://api.optimizely.com/v2/experiments
+
+{
+  "project_id": 12345,
+  "name": "Homepage CTA Test",
+  "type": "a/b",
+  "variations": [
+    { "name": "Control", "weight": 5000 },
+    { "name": "Variation 1", "weight": 5000 }
+  ],
+  "metrics": [{ "event_id": 67890 }],
+  "status": "not_started"
+}
+```
+
+### Update Experiment
+
+```bash
+PATCH https://api.optimizely.com/v2/experiments/{experiment_id}
+
+{
+  "status": "running"
+}
+```
+
+### List Campaigns
+
+```bash
+GET https://api.optimizely.com/v2/campaigns?project_id={project_id}
+```
+
+### Get Campaign Results
+
+```bash
+GET https://api.optimizely.com/v2/campaigns/{campaign_id}/results
+```
+
+### List Audiences
+
+```bash
+GET https://api.optimizely.com/v2/audiences?project_id={project_id}
+```
+
+### List Events
+
+```bash
+GET https://api.optimizely.com/v2/events?project_id={project_id}
+```
+
+### List Pages
+
+```bash
+GET https://api.optimizely.com/v2/pages?project_id={project_id}
+```
+
+## Key Metrics
+
+### Experiment Results
+- `variation_id` - Variation identifier
+- `variation_name` - Variation display name
+- `visitors` - Unique visitors per variation
+- `conversions` - Conversion count
+- `conversion_rate` - Rate as decimal
+- `improvement` - Percentage improvement vs. control
+- `statistical_significance` - Confidence level
+- `is_baseline` - Whether this is the control
+
+### Experiment Properties
+- `name` - Experiment name
+- `status` - not_started, running, paused, archived
+- `type` - a/b, multivariate, personalization
+- `traffic_allocation` - Percentage of traffic (0-10000 = 0-100%)
+- `variations` - Array of variations with weights
+
+## Parameters
+
+### List Experiments
+- `project_id` (required) - Project to list experiments for
+- `page` - Page number
+- `per_page` - Results per page (default: 25)
+- `status` - Filter by status
+
+### Get Results
+- `start_time` - Results start time (ISO 8601)
+- `end_time` - Results end time (ISO 8601)
+
+### Create Experiment
+- `project_id` (required) - Parent project
+- `name` (required) - Experiment name
+- `type` - Experiment type (default: a/b)
+- `variations` (required) - Array of variations with name and weight
+- `metrics` - Array of metric/event configurations
+- `audience_conditions` - Targeting conditions
+- `traffic_allocation` - Traffic percentage (0-10000)
+
+## When to Use
+
+- Running A/B tests on web pages and features
+- Managing experimentation programs at scale
+- Pulling experiment results for analysis
+- Automating experiment creation and monitoring
+- Feature flag management
+- Personalization campaigns
+
+## Rate Limits
+
+- 50 requests/second per personal token
+- Pagination via `page` and `per_page` parameters
+- OpenAPI spec available at https://api.optimizely.com/v2/swagger.json
+
+## Relevant Skills
+
+- ab-test-setup
+- page-cro
+- landing-page
+- personalization
+- analytics-tracking

package/payload/tools/integrations/paddle.md

@@ -0,0 +1,212 @@
+# Paddle
+
+SaaS billing and payments platform with built-in tax compliance, acting as merchant of record for global sales.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for products, prices, subscriptions, transactions |
+| MCP | - | Not available |
+| CLI | ✓ | [paddle.js](../clis/paddle.js) |
+| SDK | ✓ | Node.js, Python, PHP, Go |
+
+## Authentication
+
+- **Type**: Bearer Token
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: Paddle dashboard > Developer Tools > Authentication
+- **Production URL**: `https://api.paddle.com`
+- **Sandbox URL**: `https://sandbox-api.paddle.com`
+- **Note**: Version specified via header, not path. Set `PADDLE_SANDBOX=true` env var for sandbox.
+
+## Common Agent Operations
+
+### List products
+
+```bash
+GET https://api.paddle.com/products
+```
+
+### Create a product
+
+```bash
+POST https://api.paddle.com/products
+
+{
+  "name": "Pro Plan",
+  "tax_category": "standard",
+  "description": "Professional tier subscription"
+}
+```
+
+### Create a price for a product
+
+```bash
+POST https://api.paddle.com/prices
+
+{
+  "product_id": "pro_01abc...",
+  "description": "Monthly Pro",
+  "unit_price": {
+    "amount": "2999",
+    "currency_code": "USD"
+  },
+  "billing_cycle": {
+    "interval": "month",
+    "frequency": 1
+  }
+}
+```
+
+### List customers
+
+```bash
+GET https://api.paddle.com/customers
+```
+
+### Create a customer
+
+```bash
+POST https://api.paddle.com/customers
+
+{
+  "email": "customer@example.com",
+  "name": "Jane Smith"
+}
+```
+
+### List subscriptions
+
+```bash
+GET https://api.paddle.com/subscriptions?status=active
+```
+
+### Get subscription details
+
+```bash
+GET https://api.paddle.com/subscriptions/{subscription_id}
+```
+
+### Cancel a subscription
+
+```bash
+POST https://api.paddle.com/subscriptions/{subscription_id}/cancel
+
+{
+  "effective_from": "next_billing_period"
+}
+```
+
+### Pause a subscription
+
+```bash
+POST https://api.paddle.com/subscriptions/{subscription_id}/pause
+```
+
+### List transactions
+
+```bash
+GET https://api.paddle.com/transactions
+```
+
+### Create a discount
+
+```bash
+POST https://api.paddle.com/discounts
+
+{
+  "amount": "20",
+  "type": "percentage",
+  "description": "20% off first month",
+  "code": "WELCOME20"
+}
+```
+
+### Create a refund adjustment
+
+```bash
+POST https://api.paddle.com/adjustments
+
+{
+  "transaction_id": "txn_01abc...",
+  "action": "refund",
+  "reason": "Customer requested refund",
+  "items": [{"item_id": "txnitm_01abc...", "type": "full"}]
+}
+```
+
+### List events
+
+```bash
+GET https://api.paddle.com/events
+```
+
+### List event types
+
+```bash
+GET https://api.paddle.com/event-types
+```
+
+## Key Metrics
+
+### Transaction Metrics
+- `totals.total` - Total amount charged
+- `totals.tax` - Tax amount
+- `totals.subtotal` - Amount before tax
+- `totals.discount` - Discount applied
+- `currency_code` - Transaction currency
+
+### Subscription Metrics
+- `status` - active, canceled, paused, past_due, trialing
+- `current_billing_period` - Current period start/end
+- `next_billed_at` - Next billing date
+- `scheduled_change` - Pending changes (cancellation, plan change)
+
+### Product/Price Metrics
+- `unit_price.amount` - Price in lowest denomination
+- `billing_cycle` - Interval and frequency
+- `trial_period` - Trial duration if set
+
+## Parameters
+
+### List Filtering
+- `status` - Filter by status (e.g., active, archived)
+- `after` - Cursor for pagination
+- `per_page` - Results per page (default: 50)
+- `order_by` - Sort field and direction
+
+### Subscription Cancel Options
+- `effective_from` - `immediately` or `next_billing_period`
+
+### Price Billing Cycle
+- `interval` - `day`, `week`, `month`, `year`
+- `frequency` - Number of intervals between billings
+
+### Tax Categories
+- `standard` - Standard tax rate
+- `digital-goods` - Digital goods tax rate
+- `saas` - SaaS-specific tax rate
+
+## When to Use
+
+- Managing SaaS subscription billing with tax compliance
+- Creating products and pricing tiers
+- Processing refunds and adjustments
+- Handling subscription lifecycle (create, pause, cancel, resume)
+- Global tax handling as merchant of record
+- Discount and coupon management for promotions
+
+## Rate Limits
+
+- 100 requests per minute
+- Applies across all endpoints
+- HTTP 429 returned when exceeded
+
+## Relevant Skills
+
+- pricing-page
+- saas-metrics
+- churn-reduction
+- launch-sequence
+- monetization-strategy

package/payload/tools/integrations/partnerstack.md

@@ -0,0 +1,222 @@
+# PartnerStack
+
+Partner and affiliate program management platform for SaaS companies with deal tracking, rewards, and multi-tier partnerships.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Vendor API v2 for partnerships, deals, customers, transactions |
+| MCP | - | Not available |
+| CLI | ✓ | [partnerstack.js](../clis/partnerstack.js) |
+| SDK | - | No official SDK; REST API with Basic Auth |
+
+## Authentication
+
+- **Type**: Basic Auth (Vendor API)
+- **Header**: `Authorization: Basic {base64(public_key:secret_key)}`
+- **Get credentials**: Vendor dashboard > Settings > Integrations > PartnerStack API Keys
+- **Note**: Separate Test and Production API keys. Test transactions can only be added to customers created with Test keys.
+
+## Common Agent Operations
+
+### List partnerships
+
+```bash
+GET https://api.partnerstack.com/api/v2/partnerships?limit=25
+
+Authorization: Basic {base64(public_key:secret_key)}
+```
+
+### Create a partnership
+
+```bash
+POST https://api.partnerstack.com/api/v2/partnerships
+
+{
+  "email": "partner@example.com",
+  "group_key": "affiliates",
+  "first_name": "Jane",
+  "last_name": "Smith"
+}
+```
+
+### List customers
+
+```bash
+GET https://api.partnerstack.com/api/v2/customers?limit=25
+```
+
+### Create a customer (attribute to partner)
+
+```bash
+POST https://api.partnerstack.com/api/v2/customers
+
+{
+  "email": "customer@example.com",
+  "partner_key": "prtnr_abc123",
+  "name": "John Doe"
+}
+```
+
+### Record a transaction
+
+```bash
+POST https://api.partnerstack.com/api/v2/transactions
+
+{
+  "customer_key": "cust_abc123",
+  "amount": 9900,
+  "currency": "USD",
+  "product_key": "pro_plan"
+}
+```
+
+### List deals
+
+```bash
+GET https://api.partnerstack.com/api/v2/deals?limit=25
+```
+
+### Create a deal
+
+```bash
+POST https://api.partnerstack.com/api/v2/deals
+
+{
+  "partner_key": "prtnr_abc123",
+  "name": "Enterprise Opportunity",
+  "amount": 50000,
+  "stage": "qualified"
+}
+```
+
+### Record an action (event-based rewards)
+
+```bash
+POST https://api.partnerstack.com/api/v2/actions
+
+{
+  "customer_key": "cust_abc123",
+  "key": "signup_completed",
+  "value": 1
+}
+```
+
+### Create a reward
+
+```bash
+POST https://api.partnerstack.com/api/v2/rewards
+
+{
+  "partner_key": "prtnr_abc123",
+  "amount": 5000,
+  "description": "Bonus for Q1 performance"
+}
+```
+
+### List leads
+
+```bash
+GET https://api.partnerstack.com/api/v2/leads?limit=25
+```
+
+### Create a lead
+
+```bash
+POST https://api.partnerstack.com/api/v2/leads
+
+{
+  "partner_key": "prtnr_abc123",
+  "email": "lead@company.com",
+  "name": "Potential Customer",
+  "company": "Acme Corp"
+}
+```
+
+### List partner groups
+
+```bash
+GET https://api.partnerstack.com/api/v2/groups
+```
+
+### Manage webhooks
+
+```bash
+POST https://api.partnerstack.com/api/v2/webhooks
+
+{
+  "target": "https://example.com/webhooks/partnerstack",
+  "events": ["deal.created", "transaction.created", "customer.created"]
+}
+```
+
+## API Pattern
+
+PartnerStack uses cursor-based pagination. List responses include `has_more` and item keys for `starting_after` / `ending_before` parameters.
+
+All responses follow the format:
+```json
+{
+  "data": { ... },
+  "message": "...",
+  "status": "2xx"
+}
+```
+
+## Key Metrics
+
+### Partnership Metrics
+- `partner_key` - Unique partner identifier
+- `group` - Partner tier/group
+- `status` - active, pending, archived
+- `created_at` - Partnership start date
+
+### Transaction Metrics
+- `amount` - Transaction value in cents
+- `currency` - Currency code
+- `product_key` - Associated product
+- `customer_key` - Associated customer
+
+### Deal Metrics
+- `amount` - Deal value
+- `stage` - Deal pipeline stage
+- `status` - open, won, lost
+
+### Reward Metrics
+- `amount` - Reward amount in cents
+- `status` - pending, approved, paid
+
+## Parameters
+
+### Pagination Parameters
+- `limit` - Items per page (1-250, default: 10)
+- `starting_after` - Cursor for next page (item key)
+- `ending_before` - Cursor for previous page (item key)
+- `order_by` - Sort field, prefix with `-` for descending
+
+### Common Filters
+- `include_archived` - Include archived records
+- `has_sub_id` - Filter by sub ID presence
+
+## When to Use
+
+- Managing SaaS affiliate and referral programs
+- Tracking partner-driven revenue and attributions
+- Automating partner onboarding and rewards
+- Deal registration and pipeline tracking
+- Multi-tier partnership programs (affiliates, resellers, agencies)
+- Event-based reward triggers (signups, upgrades, etc.)
+
+## Rate Limits
+
+- Not explicitly documented
+- Use reasonable request rates; implement exponential backoff on 429 responses
+
+## Relevant Skills
+
+- referral-program
+- affiliate-marketing
+- partner-enablement
+- saas-metrics
+- launch-sequence