@miranda0808/maya-codex 0.1.0

package/payload/tools/integrations/hubspot.md

@@ -0,0 +1,178 @@
+# HubSpot
+
+CRM platform for marketing, sales, and customer service.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for CRM, Marketing, Sales |
+| MCP | - | Not available |
+| CLI | ✓ | `hs` CLI for local development |
+| SDK | ✓ | Official client libraries |
+
+## Authentication
+
+- **Type**: Private App Token or OAuth 2.0
+- **Header**: `Authorization: Bearer {access_token}`
+- **Get token**: Settings > Integrations > Private Apps
+
+## Common Agent Operations
+
+### Get contacts
+
+```bash
+GET https://api.hubapi.com/crm/v3/objects/contacts?limit=10
+
+Authorization: Bearer {access_token}
+```
+
+### Search contacts
+
+```bash
+POST https://api.hubapi.com/crm/v3/objects/contacts/search
+
+{
+  "filterGroups": [{
+    "filters": [{
+      "propertyName": "email",
+      "operator": "EQ",
+      "value": "user@example.com"
+    }]
+  }]
+}
+```
+
+### Create contact
+
+```bash
+POST https://api.hubapi.com/crm/v3/objects/contacts
+
+{
+  "properties": {
+    "email": "user@example.com",
+    "firstname": "John",
+    "lastname": "Doe",
+    "company": "Example Inc"
+  }
+}
+```
+
+### Update contact
+
+```bash
+PATCH https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}
+
+{
+  "properties": {
+    "lifecyclestage": "customer"
+  }
+}
+```
+
+### Get deals
+
+```bash
+GET https://api.hubapi.com/crm/v3/objects/deals?limit=10&properties=dealname,amount,dealstage
+
+Authorization: Bearer {access_token}
+```
+
+### Create deal
+
+```bash
+POST https://api.hubapi.com/crm/v3/objects/deals
+
+{
+  "properties": {
+    "dealname": "New Deal",
+    "amount": "10000",
+    "dealstage": "appointmentscheduled",
+    "pipeline": "default"
+  }
+}
+```
+
+### Associate contact with deal
+
+```bash
+PUT https://api.hubapi.com/crm/v3/objects/deals/{deal_id}/associations/contacts/{contact_id}/deal_to_contact
+```
+
+### Get form submissions
+
+```bash
+GET https://api.hubapi.com/form-integrations/v1/submissions/forms/{form_guid}
+
+Authorization: Bearer {access_token}
+```
+
+### Get marketing emails
+
+```bash
+GET https://api.hubapi.com/marketing/v3/emails?limit=10
+
+Authorization: Bearer {access_token}
+```
+
+## CLI Commands
+
+```bash
+# Install
+npm install -g @hubspot/cli
+
+# Initialize project
+hs init
+
+# Upload files
+hs upload src dest
+
+# Watch for changes
+hs watch src dest
+
+# List portals
+hs accounts list
+```
+
+## Key Objects
+
+- **Contacts** - People in CRM
+- **Companies** - Organizations
+- **Deals** - Sales opportunities
+- **Tickets** - Support tickets
+- **Products** - Items for sale
+- **Line Items** - Deal line items
+
+## Common Properties
+
+### Contact Properties
+- `email` - Email address
+- `firstname`, `lastname` - Name
+- `lifecyclestage` - Funnel stage
+- `hs_lead_status` - Lead status
+
+### Deal Properties
+- `dealname` - Deal name
+- `amount` - Deal value
+- `dealstage` - Pipeline stage
+- `closedate` - Expected close
+
+## When to Use
+
+- Managing contacts and leads
+- Tracking sales deals
+- Marketing automation
+- Form submissions
+- Email campaigns
+- Customer service tickets
+
+## Rate Limits
+
+- 100 requests per 10 seconds
+- Higher limits on enterprise plans
+
+## Relevant Skills
+
+- email-sequence
+- analytics-tracking
+- referral-program

package/payload/tools/integrations/hunter.md

@@ -0,0 +1,90 @@
+# Hunter.io
+
+Email finding and verification platform for outreach and link building.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for domain search, email finder, verification |
+| MCP | - | Not available |
+| CLI | [✓](../clis/hunter.js) | Zero-dependency Node.js CLI |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: API Key (query parameter)
+- **Parameter**: `api_key={key}`
+- **Env var**: `HUNTER_API_KEY`
+- **Get key**: [Hunter dashboard > API](https://hunter.io/api-keys)
+
+## Common Agent Operations
+
+### Find emails for a domain
+
+```bash
+node tools/clis/hunter.js domain search --domain example.com --limit 10
+```
+
+### Find a specific person's email
+
+```bash
+node tools/clis/hunter.js email find --domain example.com --first-name John --last-name Doe
+```
+
+### Verify an email address
+
+```bash
+node tools/clis/hunter.js email verify --email john@example.com
+```
+
+### Count emails available for a domain
+
+```bash
+node tools/clis/hunter.js domain count --domain example.com
+```
+
+### Manage leads
+
+```bash
+# List leads
+node tools/clis/hunter.js leads list --limit 20
+
+# Create a lead
+node tools/clis/hunter.js leads create --email john@example.com --first-name John --last-name Doe --company "Example Inc"
+
+# Delete a lead
+node tools/clis/hunter.js leads delete --id 12345
+```
+
+### Manage campaigns
+
+```bash
+# List campaigns
+node tools/clis/hunter.js campaigns list
+
+# Get campaign details
+node tools/clis/hunter.js campaigns get --id 12345
+
+# Start/pause a campaign
+node tools/clis/hunter.js campaigns start --id 12345
+node tools/clis/hunter.js campaigns pause --id 12345
+```
+
+### Check account usage
+
+```bash
+node tools/clis/hunter.js account info
+```
+
+## Rate Limits
+
+- Free plan: 25 searches/month, 50 verifications/month
+- Paid plans scale with tier
+- API rate limit: 10 requests/second
+
+## Use Cases
+
+- **Link building**: Find email contacts at target domains for outreach
+- **Prospecting**: Build lead lists from company domains
+- **Verification**: Clean email lists before sending campaigns

package/payload/tools/integrations/instantly.md

@@ -0,0 +1,104 @@
+# Instantly.ai
+
+Cold email platform with built-in email warmup and campaign management at scale.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API for campaigns, leads, accounts, analytics |
+| MCP | - | Not available |
+| CLI | [✓](../clis/instantly.js) | Zero-dependency Node.js CLI |
+| SDK | - | API-only |
+
+## Authentication
+
+- **Type**: API Key (query parameter)
+- **Parameter**: `api_key={key}`
+- **Env var**: `INSTANTLY_API_KEY`
+- **Get key**: [Instantly Settings > Integrations > API](https://app.instantly.ai/app/settings/integrations)
+
+## Common Agent Operations
+
+### Manage campaigns
+
+```bash
+# List campaigns
+node tools/clis/instantly.js campaigns list --limit 20
+
+# Get campaign details
+node tools/clis/instantly.js campaigns get --id cam_abc123
+
+# Check campaign status
+node tools/clis/instantly.js campaigns status --id cam_abc123
+
+# Launch a campaign
+node tools/clis/instantly.js campaigns launch --id cam_abc123
+
+# Pause a campaign
+node tools/clis/instantly.js campaigns pause --id cam_abc123
+```
+
+### Manage leads
+
+```bash
+# List leads in a campaign
+node tools/clis/instantly.js leads list --campaign-id cam_abc123 --limit 50
+
+# Add a lead
+node tools/clis/instantly.js leads add --campaign-id cam_abc123 --email john@example.com --first-name John --last-name Doe --company "Example Inc"
+
+# Delete a lead
+node tools/clis/instantly.js leads delete --campaign-id cam_abc123 --email john@example.com
+
+# Check lead status
+node tools/clis/instantly.js leads status --campaign-id cam_abc123 --email john@example.com
+```
+
+### Manage email accounts
+
+```bash
+# List connected accounts
+node tools/clis/instantly.js accounts list --limit 20
+
+# Check account status
+node tools/clis/instantly.js accounts status --account-id me@example.com
+
+# Check warmup status
+node tools/clis/instantly.js accounts warmup-status --account-id me@example.com
+```
+
+### View analytics
+
+```bash
+# Campaign analytics
+node tools/clis/instantly.js analytics campaign --campaign-id cam_abc123 --start 2024-01-01 --end 2024-01-31
+
+# Step-by-step analytics
+node tools/clis/instantly.js analytics steps --campaign-id cam_abc123
+
+# Account-level analytics
+node tools/clis/instantly.js analytics account --start 2024-01-01 --end 2024-01-31
+```
+
+### Manage blocklist
+
+```bash
+# List blocked emails/domains
+node tools/clis/instantly.js blocklist list
+
+# Add to blocklist
+node tools/clis/instantly.js blocklist add --entries "competitor.com,spam@example.com"
+```
+
+## Rate Limits
+
+- API rate limits vary by plan
+- Recommended: stay under 10 requests/second
+
+## Use Cases
+
+- **Link building at scale**: Run large-volume outreach campaigns with built-in warmup
+- **Campaign management**: Launch, pause, and monitor cold email campaigns
+- **Account health**: Monitor email account warmup and deliverability
+- **Analytics**: Track open rates, reply rates, and campaign performance

package/payload/tools/integrations/intercom.md

@@ -0,0 +1,292 @@
+# Intercom
+
+Customer messaging and support platform API for managing contacts, conversations, messages, companies, articles, and tags.
+
+## Capabilities
+
+| Integration | Available | Notes |
+|-------------|-----------|-------|
+| API | ✓ | REST API v2.11+ - contacts, conversations, messages, companies, articles, tags |
+| MCP | - | Not available |
+| CLI | ✓ | [intercom.js](../clis/intercom.js) |
+| SDK | ✓ | Node.js, Ruby, Python, PHP, Go |
+
+## Authentication
+
+- **Type**: Bearer Token (Access Token or OAuth 2.0)
+- **Header**: `Authorization: Bearer {token}`
+- **Version Header**: `Intercom-Version: 2.11`
+- **Get key**: Developer Hub at https://app.intercom.com/a/apps/_/developer-hub
+
+## Common Agent Operations
+
+### List contacts
+
+```bash
+GET https://api.intercom.io/contacts
+```
+
+### Get a contact
+
+```bash
+GET https://api.intercom.io/contacts/{id}
+```
+
+### Create a contact
+
+```bash
+POST https://api.intercom.io/contacts
+
+{
+  "role": "user",
+  "email": "user@example.com",
+  "name": "Jane Doe",
+  "custom_attributes": {
+    "plan": "pro"
+  }
+}
+```
+
+### Update a contact
+
+```bash
+PUT https://api.intercom.io/contacts/{id}
+
+{
+  "name": "Jane Smith",
+  "custom_attributes": {
+    "plan": "enterprise"
+  }
+}
+```
+
+### Search contacts
+
+```bash
+POST https://api.intercom.io/contacts/search
+
+{
+  "query": {
+    "field": "email",
+    "operator": "=",
+    "value": "user@example.com"
+  }
+}
+```
+
+### Delete a contact
+
+```bash
+DELETE https://api.intercom.io/contacts/{id}
+```
+
+### List conversations
+
+```bash
+GET https://api.intercom.io/conversations
+```
+
+### Get a conversation
+
+```bash
+GET https://api.intercom.io/conversations/{id}
+```
+
+### Search conversations
+
+```bash
+POST https://api.intercom.io/conversations/search
+
+{
+  "query": {
+    "field": "open",
+    "operator": "=",
+    "value": true
+  }
+}
+```
+
+### Reply to a conversation
+
+```bash
+POST https://api.intercom.io/conversations/{id}/reply
+
+{
+  "message_type": "comment",
+  "type": "admin",
+  "admin_id": "{admin_id}",
+  "body": "Thanks for reaching out!"
+}
+```
+
+### Create a message
+
+```bash
+POST https://api.intercom.io/messages
+
+{
+  "message_type": "inapp",
+  "body": "Welcome to our platform!",
+  "from": {
+    "type": "admin",
+    "id": "{admin_id}"
+  },
+  "to": {
+    "type": "user",
+    "id": "{user_id}"
+  }
+}
+```
+
+### List companies
+
+```bash
+GET https://api.intercom.io/companies
+```
+
+### Create or update a company
+
+```bash
+POST https://api.intercom.io/companies
+
+{
+  "company_id": "company_123",
+  "name": "Acme Corp",
+  "plan": "enterprise",
+  "custom_attributes": {
+    "industry": "Technology"
+  }
+}
+```
+
+### List tags
+
+```bash
+GET https://api.intercom.io/tags
+```
+
+### Create a tag
+
+```bash
+POST https://api.intercom.io/tags
+
+{
+  "name": "VIP Customer"
+}
+```
+
+### Tag a contact
+
+```bash
+POST https://api.intercom.io/contacts/{contact_id}/tags
+
+{
+  "id": "{tag_id}"
+}
+```
+
+### List articles
+
+```bash
+GET https://api.intercom.io/articles
+```
+
+### Create an article
+
+```bash
+POST https://api.intercom.io/articles
+
+{
+  "title": "Getting Started Guide",
+  "body": "<p>Welcome to our platform...</p>",
+  "author_id": "{admin_id}",
+  "state": "published"
+}
+```
+
+### List admins
+
+```bash
+GET https://api.intercom.io/admins
+```
+
+### Submit events
+
+```bash
+POST https://api.intercom.io/events
+
+{
+  "event_name": "purchased-item",
+  "created_at": 1706140800,
+  "user_id": "user_123",
+  "metadata": {
+    "item_name": "Pro Plan",
+    "price": 99.00
+  }
+}
+```
+
+## Key Metrics
+
+### Contact Data
+- `id` - Unique contact identifier
+- `role` - user or lead
+- `email` - Contact email
+- `name` - Contact name
+- `created_at` / `updated_at` - Timestamps
+- `last_seen_at` - Last activity
+- `custom_attributes` - Custom data fields
+- `tags` - Applied tags
+- `companies` - Associated companies
+
+### Conversation Data
+- `id` - Conversation identifier
+- `state` - open, closed, snoozed
+- `open` - Boolean open status
+- `read` - Read status
+- `priority` - Priority level
+- `statistics` - Response times, counts
+- `conversation_parts` - Message history
+
+## Parameters
+
+### List Contacts
+- `per_page` - Results per page (default 50, max 150)
+- `starting_after` - Pagination cursor
+
+### List Conversations
+- `per_page` - Results per page (default 20, max 150)
+- `starting_after` - Pagination cursor
+
+### Search (Contacts & Conversations)
+- `query.field` - Field to search
+- `query.operator` - Comparison operator (=, !=, >, <, ~, IN, NIN)
+- `query.value` - Search value
+- `pagination.per_page` - Results per page
+- `pagination.starting_after` - Cursor for next page
+- `sort.field` / `sort.order` - Sort configuration
+
+## When to Use
+
+- Managing customer contact records and segments
+- Automating customer messaging and onboarding
+- Monitoring and responding to support conversations
+- Tracking customer events and behavior
+- Building custom support workflows
+- Syncing customer data between platforms
+
+## Rate Limits
+
+- **Default**: 10,000 API calls per minute per app
+- **Per workspace**: 25,000 API calls per minute
+- Distributed in 10-second windows (resets every 10 seconds)
+- Headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
+- HTTP 429 returned when exceeded
+
+## Relevant Skills
+
+- customer-onboarding
+- customer-retention
+- lead-generation
+- customer-support
+- in-app-messaging