Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Tavily MCP connector

OAuth 2.1/DCR SearchAIDeveloper Tools

Connect to Tavily MCP. Search the web, crawl websites, extract content, map site structure, and run deep research using Tavily's AI-powered search API.

Tavily MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'tavilymcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Tavily MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'tavilymcp_tavily_search',
      toolInput: { query: 'YOUR_QUERY' },
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Search tavily — Search the web for current information and return snippets with source URLs
  • Research tavily — Run comprehensive multi-source research on a topic or question
  • Map tavily — Map a website’s URL structure starting from a base URL
  • Extract tavily — Extract raw content from one or more URLs in markdown or plain text format
  • Crawl tavily — Crawl a website from a starting URL and extract page content with configurable depth and breadth

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

tavilymcp_tavily_crawl # Crawl a website from a starting URL and extract page content with configurable depth and breadth. 11 params

Crawl a website from a starting URL and extract page content with configurable depth and breadth.

Name Type Required Description
url string required The root URL to begin the crawl
allow_external boolean optional Whether to return external links in the final response
extract_depth string optional Advanced extraction retrieves more data, including tables and embedded content, with higher success but may increase latency
format string optional The format of the extracted web page content. markdown returns content in markdown format. text returns plain text and may increase latency.
include_favicon boolean optional Whether to include the favicon URL for each result
instructions string optional Natural language instructions for the crawler. Instructions specify which types of pages the crawler should return.
limit integer optional Total number of links the crawler will process before stopping
max_breadth integer optional Max number of links to follow per level of the tree (i.e., per page)
max_depth integer optional Max depth of the crawl. Defines how far from the base URL the crawler can explore.
select_domains array optional Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\.example\.com$)
select_paths array optional Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*)
tavilymcp_tavily_extract # Extract raw content from one or more URLs in markdown or plain text format. 6 params

Extract raw content from one or more URLs in markdown or plain text format.

Name Type Required Description
urls array required List of URLs to extract content from
extract_depth string optional Use 'advanced' for LinkedIn, protected sites, or tables/embedded content
format string optional Output format
include_favicon boolean optional Include favicon URLs
include_images boolean optional Include images from pages
query string optional Query to rerank content chunks by relevance
tavilymcp_tavily_map # Map a website's URL structure starting from a base URL. 8 params

Map a website's URL structure starting from a base URL.

Name Type Required Description
url string required The root URL to begin the mapping
allow_external boolean optional Whether to return external links in the final response
instructions string optional Natural language instructions for the crawler
limit integer optional Total number of links the crawler will process before stopping
max_breadth integer optional Max number of links to follow per level of the tree (i.e., per page)
max_depth integer optional Max depth of the mapping. Defines how far from the base URL the crawler can explore
select_domains array optional Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\.example\.com$)
select_paths array optional Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*)
tavilymcp_tavily_research # Run comprehensive multi-source research on a topic or question. 2 params

Run comprehensive multi-source research on a topic or question.

Name Type Required Description
input string required A comprehensive description of the research task
model string optional Defines the degree of depth of the research. 'mini' is good for narrow tasks with few subtopics. 'pro' is good for broad tasks with many subtopics