Integrations
MCP Server

MCP Server

The Evomi MCP Server provides a Model Context Protocol (MCP) server for the Evomi web scraping API. This allows AI assistants like Claude to interact with Evomi’s powerful web scraping capabilities directly.

Installation

Install the package from PyPI:

pip install evomi-mcp

Configuration

Set your Evomi API key as an environment variable:

export EVOMI_API_KEY="your-api-key"

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "evomi": {
      "command": "evomi-mcp",
      "env": {
        "EVOMI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if installed from source:

{
  "mcpServers": {
    "evomi": {
      "command": "python",
      "args": ["-m", "evomi_mcp.server"],
      "env": {
        "EVOMI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools (26 Total)

Scraping Operations (7 tools)

Tool Description
scrape_url Scrape a single URL with configurable options
crawl_website Crawl a website to discover and scrape multiple pages
map_website Discover URLs from a website
search_domains Find domains by searching the web
agent_request AI-powered conversational scraping assistant
get_task_status Check the status of an async task
get_account_info Get account information including credit balance

Config Management (6 tools)

Tool Description
list_configs List all saved scrape configurations
create_config Create a new scrape configuration
get_config Get a saved scrape configuration by ID
update_config Update an existing scrape configuration
delete_config Delete a scrape configuration
generate_config Generate a scrape config from natural language using AI

Schema Management (6 tools)

Tool Description
list_schemas List all saved extraction schemas
create_schema Create a new extraction schema
get_schema Get a saved extraction schema by ID
update_schema Update an existing extraction schema
delete_schema Delete an extraction schema
get_schema_status Get the test status of an extraction schema

Storage Management (4 tools)

Tool Description
list_storage_configs List all storage configurations
create_storage_config Create a new storage configuration
update_storage_config Update an existing storage configuration
delete_storage_config Delete a storage configuration

Schedule Management (7 tools)

Tool Description
list_schedules List all scheduled scrape jobs
create_schedule Create a new scheduled scrape job
get_schedule Get a scheduled job by ID
update_schedule Update an existing scheduled job
delete_schedule Delete a scheduled job
toggle_schedule Toggle a scheduled job active/inactive
list_schedule_runs Get execution history for a scheduled job

Tool Examples

Scraping 

// Basic scrape
{"url": "https://example.com"}

// AI extraction
{"url": "https://example.com/products", "ai_enhance": true, "ai_prompt": "Extract product names and prices"}

// Browser mode with actions
{"url": "https://example.com", "mode": "browser", "js_instructions": [{"click": ".accept-cookies"}, {"wait": 1000}]}

Crawling 

// Basic crawl
{"domain": "example.com", "max_urls": 50}

// With URL filter
{"domain": "example.com", "url_pattern": "/products/", "depth": 3}

Domain Search 

// Search for domains
{"query": "best e-commerce sites in Germany", "max_urls": 20, "region": "de-de"}

// Multiple queries
{"query": ["online bookstores", "book shops UK"], "max_urls": 50}

Config Management 

// Create config
{"name": "Product Scraper", "config": {"mode": "browser", "output": "markdown"}}

// Generate config with AI
{"name": "Amazon Scraper", "prompt": "Scrape product title, price, and reviews from Amazon"}

Scheduling 

// Create daily schedule
{"name": "Daily Prices", "config_id": "cfg_abc123", "interval_minutes": 1440, "start_time": "09:00"}

Running the Server Directly 

evomi-mcp
# or
python -m evomi_mcp.server

Pricing & Credits

All operations consume credits based on:

Operation Cost
Base cost 1 credit per request
Browser mode 5x multiplier
Residential proxy 2x multiplier
AI enhancement +30 credits
Screenshot/PDF +1 credit each

Credit information is returned in each response.

Resources

Resource Link
PyPI Package pypi.org/project/evomi-mcp
Evomi Website evomi.com
Evomi Dashboard dashboard.evomi.com
API Documentation docs.evomi.com
MCP Specification modelcontextprotocol.io

Benefits

  • Native AI Integration — Use Evomi directly within Claude and other MCP-compatible AI assistants
  • 26 Tools Available — Full access to scraping, config, schema, storage, and schedule management
  • Natural Language Interface — Describe what you want in plain language
  • No Code Required — Let the AI handle all the technical details
Python Client