# Hexomatic MCP

> Hexomatic brings web scraping and no-code automation into your AI agent. Manage complex data extraction and workflow runs entirely through natural conversation. You can list active workflows, trigger manual executions by passing variables like target URLs, retrieve detailed configuration settings for any process, and access comprehensive logs to troubleshoot failures. It lets you treat your agent like a dedicated Data Scraping Specialist.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** no-code, workflow-automation, lead-generation, market-research, data-extraction, automation-logs

## Description

Using this MCP means you’re giving your AI client full control over web scraping and automation workflows. Instead of navigating complex dashboards or writing code every time you need data, you just talk to your agent about what you need done. Your agent acts as the conductor for all your automated processes. Need to find a competitor's tech stack? Just ask. Want to run a lead-generation workflow on a list of URLs? Tell it to do it. The power comes from the ability to manage everything, from listing available recipes and checking current usage credits to manually triggering runs and pulling back detailed logs for review. By connecting this Hexomatic MCP through Vinkius, you instantly transform your AI client into a powerful, hands-on automation architect that handles all the messy details of data collection.

## Tools

### get_workflow_results
Pulls the final structured output data from a workflow once it has completed its tasks.

### get_execution_logs
Retrieves the complete step-by-step log file for a specific workflow run, useful for debugging.

### get_account_usage
Shows your current plan details and how many automation credits you have left.

### get_workflow_details
Gets the full, specific setup configuration for any single workflow ID.

### list_automations
Shows a list of all pre-built Hexomatic automations, like Tech Stack Discovery.

### list_scraping_recipes
Lists every available point-and-click web scraping template you can use immediately.

### list_account_teams
Displays the names of all teams and collaborators connected to your account.

### list_workflows
Lists every defined automation workflow in your Hexomatic account, helping you find the ID for running it.

### run_workflow
Manually starts an execution of a chosen workflow using input variables like URLs.

### search_workflows
Finds specific workflows by searching their name or title.

### update_workflow_status
Changes whether a workflow is active (on) or inactive (off).

## Prompt Examples

**Prompt:** 
```
List all active automation workflows.
```

**Response:** 
```
I've retrieved your workflows. You have 4 active automations: 'Competitor Pricing Scraper', 'Tech Stack Discovery', 'LinkedIn Lead Finder', and 'Product News Tracker'. Which one would you like to run or inspect?
```

**Prompt:** 
```
Show me the results from the latest 'Tech Stack Discovery' run.
```

**Response:** 
```
Accessing workflow results... The latest run for 'Tech Stack Discovery' (ID: hex_992) found that 'example.com' uses AWS, React, and Intercom. 'target-app.io' uses Google Cloud and Vue.js. Should I export these results to a summary for you?
```

**Prompt:** 
```
Run workflow ID 'hex_5501' with the target URL 'https://vinkius.com'.
```

**Response:** 
```
Workflow triggered! I've successfully started the execution of workflow hex_5501 with the provided URL. You can check the progress using the `get_execution_logs` tool in a few minutes.
```

## Capabilities

### Manage workflow processes
You can list available automated workflows and view their specific configuration settings.

### Run automations on demand
Manually kick off a workflow execution from the chat, supplying necessary data like target URLs as variables.

### View scraping recipes
List all point-and-click web scraping blueprints and retrieve the structured output data after an execution finishes.

### Audit process failures
Access detailed, step-by-step logs for any workflow run to find exactly where things broke.

### Check account limits
Instantly check your current automation credit usage and plan status without logging into a portal.

## Use Cases

### Tracking Competitor Moves
A product researcher needs to know what tech a rival used six months ago. Instead of manually checking old reports, they prompt their agent: 'Show me the results from running the Tech Stack Discovery workflow on that site.' The agent runs `run_workflow` and immediately returns enriched data.

### Validating Lead Lists
A growth marketer collects a list of URLs. They ask their agent to 'Run the LinkedIn Lead Finder workflow using this JSON array.' The agent executes the task, and they use `get_workflow_results` to pull back clean, structured data ready for CRM import.

### Debugging Data Failures
The data analyst runs a complex pricing scraper but gets bad numbers. They prompt: 'Check the logs for the last run.' The agent uses `get_execution_logs` to pinpoint whether the failure was due to an expired API key or a website layout change.

### Quickly Assessing Workflow Options
A new team member needs to know what's possible. They ask their agent, 'What automations do we have?' The agent uses `list_automations` and presents the options instantly, guiding them toward the correct workflow ID.

## Benefits

- Stop switching between dashboards. Your agent handles listing workflows, getting their details, and running them all without you needing to copy an ID or navigate a menu.
- Troubleshoot instantly by using the `get_execution_logs` tool. Instead of wading through vague error messages in a web UI, your agent gives you the specific log output needed.
- Save time on data collection by using built-in automation like Tech Stack Discovery. Just prompt for it, and your agent handles the full lifecycle: run, retrieve results (`get_workflow_results`), and summarize the findings.
- Manage resources without hassle. Use `get_account_usage` to check credits before running a major job, preventing unexpected billing issues.
- It treats you like an expert operator. You don't just get data; your agent acts as a specialist that knows exactly which automation (`list_automations`) or recipe (`list_scraping_recipes`) to apply.

## How It Works

The bottom line is that you manage complex, multi-step web scraping tasks using plain language prompts instead of clicking through multiple dashboards.

1. Subscribe to this MCP and provide your Hexomatic API Key within Vinkius.
2. Your AI client recognizes the connection, making all automation tools available for natural conversation.
3. You simply prompt your agent: 'Run the Tech Stack Discovery workflow on example.com,' and it executes the task.

## Frequently Asked Questions

**How do I check if my Hexomatic credits are running low using the Hexomatic MCP?**
You use `get_account_usage`. This tool quickly retrieves your current plan details and how many automation credits you have left, so you can avoid unexpected service interruptions.

**I need to run a workflow but don't know its ID. Which tool should I use?**
First, use `list_workflows` or `search_workflows`. These tools list all available automations so you can find the exact name or ID required before calling `run_workflow`.

**What is the difference between running a workflow and getting its results?**
Running the workflow starts the process. After it finishes, you use `get_workflow_results` to pull back the final, clean output data. You can't do both with one tool.

**Can I view old runs and see where they failed?**
Yes. If a workflow fails or you need an audit trail, use `get_execution_logs`. This provides detailed step-by-step logs for that specific run ID.

**Does the Hexomatic MCP support Tech Stack Discovery? **
Yes. You can find this built-in automation by listing all automations using `list_automations` and then running it via `run_workflow`.