Hi Mike,
I noticed Comfort Zone HVAC is crushing it on reviews...
", + "body_text": "Hi Mike, I noticed Comfort Zone HVAC is crushing it on reviews...", + "reply_to": "cameron@mcfagentic.com", + "track_opens": true, + "track_clicks": true +} +``` + +**Response:** +```json +{ + "id": "msg_4k9xr2", + "status": "sent", + "to": "mike@comfortzonehvac.com", + "sent_at": "2026-04-01T14:40:00Z" +} +``` + +### Send Bulk +- **Method:** POST +- **Path:** /api/email/send-bulk +- **Price:** $0.01 per recipient +- **Description:** Send a campaign to multiple recipients. Supports personalization variables and staggered delivery. + +**Request:** +```json +{ + "template_id": "tmpl_cold_outreach_v2", + "recipients": [ + {"email": "mike@comfortzonehvac.com", "variables": {"first_name": "Mike", "company": "Comfort Zone HVAC"}}, + {"email": "sarah@northtexasair.com", "variables": {"first_name": "Sarah", "company": "North Texas Air"}} + ], + "from": "cameron@mcfagentic.com", + "stagger_minutes": 5, + "track_opens": true +} +``` + +**Response:** +```json +{ + "campaign_id": "camp_7n3mp1", + "total_recipients": 2, + "status": "queued", + "estimated_completion": "2026-04-01T14:50:00Z" +} +``` + +### AI Classify +- **Method:** POST +- **Path:** /api/email/ai/classify +- **Price:** $0.05 per call +- **Description:** Classify an inbound email using AI. Returns intent, sentiment, urgency, and suggested action. + +**Request:** +```json +{ + "subject": "Re: Quick question about your scheduling", + "body": "Hey Cameron, this sounds interesting. We've been struggling with scheduling for a while. Can you tell me more about pricing?", + "sender": "mike@comfortzonehvac.com" +} +``` + +**Response:** +```json +{ + "classification": { + "intent": "interested", + "sentiment": "positive", + "urgency": "medium", + "category": "sales-reply", + "suggested_action": "send-pricing", + "confidence": 0.94 + } +} +``` + +### AI Reply +- **Method:** POST +- **Path:** /api/email/ai/reply +- **Price:** $0.10 per call +- **Description:** Generate a contextual reply to an email thread using AI. Takes conversation history and CRM context. + +**Request:** +```json +{ + "thread": [ + {"from": "cameron@mcfagentic.com", "body": "Quick question about your scheduling..."}, + {"from": "mike@comfortzonehvac.com", "body": "This sounds interesting. Can you tell me more about pricing?"} + ], + "context": { + "lead_stage": "qualified", + "solution": "ai-scheduling-bundle", + "monthly_price": "$497" + }, + "tone": "casual-professional", + "goal": "book-a-call" +} +``` + +**Response:** +```json +{ + "reply": { + "subject": "Re: Quick question about your scheduling", + "body": "Hey Mike,\n\nGlad it caught your eye. The AI scheduling package runs $497/mo and typically pays for itself within the first month...", + "call_to_action": "calendar-link" + } +} +``` + +### Manage Templates +- **Method:** POST +- **Path:** /api/email/templates +- **Price:** $0.02 per call +- **Description:** Create or update reusable email templates with personalization variables. + +**Request:** +```json +{ + "name": "Cold Outreach v2", + "subject": "Quick question about your {{pain_point}}, {{first_name}}", + "body_html": "Hi {{first_name}},
I noticed {{company}} is doing great work in {{industry}}...
", + "variables": ["first_name", "company", "industry", "pain_point"] +} +``` + +**Response:** +```json +{ + "id": "tmpl_cold_outreach_v2", + "name": "Cold Outreach v2", + "variables": ["first_name", "company", "industry", "pain_point"], + "created_at": "2026-04-01T14:45:00Z" +} +``` + +## Use Cases + +- An outreach agent sends personalized cold emails to leads from the pipeline +- A support agent classifies inbound emails and routes them to the right workflow +- An autonomous sales agent generates and sends follow-up replies based on prospect responses +- A marketing agent runs drip campaigns across segmented lead lists +- An agent orchestrator monitors email threads and escalates urgent messages + +## Pricing + +| Endpoint | Price | Description | +|----------|-------|-------------| +| /api/email/send | $0.02 | Send a single email | +| /api/email/send-bulk | $0.01/recipient | Bulk campaign send | +| /api/email/ai/classify | $0.05 | AI email classification | +| /api/email/ai/reply | $0.10 | AI reply generation | +| /api/email/templates | $0.02 | Create/update templates | diff --git a/skills/lead-gen-pipeline/SKILL.md b/skills/lead-gen-pipeline/SKILL.md new file mode 100644 index 000000000..981ee468f --- /dev/null +++ b/skills/lead-gen-pipeline/SKILL.md @@ -0,0 +1,178 @@ +--- +name: lead-gen-pipeline +description: Autonomous 6-agent pipeline that researches industries, finds businesses, and generates personalized outreach — one API call. +author: MCF Agentic +version: 1.0.0 +tags: [lead-generation, outreach, sales, ai-research, cold-email, pipeline, autonomous] +pricing: x402 (USDC on Base) +gateway: https://gateway.mcfagentic.com +--- + +# Lead Generation Pipeline + +This is not just an API — it is a full autonomous research and outreach pipeline powered by 6 coordinated AI agents. Send an industry and location, and the pipeline discovers real businesses, researches them deeply, identifies pain points, matches solution packages, and writes personalized cold emails ready to send. One call replaces hours of manual prospecting. + +## Authentication + +All endpoints require x402 payment (USDC on Base L2). Send a request without payment to receive pricing info in the 402 response. + +## Endpoints + +### Generate Leads +- **Method:** POST +- **Path:** /api/pipeline/generate-leads +- **Price:** $1.00 per call +- **Description:** Full pipeline run. Provide an industry and location, receive a list of researched leads with pain-point analysis, matched solutions, and ready-to-send outreach emails. + +**Request:** +```json +{ + "industry": "HVAC contractors", + "location": "Dallas, TX", + "count": 10, + "solution_focus": "ai-automation" +} +``` + +**Response:** +```json +{ + "leads": [ + { + "business_name": "Comfort Zone HVAC", + "contact_name": "Mike Torres", + "email": "mike@comfortzonehvac.com", + "phone": "214-555-0142", + "website": "comfortzonehvac.com", + "pain_points": ["manual scheduling", "missed follow-ups", "no online booking"], + "matched_solution": "ai-scheduling-bundle", + "outreach_email": { + "subject": "Quick question about your scheduling, Mike", + "body": "..." + }, + "research_summary": "15-person operation, 4.2 Google rating, heavy residential focus..." + } + ], + "pipeline_metadata": { + "agents_used": 6, + "businesses_scanned": 47, + "leads_qualified": 10, + "processing_time_seconds": 38 + } +} +``` + +### Research Business +- **Method:** POST +- **Path:** /api/pipeline/research-business +- **Price:** $0.50 per call +- **Description:** Deep AI research on a single business. Returns company profile, tech stack signals, pain points, competitive landscape, and decision-maker contacts. + +**Request:** +```json +{ + "business_name": "Comfort Zone HVAC", + "location": "Dallas, TX", + "website": "comfortzonehvac.com" +} +``` + +**Response:** +```json +{ + "profile": { + "name": "Comfort Zone HVAC", + "industry": "HVAC", + "estimated_revenue": "$2M-5M", + "employee_count": "10-20", + "years_in_business": 12, + "google_rating": 4.2, + "review_count": 187 + }, + "tech_signals": ["no online booking", "basic WordPress site", "no CRM detected"], + "pain_points": ["manual scheduling", "missed follow-ups", "no review automation"], + "competitors": ["ABC Cooling", "North Texas Air"], + "contacts": [ + {"name": "Mike Torres", "role": "Owner", "email": "mike@comfortzonehvac.com"} + ] +} +``` + +### Write Outreach +- **Method:** POST +- **Path:** /api/pipeline/write-outreach +- **Price:** $0.25 per call +- **Description:** Generate a personalized cold email for a specific business based on research data. Returns subject line, body, and follow-up sequence. + +**Request:** +```json +{ + "business_name": "Comfort Zone HVAC", + "contact_name": "Mike Torres", + "pain_points": ["manual scheduling", "missed follow-ups"], + "solution": "ai-scheduling-bundle", + "tone": "casual-professional" +} +``` + +**Response:** +```json +{ + "email": { + "subject": "Quick question about your scheduling, Mike", + "body": "Hi Mike,\n\nI noticed Comfort Zone HVAC is crushing it on Google reviews (4.2 stars, nice). But I also noticed you don't have online booking — which usually means your front desk is fielding a ton of calls...", + "follow_up_1": { "delay_days": 3, "subject": "...", "body": "..." }, + "follow_up_2": { "delay_days": 7, "subject": "...", "body": "..." } + }, + "personalization_score": 0.92 +} +``` + +### Browse Solutions +- **Method:** GET +- **Path:** /api/pipeline/solutions +- **Price:** Free +- **Description:** Browse available solution packages that can be matched to leads. Use this to understand what offerings the pipeline can recommend. + +**Request:** +``` +GET /api/pipeline/solutions +``` + +**Response:** +```json +{ + "solutions": [ + { + "id": "ai-scheduling-bundle", + "name": "AI Scheduling & Booking", + "monthly_price": "$497", + "description": "Automated appointment scheduling with AI phone answering", + "best_for": ["HVAC", "plumbing", "dental", "med-spa"] + }, + { + "id": "review-reputation", + "name": "Review & Reputation Engine", + "monthly_price": "$297", + "description": "Automated review requests, response generation, reputation monitoring" + } + ] +} +``` + +## Use Cases + +- An AI sales agent needs to build a prospect list for a specific vertical and geography +- An autonomous outreach system needs personalized emails that reference real business data +- A consulting agent needs to research a potential client before a call +- A marketing agent wants to identify pain points across an entire industry segment +- An agent orchestrator needs to feed qualified leads into a CRM or email sequence + +## Pricing + +| Endpoint | Price | Description | +|----------|-------|-------------| +| /api/pipeline/generate-leads | $1.00 | Full pipeline: research + qualify + outreach | +| /api/pipeline/research-business | $0.50 | Deep AI research on one business | +| /api/pipeline/write-outreach | $0.25 | Personalized cold email generation | +| /api/pipeline/solutions | Free | Browse available solution packages | diff --git a/skills/scheduling-engine/SKILL.md b/skills/scheduling-engine/SKILL.md new file mode 100644 index 000000000..13f56557f --- /dev/null +++ b/skills/scheduling-engine/SKILL.md @@ -0,0 +1,188 @@ +--- +name: scheduling-engine +description: AI-powered appointment scheduling with staff management, availability windows, and booking automation. +author: MCF Agentic +version: 1.0.0 +tags: [scheduling, appointments, booking, calendar, availability, staff-management] +pricing: x402 (USDC on Base) +gateway: https://gateway.mcfagentic.com +--- + +# Scheduling Engine + +Manage appointments, staff schedules, and availability windows programmatically. Built for AI agents that need to book meetings, manage calendars, and coordinate schedules as part of sales, service, or operations workflows. Handles timezone conversion, conflict detection, and smart slot suggestions. + +## Authentication + +All endpoints require x402 payment (USDC on Base L2). Send a request without payment to receive pricing info in the 402 response. + +## Endpoints + +### Create Appointment +- **Method:** POST +- **Path:** /api/scheduling/appointments +- **Price:** $0.05 per call +- **Description:** Book an appointment. Automatically checks for conflicts and confirms availability. + +**Request:** +```json +{ + "title": "Discovery Call - Comfort Zone HVAC", + "start_time": "2026-04-03T10:00:00-05:00", + "duration_minutes": 30, + "staff_id": "staff_cameron", + "attendees": [ + {"name": "Mike Torres", "email": "mike@comfortzonehvac.com"} + ], + "type": "discovery-call", + "notes": "Interested in AI scheduling bundle, $497/mo", + "send_confirmation": true +} +``` + +**Response:** +```json +{ + "id": "apt_6r2nw8", + "title": "Discovery Call - Comfort Zone HVAC", + "start_time": "2026-04-03T10:00:00-05:00", + "end_time": "2026-04-03T10:30:00-05:00", + "staff_id": "staff_cameron", + "status": "confirmed", + "confirmation_sent": true, + "meeting_link": "https://meet.mcfagentic.com/apt_6r2nw8" +} +``` + +### List Appointments +- **Method:** GET +- **Path:** /api/scheduling/appointments +- **Price:** $0.02 per call +- **Description:** List appointments with optional filters for date range, staff, and status. + +**Request:** +``` +GET /api/scheduling/appointments?staff_id=staff_cameron&start_date=2026-04-01&end_date=2026-04-07 +``` + +**Response:** +```json +{ + "appointments": [ + { + "id": "apt_6r2nw8", + "title": "Discovery Call - Comfort Zone HVAC", + "start_time": "2026-04-03T10:00:00-05:00", + "duration_minutes": 30, + "status": "confirmed" + } + ], + "total": 1 +} +``` + +### Manage Staff +- **Method:** POST +- **Path:** /api/scheduling/staff +- **Price:** $0.03 per call +- **Description:** Create or update staff profiles. Define who can be booked and their default settings. + +**Request:** +```json +{ + "name": "Cameron Fagan", + "email": "cameron@mcfagentic.com", + "timezone": "America/Chicago", + "default_meeting_duration": 30, + "booking_buffer_minutes": 15, + "max_daily_meetings": 8 +} +``` + +**Response:** +```json +{ + "id": "staff_cameron", + "name": "Cameron Fagan", + "timezone": "America/Chicago", + "status": "active" +} +``` + +### Check Availability +- **Method:** GET +- **Path:** /api/scheduling/availability-windows +- **Price:** $0.02 per call +- **Description:** Get available time slots for a staff member within a date range. Returns bookable windows accounting for existing appointments and buffer times. + +**Request:** +``` +GET /api/scheduling/availability-windows?staff_id=staff_cameron&date=2026-04-03&duration=30 +``` + +**Response:** +```json +{ + "staff_id": "staff_cameron", + "date": "2026-04-03", + "timezone": "America/Chicago", + "available_slots": [ + {"start": "09:00", "end": "09:30"}, + {"start": "10:30", "end": "11:00"}, + {"start": "11:00", "end": "11:30"}, + {"start": "13:00", "end": "13:30"}, + {"start": "14:00", "end": "14:30"}, + {"start": "15:00", "end": "15:30"} + ] +} +``` + +### Set Availability Windows +- **Method:** POST +- **Path:** /api/scheduling/availability-windows +- **Price:** $0.03 per call +- **Description:** Define recurring availability windows for a staff member. Set working hours, blocked times, and day-off overrides. + +**Request:** +```json +{ + "staff_id": "staff_cameron", + "recurring": [ + {"day": "monday", "start": "09:00", "end": "17:00"}, + {"day": "tuesday", "start": "09:00", "end": "17:00"}, + {"day": "wednesday", "start": "09:00", "end": "17:00"}, + {"day": "thursday", "start": "09:00", "end": "17:00"}, + {"day": "friday", "start": "09:00", "end": "12:00"} + ], + "blocked": [ + {"date": "2026-04-04", "reason": "Company holiday"} + ] +} +``` + +**Response:** +```json +{ + "staff_id": "staff_cameron", + "availability_updated": true, + "next_available": "2026-04-03T09:00:00-05:00" +} +``` + +## Use Cases + +- A sales agent books a discovery call after a lead expresses interest via email +- An AI receptionist checks availability and schedules appointments from inbound requests +- A service agent coordinates technician schedules for work order fulfillment +- An orchestrator agent manages a consultant's calendar across multiple client engagements +- A follow-up agent reschedules missed appointments automatically + +## Pricing + +| Endpoint | Price | Description | +|----------|-------|-------------| +| /api/scheduling/appointments (POST) | $0.05 | Create an appointment | +| /api/scheduling/appointments (GET) | $0.02 | List appointments | +| /api/scheduling/staff | $0.03 | Create/update staff profiles | +| /api/scheduling/availability-windows (GET) | $0.02 | Check available slots | +| /api/scheduling/availability-windows (POST) | $0.03 | Set availability rules |