@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/buffer.md

@@ -0,0 +1,138 @@
+# Buffer
+
+Social media scheduling, publishing, and analytics platform for managing multiple social profiles.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v1 for profiles, updates, scheduling |
+| MCP | - | Not available |
+| CLI | ✓ | [buffer.js](../clis/buffer.js) |
+| SDK | - | No official SDK; legacy API still supported |
+
+## Authentication
+
+- **Type**: OAuth 2.0 Bearer Token
+- **Header**: `Authorization: Bearer {access_token}`
+- **Get key**: Register app at https://buffer.com/developers/apps then complete OAuth flow
+- **Note**: Buffer is no longer accepting new developer app registrations; existing apps continue to work. New public API is in development at https://buffer.com/developer-api
+
+## Common Agent Operations
+
+### Get user info
+
+```bash
+GET https://api.bufferapp.com/1/user.json
+
+Authorization: Bearer {token}
+```
+
+### List connected profiles
+
+```bash
+GET https://api.bufferapp.com/1/profiles.json
+
+Authorization: Bearer {token}
+```
+
+### Get profile posting schedules
+
+```bash
+GET https://api.bufferapp.com/1/profiles/{profile_id}/schedules.json
+```
+
+### Create a scheduled post
+
+```bash
+POST https://api.bufferapp.com/1/updates/create.json
+Content-Type: application/x-www-form-urlencoded
+
+profile_ids[]={profile_id}&text=Your+post+content&scheduled_at=2026-03-01T10:00:00Z
+```
+
+### Get pending updates for a profile
+
+```bash
+GET https://api.bufferapp.com/1/profiles/{profile_id}/updates/pending.json?count=25
+```
+
+### Get sent updates for a profile
+
+```bash
+GET https://api.bufferapp.com/1/profiles/{profile_id}/updates/sent.json?count=25
+```
+
+### Publish a pending update immediately
+
+```bash
+POST https://api.bufferapp.com/1/updates/{update_id}/share.json
+```
+
+### Delete an update
+
+```bash
+POST https://api.bufferapp.com/1/updates/{update_id}/destroy.json
+```
+
+### Reorder queue
+
+```bash
+POST https://api.bufferapp.com/1/profiles/{profile_id}/updates/reorder.json
+Content-Type: application/x-www-form-urlencoded
+
+order[]={update_id_1}&order[]={update_id_2}&order[]={update_id_3}
+```
+
+## API Pattern
+
+Buffer API v1 uses `.json` extensions on all endpoints. POST requests use `application/x-www-form-urlencoded` content type. Array parameters use bracket notation (e.g., `profile_ids[]`).
+
+Responses include a `success` boolean for mutation operations.
+
+## Key Metrics
+
+### Profile Metrics
+- `followers` - Follower count for connected profile
+- `service` - Platform name (twitter, facebook, instagram, linkedin, etc.)
+
+### Update Metrics (sent updates)
+- `statistics.reach` - Post reach
+- `statistics.clicks` - Link clicks
+- `statistics.retweets` - Retweets/shares
+- `statistics.favorites` - Likes/favorites
+- `statistics.mentions` - Mentions
+
+## Parameters
+
+### Update Create Parameters
+- `profile_ids[]` - Required. Array of profile IDs to post to
+- `text` - Required. Post content
+- `scheduled_at` - ISO 8601 timestamp for scheduling
+- `now` - Set to `true` to publish immediately
+- `top` - Set to `true` to add to top of queue
+- `shorten` - Set to `true` to auto-shorten links
+- `media[photo]` - URL to photo attachment
+- `media[thumbnail]` - URL to thumbnail
+- `media[link]` - URL for link attachment
+
+## When to Use
+
+- Scheduling social media posts across multiple platforms
+- Managing social media content queues
+- Analyzing post performance across channels
+- Automating social media publishing workflows
+- Coordinating team social media activity
+
+## Rate Limits
+
+- 60 authenticated requests per user per minute
+- Exceeding returns HTTP 429
+- Higher limits available by contacting hello@buffer.com
+
+## Relevant Skills
+
+- social-media-calendar
+- content-repurposing
+- social-proof
+- launch-sequence

package/payload/tools/integrations/calendly.md

@@ -0,0 +1,161 @@
+# Calendly
+
+Scheduling and booking platform API for managing event types, scheduled events, invitees, and availability.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v2 - event types, scheduled events, invitees, availability |
+| MCP | - | Not available |
+| CLI | ✓ | [calendly.js](../clis/calendly.js) |
+| SDK | ✓ | No official SDK; community libraries available |
+
+## Authentication
+
+- **Type**: Bearer Token (Personal Access Token or OAuth 2.0)
+- **Header**: `Authorization: Bearer {token}`
+- **Get key**: https://calendly.com/integrations/api_webhooks (Personal Access Token)
+
+## Common Agent Operations
+
+### Get current user
+
+```bash
+GET https://api.calendly.com/users/me
+```
+
+### List event types
+
+```bash
+GET https://api.calendly.com/event_types?user={user_uri}
+```
+
+### List scheduled events
+
+```bash
+GET https://api.calendly.com/scheduled_events?user={user_uri}&min_start_time=2024-01-01T00:00:00Z&max_start_time=2024-12-31T23:59:59Z&status=active
+```
+
+### Get a scheduled event
+
+```bash
+GET https://api.calendly.com/scheduled_events/{event_uuid}
+```
+
+### List invitees for an event
+
+```bash
+GET https://api.calendly.com/scheduled_events/{event_uuid}/invitees
+```
+
+### Cancel a scheduled event
+
+```bash
+POST https://api.calendly.com/scheduled_events/{event_uuid}/cancellation
+
+{
+  "reason": "Cancellation reason"
+}
+```
+
+### Get available times
+
+```bash
+GET https://api.calendly.com/event_type_available_times?event_type={event_type_uri}&start_time=2024-01-20T00:00:00Z&end_time=2024-01-27T00:00:00Z
+```
+
+### Get user busy times
+
+```bash
+GET https://api.calendly.com/user_busy_times?user={user_uri}&start_time=2024-01-20T00:00:00Z&end_time=2024-01-27T00:00:00Z
+```
+
+### List organization members
+
+```bash
+GET https://api.calendly.com/organization_memberships?organization={organization_uri}
+```
+
+### Create webhook subscription
+
+```bash
+POST https://api.calendly.com/webhook_subscriptions
+
+{
+  "url": "https://example.com/webhook",
+  "events": ["invitee.created", "invitee.canceled"],
+  "organization": "{organization_uri}",
+  "scope": "organization"
+}
+```
+
+### List webhook subscriptions
+
+```bash
+GET https://api.calendly.com/webhook_subscriptions?organization={organization_uri}&scope=organization
+```
+
+### Delete webhook subscription
+
+```bash
+DELETE https://api.calendly.com/webhook_subscriptions/{webhook_uuid}
+```
+
+## Key Metrics
+
+### Scheduled Event Data
+- `uri` - Unique event URI
+- `name` - Event type name
+- `status` - Event status (active, canceled)
+- `start_time` / `end_time` - Event timing
+- `event_type` - URI of the event type
+- `location` - Meeting location details
+- `invitees_counter` - Count of invitees (active, limit, total)
+
+### Invitee Data
+- `name` - Invitee full name
+- `email` - Invitee email
+- `status` - active or canceled
+- `questions_and_answers` - Custom question responses
+- `tracking` - UTM parameters
+- `created_at` / `updated_at` - Timestamps
+
+## Parameters
+
+### List Scheduled Events
+- `user` - User URI (required)
+- `min_start_time` / `max_start_time` - Date range filter (ISO 8601)
+- `status` - Filter by status (active, canceled)
+- `count` - Number of results (default 20, max 100)
+- `page_token` - Pagination token
+- `sort` - Sort order (start_time:asc or start_time:desc)
+
+### List Event Types
+- `user` - User URI
+- `organization` - Organization URI
+- `active` - Filter active/inactive
+- `count` - Results per page
+- `sort` - Sort order
+
+## When to Use
+
+- Retrieving scheduled meeting data for CRM sync
+- Monitoring booking activity and conversion rates
+- Automating follow-up workflows after meetings
+- Checking availability before suggesting meeting times
+- Tracking meeting cancellations and no-shows
+- Building custom booking interfaces
+
+## Rate Limits
+
+- Not officially documented; implement retry logic with exponential backoff
+- Use conservative request rates (avoid bursting)
+- Monitor for HTTP 429 responses
+
+## Relevant Skills
+
+- lead-generation
+- sales-automation
+- customer-onboarding
+- appointment-scheduling

package/payload/tools/integrations/clearbit.md

@@ -0,0 +1,142 @@
+# Clearbit (HubSpot Breeze Intelligence)
+
+Company and person data enrichment API for converting leads with 100+ firmographic and technographic attributes.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Person, Company, Combined Enrichment, Reveal, Name to Domain, Prospector |
+| MCP | - | Not available |
+| CLI | ✓ | [clearbit.js](../clis/clearbit.js) |
+| SDK | ✓ | Node, Ruby, Python, PHP |
+
+## Authentication
+
+- **Type**: Bearer Token (or Basic Auth with API key as username)
+- **Header**: `Authorization: Bearer {api_key}`
+- **Get key**: https://dashboard.clearbit.com/api
+
+## Common Agent Operations
+
+### Person Enrichment (by email)
+
+```bash
+GET https://person.clearbit.com/v2/people/find?email=alex@clearbit.com
+```
+
+Returns 100+ attributes: name, title, company, location, social profiles, employment history.
+
+### Company Enrichment (by domain)
+
+```bash
+GET https://company.clearbit.com/v2/companies/find?domain=clearbit.com
+```
+
+Returns firmographics: industry, size, revenue, tech stack, location, funding.
+
+### Combined Enrichment (person + company)
+
+```bash
+GET https://person.clearbit.com/v2/combined/find?email=alex@clearbit.com
+```
+
+Returns both person and company data in a single request.
+
+### Reveal (IP to company)
+
+```bash
+GET https://reveal.clearbit.com/v1/companies/find?ip=104.132.0.0
+```
+
+Identifies the company behind a website visitor by IP address.
+
+### Name to Domain
+
+```bash
+GET https://company.clearbit.com/v1/domains/find?name=Clearbit
+```
+
+Converts a company name to its domain.
+
+### Prospector (find employees)
+
+```bash
+GET https://prospector.clearbit.com/v1/people/search?domain=clearbit.com&role=sales&seniority=executive
+```
+
+Finds employees at a company filtered by role, seniority, title.
+
+## API Pattern
+
+Clearbit uses separate subdomains per API:
+- `person.clearbit.com` - Person data
+- `company.clearbit.com` - Company data, Name to Domain
+- `person-stream.clearbit.com` - Streaming person lookup (blocking, up to 60s)
+- `company-stream.clearbit.com` - Streaming company lookup (blocking, up to 60s)
+- `reveal.clearbit.com` - IP to company
+- `prospector.clearbit.com` - Employee search
+
+Standard endpoints return `202 Accepted` if data is being processed (use webhooks). Stream endpoints block until data is ready.
+
+## Key Metrics
+
+### Person Attributes
+- `name.fullName` - Full name
+- `title` - Job title
+- `role` - Job role (sales, engineering, etc.)
+- `seniority` - Seniority level
+- `employment.name` - Company name
+- `linkedin.handle` - LinkedIn profile
+
+### Company Attributes
+- `name` - Company name
+- `domain` - Website domain
+- `category.industry` - Industry
+- `metrics.employees` - Employee count
+- `metrics.estimatedAnnualRevenue` - Revenue range
+- `tech` - Technology stack array
+- `metrics.raised` - Total funding raised
+
+## Parameters
+
+### Person Enrichment
+- `email` (required) - Email address to look up
+- `webhook_url` - URL for async results
+- `subscribe` - Subscribe to future changes
+
+### Company Enrichment
+- `domain` (required) - Company domain to look up
+- `webhook_url` - URL for async results
+
+### Prospector
+- `domain` (required) - Company domain
+- `role` - Job role filter (sales, engineering, marketing, etc.)
+- `seniority` - Seniority filter (executive, director, manager, etc.)
+- `title` - Exact title filter
+- `page` - Page number (default: 1)
+- `page_size` - Results per page (default: 5, max: 20)
+
+## When to Use
+
+- Lead scoring and qualification based on firmographic data
+- Enriching CRM contacts with company and person data
+- De-anonymizing website visitors with Reveal
+- Building prospect lists with Prospector
+- Personalizing marketing based on company attributes
+- Routing leads based on company size, industry, or tech stack
+
+## Rate Limits
+
+- Enrichment: 600 requests/minute
+- Prospector: 100 requests/minute
+- Reveal: 600 requests/minute
+- Responses include `X-RateLimit-Limit` and `X-RateLimit-Remaining` headers
+
+## Relevant Skills
+
+- lead-scoring
+- personalization
+- abm-strategy
+- lead-enrichment
+- competitor-alternatives

package/payload/tools/integrations/customer-io.md

@@ -0,0 +1,187 @@
+# Customer.io
+
+Behavior-based messaging platform for email, push, SMS, and in-app.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | Track API, App API, Journeys API |
+| MCP | - | Not available |
+| CLI | - | Not available |
+| SDK | ✓ | JavaScript, iOS, Android, Ruby, Python |
+
+## Authentication
+
+- **Track API**: Site ID + API Key (Basic auth)
+- **App API**: Bearer token
+- **Header**: `Authorization: Basic {base64(site_id:api_key)}`
+
+## Common Agent Operations
+
+### Identify customer
+
+```bash
+PUT https://track.customer.io/api/v1/customers/{customer_id}
+
+Authorization: Basic {base64(site_id:api_key)}
+
+{
+  "email": "user@example.com",
+  "created_at": 1705312800,
+  "first_name": "John",
+  "plan": "pro"
+}
+```
+
+### Track event
+
+```bash
+POST https://track.customer.io/api/v1/customers/{customer_id}/events
+
+Authorization: Basic {base64(site_id:api_key)}
+
+{
+  "name": "purchase",
+  "data": {
+    "product": "Pro Plan",
+    "amount": 99
+  }
+}
+```
+
+### Track anonymous event
+
+```bash
+POST https://track.customer.io/api/v1/events
+
+Authorization: Basic {base64(site_id:api_key)}
+
+{
+  "name": "page_viewed",
+  "data": {
+    "page": "/pricing"
+  },
+  "anonymous_id": "anon_123"
+}
+```
+
+### Delete customer
+
+```bash
+DELETE https://track.customer.io/api/v1/customers/{customer_id}
+
+Authorization: Basic {base64(site_id:api_key)}
+```
+
+### Get customer (App API)
+
+```bash
+GET https://api.customer.io/v1/customers/{customer_id}/attributes
+
+Authorization: Bearer {app_api_key}
+```
+
+### List campaigns
+
+```bash
+GET https://api.customer.io/v1/campaigns
+
+Authorization: Bearer {app_api_key}
+```
+
+### Get campaign metrics
+
+```bash
+GET https://api.customer.io/v1/campaigns/{campaign_id}/metrics
+
+Authorization: Bearer {app_api_key}
+```
+
+### Trigger broadcast
+
+```bash
+POST https://api.customer.io/v1/campaigns/{campaign_id}/triggers
+
+Authorization: Bearer {app_api_key}
+
+{
+  "emails": ["user@example.com"],
+  "data": {
+    "coupon_code": "SAVE20"
+  }
+}
+```
+
+### Send transactional email
+
+```bash
+POST https://api.customer.io/v1/send/email
+
+Authorization: Bearer {app_api_key}
+
+{
+  "transactional_message_id": "1",
+  "to": "user@example.com",
+  "identifiers": {
+    "id": "user_123"
+  },
+  "message_data": {
+    "order_id": "ORD-456"
+  }
+}
+```
+
+## JavaScript SDK
+
+```javascript
+// Initialize
+_cio.identify({
+  id: 'user_123',
+  email: 'user@example.com',
+  created_at: 1705312800,
+  plan: 'pro'
+});
+
+// Track event
+_cio.track('purchase', {
+  product: 'Pro Plan',
+  amount: 99
+});
+
+// Track page view
+_cio.page();
+```
+
+## Key Concepts
+
+- **People** - Customers and leads
+- **Segments** - Dynamic groups based on attributes/behavior
+- **Campaigns** - Automated message sequences
+- **Broadcasts** - One-time sends
+- **Transactional** - Triggered messages
+
+## Attribute Types
+
+- Standard: `email`, `created_at`, `unsubscribed`
+- Custom: Any key you define
+- Computed: Aggregations from events
+
+## When to Use
+
+- Behavior-based email automation
+- Multi-channel messaging (email, push, SMS)
+- Onboarding sequences
+- Re-engagement campaigns
+- Transactional messages
+
+## Rate Limits
+
+- Track API: 100 requests/second
+- App API: 10 requests/second
+
+## Relevant Skills
+
+- email-sequence
+- onboarding-cro
+- analytics-tracking