@striderlabs/mcp-thumbtack 1.0.0

package/dist/tools/request-quote.js

@@ -0,0 +1,234 @@
+import { getBrowserManager } from "../browser.js";
+import { loadSession, saveSession } from "../session.js";
+export async function requestQuote(params) {
+    const manager = getBrowserManager();
+    await manager.init();
+    const page = await manager.getPage();
+    const context = manager.getContext();
+    const sessionLoaded = await loadSession(page, context);
+    // Navigate to provider profile
+    const providerUrl = `https://www.thumbtack.com/pro/${params.provider_id}`;
+    await page.goto(providerUrl, {
+        waitUntil: "domcontentloaded",
+        timeout: 30000,
+    });
+    await page.waitForTimeout(2000);
+    // Check for auth wall
+    const requiresLogin = await page.evaluate(() => {
+        const loginModal = document.querySelector('[data-test="login-modal"], [class*="AuthModal"], [class*="LoginWall"]');
+        const loginPage = window.location.href.includes("/login") ||
+            window.location.href.includes("/signup");
+        return !!loginModal || loginPage;
+    });
+    if (requiresLogin && !sessionLoaded) {
+        return {
+            success: false,
+            message: "Authentication required. Please log in to Thumbtack first. Visit https://www.thumbtack.com/login to sign in, then try again.",
+            quoteId: null,
+            providerName: null,
+            estimatedResponseTime: null,
+            requiresLogin: true,
+        };
+    }
+    // Get provider name for confirmation
+    const providerName = await page.evaluate(() => {
+        return document.querySelector("h1")?.textContent?.trim() || null;
+    });
+    // Find and click the "Get a quote" or "Contact" button
+    try {
+        const quoteButtonSelectors = [
+            'button[data-test="contact-button"]',
+            'button[data-test="get-quote-button"]',
+            'a[data-test="contact-cta"]',
+            'button:has-text("Get a quote")',
+            'button:has-text("Contact")',
+            'button:has-text("Request quote")',
+            '[class*="ContactButton"]',
+            '[class*="QuoteButton"]',
+        ];
+        let clicked = false;
+        for (const selector of quoteButtonSelectors) {
+            try {
+                const btn = await page.$(selector);
+                if (btn) {
+                    await btn.click();
+                    clicked = true;
+                    break;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        if (!clicked) {
+            // Try text-based approach
+            await page.locator('button', { hasText: /get a quote|contact|request/i }).first().click();
+        }
+        await page.waitForTimeout(2000);
+    }
+    catch {
+        return {
+            success: false,
+            message: "Could not find the quote request button on this provider's page. The page structure may have changed.",
+            quoteId: null,
+            providerName,
+            estimatedResponseTime: null,
+            requiresLogin: false,
+        };
+    }
+    // Fill out the quote request form
+    try {
+        // Wait for form to appear
+        await page.waitForSelector('textarea, input[type="text"], [class*="QuoteForm"]', { timeout: 5000 });
+        // Fill description/project details
+        const descriptionSelectors = [
+            'textarea[data-test="description"]',
+            'textarea[name="description"]',
+            'textarea[placeholder*="describe"]',
+            'textarea[placeholder*="project"]',
+            "textarea",
+        ];
+        for (const selector of descriptionSelectors) {
+            try {
+                const textarea = await page.$(selector);
+                if (textarea) {
+                    await textarea.click();
+                    await textarea.fill(params.description);
+                    break;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        // Fill location if there's a location field
+        const locationSelectors = [
+            'input[placeholder*="ZIP"]',
+            'input[placeholder*="zip"]',
+            'input[name="zipCode"]',
+            'input[data-test="location"]',
+        ];
+        for (const selector of locationSelectors) {
+            try {
+                const input = await page.$(selector);
+                if (input) {
+                    await input.click({ clickCount: 3 });
+                    await input.fill(params.location);
+                    break;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        // Fill contact info if fields are available
+        if (params.contact_info.name) {
+            try {
+                const nameInput = await page.$('input[name="name"], input[placeholder*="name"]');
+                if (nameInput) {
+                    await nameInput.fill(params.contact_info.name);
+                }
+            }
+            catch { }
+        }
+        if (params.contact_info.email) {
+            try {
+                const emailInput = await page.$('input[type="email"], input[name="email"]');
+                if (emailInput) {
+                    await emailInput.fill(params.contact_info.email);
+                }
+            }
+            catch { }
+        }
+        if (params.contact_info.phone) {
+            try {
+                const phoneInput = await page.$('input[type="tel"], input[name="phone"]');
+                if (phoneInput) {
+                    await phoneInput.fill(params.contact_info.phone);
+                }
+            }
+            catch { }
+        }
+        // Look for submit button
+        const submitSelectors = [
+            'button[type="submit"]',
+            'button[data-test="submit-quote"]',
+            'button:has-text("Send request")',
+            'button:has-text("Submit")',
+            'button:has-text("Send")',
+        ];
+        let submitted = false;
+        for (const selector of submitSelectors) {
+            try {
+                const btn = await page.$(selector);
+                if (btn) {
+                    await btn.click();
+                    submitted = true;
+                    break;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        if (!submitted) {
+            return {
+                success: false,
+                message: "Form was filled but could not find submit button. The form may require additional steps.",
+                quoteId: null,
+                providerName,
+                estimatedResponseTime: null,
+                requiresLogin: false,
+            };
+        }
+        // Wait for confirmation
+        await page.waitForTimeout(3000);
+        // Check for success confirmation
+        const confirmationResult = await page.evaluate(() => {
+            const successEl = document.querySelector('[data-test="quote-sent"], [class*="SuccessMessage"], [class*="Confirmation"]');
+            const successText = document.body.textContent || "";
+            const isSuccess = !!successEl ||
+                successText.includes("request sent") ||
+                successText.includes("quote sent") ||
+                successText.includes("message sent") ||
+                successText.toLowerCase().includes("we'll notify");
+            const quoteIdEl = document.querySelector("[data-quote-id]");
+            const quoteId = quoteIdEl?.getAttribute("data-quote-id") || null;
+            const responseTimeEl = document.querySelector('[class*="ResponseTime"], [data-test="response-time"]');
+            const responseTime = responseTimeEl?.textContent?.trim() || null;
+            return { isSuccess, quoteId, responseTime };
+        });
+        await saveSession(page, context).catch(() => { });
+        if (confirmationResult.isSuccess) {
+            return {
+                success: true,
+                message: `Quote request successfully sent to ${providerName || "provider"}. They will be notified and should respond soon.`,
+                quoteId: confirmationResult.quoteId,
+                providerName,
+                estimatedResponseTime: confirmationResult.responseTime,
+                requiresLogin: false,
+            };
+        }
+        else {
+            return {
+                success: false,
+                message: "Quote request may have been submitted but confirmation could not be verified. Check your Thumbtack inbox.",
+                quoteId: null,
+                providerName,
+                estimatedResponseTime: null,
+                requiresLogin: false,
+            };
+        }
+    }
+    catch (error) {
+        const err = error;
+        return {
+            success: false,
+            message: `Error during quote request process: ${err.message}`,
+            quoteId: null,
+            providerName,
+            estimatedResponseTime: null,
+            requiresLogin: false,
+        };
+    }
+}

package/dist/tools/search-services.d.ts

@@ -0,0 +1,28 @@
+export interface SearchServicesParams {
+    service_type: string;
+    location?: string;
+    zip_code?: string;
+    date?: string;
+    num_people?: number;
+}
+export interface ServiceProvider {
+    id: string;
+    name: string;
+    url: string;
+    rating: number | null;
+    reviewCount: number | null;
+    description: string;
+    priceRange: string | null;
+    verified: boolean;
+    responseTime: string | null;
+    hireCount: number | null;
+    location: string | null;
+    profileImageUrl: string | null;
+}
+export interface SearchResult {
+    query: string;
+    location: string;
+    providers: ServiceProvider[];
+    totalFound: number;
+}
+export declare function searchServices(params: SearchServicesParams): Promise<SearchResult>;

package/dist/tools/search-services.js

@@ -0,0 +1,152 @@
+import { getBrowserManager } from "../browser.js";
+import { loadSession, saveSession } from "../session.js";
+export async function searchServices(params) {
+    const manager = getBrowserManager();
+    await manager.init();
+    const page = await manager.getPage();
+    const context = manager.getContext();
+    // Try to load existing session
+    const sessionLoaded = await loadSession(page, context);
+    // Build search URL
+    const locationQuery = params.zip_code || params.location || "";
+    const encodedService = encodeURIComponent(params.service_type);
+    const encodedLocation = encodeURIComponent(locationQuery);
+    // Navigate to Thumbtack search
+    const searchUrl = `https://www.thumbtack.com/search/${encodedService}/cost`;
+    await page.goto(searchUrl, { waitUntil: "domcontentloaded", timeout: 30000 });
+    // Wait for page to load and check if we need to fill in location
+    await page.waitForTimeout(2000);
+    // Handle location input if present
+    try {
+        const locationInput = await page.$('input[placeholder*="ZIP"], input[placeholder*="zip"], input[name="zipCode"], input[data-test="location-input"]');
+        if (locationInput && locationQuery) {
+            await locationInput.click({ clickCount: 3 });
+            await locationInput.fill(locationQuery);
+            await page.keyboard.press("Enter");
+            await page.waitForTimeout(2000);
+        }
+    }
+    catch {
+        // Location input may not be present on all search pages
+    }
+    // Also try the main search form approach
+    try {
+        const serviceInput = await page.$('input[placeholder*="service"], input[name="service"], input[data-test="service-input"]');
+        if (serviceInput) {
+            await serviceInput.click({ clickCount: 3 });
+            await serviceInput.fill(params.service_type);
+        }
+        const zipInput = await page.$('input[placeholder*="ZIP"], input[placeholder*="zip code"], input[name="zipCode"]');
+        if (zipInput && locationQuery) {
+            await zipInput.click({ clickCount: 3 });
+            await zipInput.fill(locationQuery);
+        }
+        const searchBtn = await page.$('button[type="submit"], button[data-test="search-button"]');
+        if (searchBtn && serviceInput) {
+            await searchBtn.click();
+            await page.waitForTimeout(3000);
+        }
+    }
+    catch {
+        // Search form approach failed, continue with what we have
+    }
+    // Wait for results to load
+    await page.waitForTimeout(3000);
+    // Extract provider data from the page
+    const providers = await page.evaluate(() => {
+        const results = [];
+        // Look for provider cards - Thumbtack uses various selectors
+        const cardSelectors = [
+            '[data-test="provider-card"]',
+            '[class*="ProviderCard"]',
+            '[class*="provider-card"]',
+            "article[class*='Card']",
+            '[data-testid="pro-card"]',
+            ".Grid__Item",
+        ];
+        let cards = [];
+        for (const selector of cardSelectors) {
+            const found = document.querySelectorAll(selector);
+            if (found.length > 0) {
+                cards = found;
+                break;
+            }
+        }
+        cards.forEach((card) => {
+            try {
+                // Extract name
+                const nameEl = card.querySelector('h3, h2, [data-test="pro-name"], [class*="name"], a[href*="/ca/"]');
+                const name = nameEl?.textContent?.trim() || "";
+                // Extract URL
+                const linkEl = card.querySelector('a[href*="/ca/"], a[href*="/pro/"]');
+                const url = linkEl?.href || "";
+                // Extract ID from URL
+                const idMatch = url.match(/\/(\d+)\/?$/);
+                const id = idMatch ? idMatch[1] : Math.random().toString(36).substr(2, 9);
+                // Extract rating
+                const ratingEl = card.querySelector('[class*="rating"], [aria-label*="star"], [data-test="rating"]');
+                const ratingText = ratingEl?.getAttribute("aria-label") || ratingEl?.textContent || "";
+                const ratingMatch = ratingText.match(/(\d+\.?\d*)/);
+                const rating = ratingMatch ? parseFloat(ratingMatch[1]) : null;
+                // Extract review count
+                const reviewEl = card.querySelector('[class*="review"], [data-test="review-count"]');
+                const reviewText = reviewEl?.textContent || "";
+                const reviewMatch = reviewText.match(/(\d+)/);
+                const reviewCount = reviewMatch ? parseInt(reviewMatch[1]) : null;
+                // Extract description/summary
+                const descEl = card.querySelector('[class*="description"], [class*="summary"], p');
+                const description = descEl?.textContent?.trim() || "";
+                // Extract price range
+                const priceEl = card.querySelector('[class*="price"], [data-test="price-range"]');
+                const priceRange = priceEl?.textContent?.trim() || null;
+                // Check verified badge
+                const verifiedEl = card.querySelector('[class*="verified"], [data-test="verified-badge"], [aria-label*="verified"]');
+                const verified = !!verifiedEl;
+                // Extract response time
+                const responseEl = card.querySelector('[class*="response"], [data-test="response-time"]');
+                const responseTime = responseEl?.textContent?.trim() || null;
+                // Extract hire count
+                const hireEl = card.querySelector('[class*="hire"], [data-test="hire-count"]');
+                const hireText = hireEl?.textContent || "";
+                const hireMatch = hireText.match(/(\d+)/);
+                const hireCount = hireMatch ? parseInt(hireMatch[1]) : null;
+                // Extract location
+                const locationEl = card.querySelector('[class*="location"], [data-test="location"]');
+                const location = locationEl?.textContent?.trim() || null;
+                // Extract profile image
+                const imgEl = card.querySelector("img");
+                const profileImageUrl = imgEl?.src || null;
+                if (name || url) {
+                    results.push({
+                        id,
+                        name,
+                        url,
+                        rating,
+                        reviewCount,
+                        description,
+                        priceRange,
+                        verified,
+                        responseTime,
+                        hireCount,
+                        location,
+                        profileImageUrl,
+                    });
+                }
+            }
+            catch {
+                // Skip malformed cards
+            }
+        });
+        return results;
+    });
+    // Save session after successful navigation
+    if (sessionLoaded || providers.length > 0) {
+        await saveSession(page, context).catch(() => { });
+    }
+    return {
+        query: params.service_type,
+        location: locationQuery,
+        providers: providers.slice(0, 20), // Limit to top 20 results
+        totalFound: providers.length,
+    };
+}

package/dist/tools/view-quotes.d.ts

@@ -0,0 +1,25 @@
+export interface ViewQuotesParams {
+    status?: "pending" | "active" | "completed" | "archived" | "all";
+}
+export interface Quote {
+    id: string;
+    providerName: string;
+    providerUrl: string | null;
+    serviceType: string;
+    status: string;
+    price: string | null;
+    message: string | null;
+    date: string | null;
+    expiresAt: string | null;
+    providerRating: number | null;
+    providerReviewCount: number | null;
+    providerImageUrl: string | null;
+    unread: boolean;
+}
+export interface ViewQuotesResult {
+    quotes: Quote[];
+    totalCount: number;
+    requiresLogin: boolean;
+    message: string;
+}
+export declare function viewQuotes(params: ViewQuotesParams): Promise<ViewQuotesResult>;

package/dist/tools/view-quotes.js

@@ -0,0 +1,163 @@
+import { getBrowserManager } from "../browser.js";
+import { loadSession, saveSession } from "../session.js";
+export async function viewQuotes(params) {
+    const manager = getBrowserManager();
+    await manager.init();
+    const page = await manager.getPage();
+    const context = manager.getContext();
+    const sessionLoaded = await loadSession(page, context);
+    // Navigate to inbox/quotes section
+    await page.goto("https://www.thumbtack.com/inbox", {
+        waitUntil: "domcontentloaded",
+        timeout: 30000,
+    });
+    await page.waitForTimeout(3000);
+    // Check if redirected to login
+    const currentUrl = page.url();
+    const requiresLogin = currentUrl.includes("/login") ||
+        currentUrl.includes("/signup") ||
+        (!sessionLoaded && currentUrl.includes("thumbtack.com/login"));
+    if (requiresLogin) {
+        return {
+            quotes: [],
+            totalCount: 0,
+            requiresLogin: true,
+            message: "Authentication required. Please log in to Thumbtack first. Visit https://www.thumbtack.com/login to sign in.",
+        };
+    }
+    // Apply status filter if provided
+    if (params.status && params.status !== "all") {
+        const filterMap = {
+            pending: "pending",
+            active: "active",
+            completed: "completed",
+            archived: "archived",
+        };
+        const filterValue = filterMap[params.status];
+        if (filterValue) {
+            try {
+                // Look for filter tabs/buttons
+                const filterSelectors = [
+                    `[data-test="filter-${filterValue}"]`,
+                    `button:has-text("${filterValue}")`,
+                    `a:has-text("${filterValue}")`,
+                    `[role="tab"]:has-text("${filterValue}")`,
+                ];
+                for (const selector of filterSelectors) {
+                    try {
+                        const btn = await page.$(selector);
+                        if (btn) {
+                            await btn.click();
+                            await page.waitForTimeout(1500);
+                            break;
+                        }
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+            }
+            catch {
+                // Filter may not be available
+            }
+        }
+    }
+    // Extract quotes from the page
+    const quotes = await page.evaluate(() => {
+        const results = [];
+        // Look for quote/message cards in the inbox
+        const cardSelectors = [
+            '[data-test="inbox-item"]',
+            '[data-test="quote-card"]',
+            '[class*="InboxItem"]',
+            '[class*="QuoteCard"]',
+            '[class*="MessageThread"]',
+            '[class*="ConversationItem"]',
+        ];
+        let cards = [];
+        for (const selector of cardSelectors) {
+            const found = document.querySelectorAll(selector);
+            if (found.length > 0) {
+                cards = found;
+                break;
+            }
+        }
+        cards.forEach((card) => {
+            try {
+                // Extract provider name
+                const providerNameEl = card.querySelector('[class*="ProviderName"], [data-test="pro-name"], h3, h2');
+                const providerName = providerNameEl?.textContent?.trim() || "Unknown Provider";
+                // Extract provider URL
+                const linkEl = card.querySelector('a[href*="/ca/"], a[href*="/pro/"]');
+                const providerUrl = linkEl?.href || null;
+                // Extract quote ID from URL or data attribute
+                const idEl = card.querySelector("[data-quote-id], [data-id]");
+                const idFromData = idEl?.getAttribute("data-quote-id") || idEl?.getAttribute("data-id");
+                const idFromUrl = linkEl?.href?.match(/\/(\d+)\/?/)?.[1];
+                const id = idFromData || idFromUrl || Math.random().toString(36).substr(2, 9);
+                // Extract service type
+                const serviceTypeEl = card.querySelector('[class*="ServiceType"], [data-test="service-type"], [class*="Category"]');
+                const serviceType = serviceTypeEl?.textContent?.trim() || "Service";
+                // Extract status
+                const statusEl = card.querySelector('[class*="Status"], [data-test="status"], [class*="badge"]');
+                const status = statusEl?.textContent?.trim() || "unknown";
+                // Extract price
+                const priceEl = card.querySelector('[class*="Price"], [data-test="price"], [class*="amount"]');
+                const price = priceEl?.textContent?.trim() || null;
+                // Extract message preview
+                const messageEl = card.querySelector('[class*="Preview"], [class*="Snippet"], [data-test="message-preview"], p');
+                const message = messageEl?.textContent?.trim() || null;
+                // Extract date
+                const dateEl = card.querySelector('time, [class*="Date"], [data-test="date"]');
+                const date = dateEl?.getAttribute("datetime") || dateEl?.textContent?.trim() || null;
+                // Extract expiry
+                const expiresEl = card.querySelector('[class*="Expires"], [data-test="expires"]');
+                const expiresAt = expiresEl?.textContent?.trim() || null;
+                // Provider rating
+                const ratingEl = card.querySelector('[aria-label*="star"], [class*="Rating"]');
+                const ratingText = ratingEl?.getAttribute("aria-label") || ratingEl?.textContent || "";
+                const ratingMatch = ratingText.match(/(\d+\.?\d*)/);
+                const providerRating = ratingMatch ? parseFloat(ratingMatch[1]) : null;
+                // Provider review count
+                const reviewEl = card.querySelector('[class*="ReviewCount"]');
+                const reviewText = reviewEl?.textContent || "";
+                const reviewMatch = reviewText.match(/(\d+)/);
+                const providerReviewCount = reviewMatch ? parseInt(reviewMatch[1]) : null;
+                // Provider image
+                const imgEl = card.querySelector("img");
+                const providerImageUrl = imgEl?.src || null;
+                // Check if unread
+                const unread = card.classList.contains("unread") ||
+                    !!card.querySelector('[class*="unread"], [class*="Unread"]');
+                results.push({
+                    id,
+                    providerName,
+                    providerUrl,
+                    serviceType,
+                    status,
+                    price,
+                    message,
+                    date,
+                    expiresAt,
+                    providerRating,
+                    providerReviewCount,
+                    providerImageUrl,
+                    unread,
+                });
+            }
+            catch {
+                // Skip malformed cards
+            }
+        });
+        return results;
+    });
+    await saveSession(page, context).catch(() => { });
+    return {
+        quotes,
+        totalCount: quotes.length,
+        requiresLogin: false,
+        message: quotes.length > 0
+            ? `Found ${quotes.length} quote(s) in your inbox.`
+            : "No quotes found in your inbox for the specified filter.",
+    };
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@striderlabs/mcp-thumbtack",
+  "version": "1.0.0",
+  "description": "MCP connector for Thumbtack home services marketplace",
+  "author": "Strider Labs <hello@striderlabs.ai>",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-thumbtack": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "playwright": "^1.40.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/",
+    "server.json",
+    "README.md"
+  ]
+}

package/server.json

@@ -0,0 +1,14 @@
+{
+  "mcpName": "io.github.markswendsen-code/mcp-thumbtack",
+  "version": "1.0.0",
+  "description": "MCP connector for Thumbtack home services marketplace",
+  "author": "Strider Labs <hello@striderlabs.ai>",
+  "tools": [
+    "thumbtack_search_services",
+    "thumbtack_get_provider",
+    "thumbtack_request_quote",
+    "thumbtack_view_quotes",
+    "thumbtack_hire_provider",
+    "thumbtack_get_projects"
+  ]
+}